SocketOptionName Enumeração
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Define os nomes das opções de configuração.
public enum class SocketOptionNamepublic enum SocketOptionNametype SocketOptionName = Public Enum SocketOptionName- Herança
Campos
| Name | Valor | Description |
|---|---|---|
| DontLinger | -129 | Fecha a cavidade com elegância, sem demorar. |
| ExclusiveAddressUse | -5 | Permite que um socket seja vinculado para acesso exclusivo. |
| Debug | 1 | Registre informações de depuração. |
| IPOptions | 1 | Especifica as opções de IP a serem inseridas nos datagramas de saída. |
| NoChecksum | 1 | Envie datagramas UDP com a soma de verificação definida a zero. |
| NoDelay | 1 | Desativa o algoritmo Nagle para enviar coalescência. |
| AcceptConnection | 2 | A tomada está a ouvir. |
| BsdUrgent | 2 | Use dados urgentes conforme definido no RFC-1222. Esta opção só pode ser definida uma vez; Depois de configurado, não pode ser desligado. |
| Expedited | 2 | Utilize dados acelerados conforme definido no RFC-1222. Esta opção só pode ser definida uma vez; Depois de configurado, não pode ser desligado. |
| HeaderIncluded | 2 | Indica que a aplicação fornece o cabeçalho IP para datagramas de saída. |
| TypeOfService | 3 | Mude o tipo de cabeçalho IP do campo de serviço. |
| IpTimeToLive | 4 | Defina o cabeçalho IP campo Time-to-Live. |
| ReuseAddress | 4 | Permite que o socket seja associado a um endereço já em uso. |
| KeepAlive | 8 | Usa manter-vivos. |
| MulticastInterface | 9 | Defina a interface para pacotes multicast de saída. |
| MulticastTimeToLive | 10 | Um multicast IP Time to Live. |
| MulticastLoopback | 11 | Um loopback multicast IP. |
| AddMembership | 12 | Adicione uma pertença a um grupo IP. |
| DropMembership | 13 | Deixa de ser membro de um grupo IP. |
| DontFragment | 14 | Não fragmente datagramas IP. |
| AddSourceMembership | 15 | Junta-te a um grupo de fontes. |
| DontRoute | 16 | Não rotar; enviar o pacote diretamente para os endereços da interface. |
| DropSourceMembership | 16 | Deixa um grupo de origem. |
| BlockSource | 17 | Bloqueie dados de uma fonte. |
| UnblockSource | 18 | Desbloqueie uma fonte previamente bloqueada. |
| PacketInformation | 19 | Informações de devolução sobre os pacotes recebidos. |
| ChecksumCoverage | 20 | Defina ou obtenha a cobertura de soma de verificação UDP. |
| HopLimit | 21 | Especifica o número máximo de saltos no router para um pacote do Protocolo de Internet versão 6 (IPv6). Isto é semelhante ao Time to Live (TTL) para a versão 4 do Protocolo Internet. |
| IPProtectionLevel | 23 | Permite a restrição de um socket IPv6 a um âmbito especificado, como endereços com o mesmo link local ou prefixo local de site. Esta opção de socket permite às aplicações impor restrições de acesso aos sockets IPv6. Tais restrições permitem que uma aplicação a correr numa LAN privada se fortaleça de forma simples e robusta contra ataques externos. Esta opção de socket alarga ou restringe o âmbito de um socket de escuta, permitindo acesso irrestrito de utilizadores públicos e privados quando apropriado, ou restringindo o acesso apenas ao mesmo local, conforme necessário. Esta opção de soquete tem níveis de proteção definidos especificados na IPProtectionLevel enumeração. |
| IPv6Only | 27 | Indica se um soquete criado para a família de endereços AF_INET6 está restrito apenas a comunicações IPv6. Os soquetes criados para a família de endereços AF_INET6 podem ser usados para comunicações IPv6 e IPv4. Alguns aplicativos podem querer restringir o uso de um soquete criado para a família de endereços AF_INET6 apenas para comunicações IPv6. Quando este valor é diferente de zero (o padrão no Windows), um socket criado para a família de endereços AF_INET6 pode ser usado apenas para enviar e receber pacotes IPv6. Quando esse valor é zero, um soquete criado para a família de endereços AF_INET6 pode ser usado para enviar e receber pacotes de e para um endereço IPv6 ou um endereço IPv4. Observe que a capacidade de interagir com um endereço IPv4 requer o uso de endereços mapeados IPv4. Esta opção de soquete é suportada no Windows Vista ou posterior. |
| Broadcast | 32 | Permitir o envio de mensagens de transmissão no soquete. |
| UseLoopback | 64 | Contornar o hardware sempre que possível. |
| Linger | 128 | Fique atento ao fechar se houver dados não enviados. |
| OutOfBandInline | 256 | Recebe dados fora de banda no fluxo de dados normal. |
| SendBuffer | 4097 | Especifica o espaço total de buffer por socket reservado para envios. Isto não está relacionado com o tamanho máximo da mensagem nem com o tamanho de uma janela TCP. |
| ReceiveBuffer | 4098 | Especifica o espaço total de buffer por soquete reservado para receções. Isto não está relacionado com o tamanho máximo da mensagem nem com o tamanho de uma janela TCP. |
| SendLowWater | 4099 | Especifica a margem mínima para Send operações. |
| ReceiveLowWater | 4100 | Especifica a margem mínima para Receive operações. |
| SendTimeout | 4101 | Envia um castigo. Esta opção aplica-se apenas a métodos síncronos; não tem efeito sobre métodos assíncronos como o BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) método. |
| ReceiveTimeout | 4102 | Recebe um castigo. Esta opção aplica-se apenas a métodos síncronos; não tem efeito sobre métodos assíncronos como o BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) método. |
| Error | 4103 | Recebe o estado do erro e limpa. |
| Type | 4104 | Recebe o tipo de soquete. |
| ReuseUnicastPort | 12295 | Indica que o sistema deve adiar a alocação efémera de portas para ligações de saída. Isto é equivalente a usar a opção de soquete SO_REUSE_UNICASTPORT Winsock2. |
| UpdateAcceptContext | 28683 | Atualiza as propriedades de um socket aceite usando as de um socket existente. Isto é equivalente a usar a opção de soquete SO_UPDATE_ACCEPT_CONTEXT Winsock2 e é suportado apenas em soquetes orientados à ligação. |
| UpdateConnectContext | 28688 | Atualiza as propriedades de uma tomada ligada utilizando as de uma tomada já existente. Isto é equivalente a usar a opção de soquete SO_UPDATE_CONNECT_CONTEXT Winsock2 e é suportado apenas em soquetes orientados à ligação. |
| MaxConnections | 2147483647 | Não suportado; Vai lançar um SocketException se for usado. |
Exemplos
O seguinte exemplo de código usa esta enumeração para definir opções de socket.
// The socket will linger for 10 seconds after Socket.Close is called.
var lingerOption = new LingerOption(true, 10);
s.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.Linger, lingerOption);
' The socket will linger for 10 seconds after Socket.Close is called.
Dim lingerOption As New LingerOption(True, 10)
s.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.Linger, lingerOption)
Observações
A SocketOptionName enumeração define o nome de cada Socket opção de configuração. Os soquetes podem ser configurados com este Socket.SetSocketOption método.