Socket.Ttl Propriedade

Definição

Espaço de Nomes:
System.Net.Sockets
Assemblagens:
System.dll, System.Net.Sockets.dll
Assemblagens:
netstandard.dll, System.Net.Sockets.dll
Assemblagem:
System.Net.Sockets.dll
Assemblagem:
System.dll
Assemblagem:
netstandard.dll
Origem:
Socket.cs
Origem:
Socket.cs
Origem:
Socket.cs
Origem:
Socket.cs
Origem:
Socket.cs

Recebe ou define um valor que especifica o valor Time To Live (TTL) dos pacotes de Protocolo de Internet (IP) enviados pelo Socket.

public:
 property short Ttl { short get(); void set(short value); };
public short Ttl { get; set; }
member this.Ttl : int16 with get, set
Public Property Ttl As Short

Valor de Propriedade

Int16

O valor TTL.

Exceções

ArgumentOutOfRangeException

O valor TTL é um número negativo.

NotSupportedException

O soquete não pertence às InterNetwork famílias de ou.InterNetworkV6

SocketException

Ocorreu um erro ao tentar aceder ao soquete. Este erro também é devolvido quando se tenta definir o TTL para um valor superior a 255.

ObjectDisposedException

O Socket local foi encerrado.

Exemplos

O seguinte exemplo de código demonstra a utilização da Ttl propriedade.

static void ConfigureTcpSocket(Socket tcpSocket)
{
    // Don't allow another socket to bind to this port.
    tcpSocket.ExclusiveAddressUse = true;

    // The socket will linger for 10 seconds after
    // Socket.Close is called.
    tcpSocket.LingerState = new LingerOption (true, 10);

    // Disable the Nagle Algorithm for this tcp socket.
    tcpSocket.NoDelay = true;

    // Set the receive buffer size to 8k
    tcpSocket.ReceiveBufferSize = 8192;

    // Set the timeout for synchronous receive methods to
    // 1 second (1000 milliseconds.)
    tcpSocket.ReceiveTimeout = 1000;

    // Set the send buffer size to 8k.
    tcpSocket.SendBufferSize = 8192;

    // Set the timeout for synchronous send methods
    // to 1 second (1000 milliseconds.)
    tcpSocket.SendTimeout = 1000;

    // Set the Time To Live (TTL) to 42 router hops.
    tcpSocket.Ttl = 42;

    Console.WriteLine("Tcp Socket configured:");

    Console.WriteLine($"  ExclusiveAddressUse {tcpSocket.ExclusiveAddressUse}");

    Console.WriteLine($"  LingerState {tcpSocket.LingerState.Enabled}, {tcpSocket.LingerState.LingerTime}");

    Console.WriteLine($"  NoDelay {tcpSocket.NoDelay}");

    Console.WriteLine($"  ReceiveBufferSize {tcpSocket.ReceiveBufferSize}");

    Console.WriteLine($"  ReceiveTimeout {tcpSocket.ReceiveTimeout}");

    Console.WriteLine($"  SendBufferSize {tcpSocket.SendBufferSize}");

    Console.WriteLine($"  SendTimeout {tcpSocket.SendTimeout}");

    Console.WriteLine($"  Ttl {tcpSocket.Ttl}");

    Console.WriteLine($"  IsBound {tcpSocket.IsBound}");

    Console.WriteLine("");
}

Observações

O valor TTL indica o número máximo de routers que o pacote pode atravessar antes de o router descartar o pacote e uma mensagem de erro "TTL exceeded" do Protocolo de Mensagem de Controlo da Internet (ICMP) ser devolvida ao remetente.

O valor TTL pode ser definido entre 0 e 255. Quando esta propriedade não está definida, o valor TTL predefinido para um socket é 32.

Definir esta propriedade num soquete do Protocolo de Controlo de Transmissão (TCP) é ignorado pela pilha TCP/IP se uma ligação bem-sucedida tiver sido estabelecida usando o soquete.

Se receber um SocketException, use a SocketException.ErrorCode propriedade para obter o código de erro específico. Depois de obter este código, consulte a documentação do código de erro da API Windows versão 2 dos Sockets para uma descrição detalhada do erro.

Aplica-se a