TcpClient.LingerState Propriedade

Definição

Espaço de Nomes:
System.Net.Sockets
Assemblagem:
System.dll
Assemblagem:
System.Net.Sockets.dll
Assemblagem:
netstandard.dll

Obtém ou define informação sobre o estado residual do socket associado.

public:
 property System::Net::Sockets::LingerOption ^ LingerState { System::Net::Sockets::LingerOption ^ get(); void set(System::Net::Sockets::LingerOption ^ value); };
public System.Net.Sockets.LingerOption LingerState { get; set; }
member this.LingerState : System.Net.Sockets.LingerOption with get, set
Public Property LingerState As LingerOption

Valor de Propriedade

LingerOption

Um LingerOption. Por defeito, a demora está desativada.

Exemplos

O seguinte exemplo de código define e faz com que os soquetes permaneçam o tempo.

// sets the amount of time to linger after closing, using the LingerOption public property.
LingerOption lingerOption = new LingerOption (true, 10);

tcpClient.LingerState = lingerOption;

// gets the amount of linger time set, using the LingerOption public property.
if (tcpClient.LingerState.LingerTime == 10)
    Console.WriteLine ("The linger state setting was successfully set to " + tcpClient.LingerState.LingerTime.ToString ());

' Sets the amount of time to linger after closing, using the LingerOption public property.
Dim lingerOption As New LingerOption(True, 10)
tcpClient.LingerState = lingerOption

' Gets the amount of linger time set, using the LingerOption public property.
If tcpClient.LingerState.LingerTime = 10 Then
   Console.WriteLine(("The linger state setting was successfully set to " + tcpClient.LingerState.LingerTime.ToString()))
End If

Observações

A LingerState propriedade altera a forma como Close o método se comporta. Esta propriedade, quando definida, modifica as condições sob as quais a ligação pode ser reiniciada pelo Winsock. As reinicializações de ligação ainda podem ocorrer com base no comportamento do protocolo IP.

Esta propriedade controla o tempo em que a ligação TCP permanecerá aberta após uma chamada até Close ao momento em que os dados permanecerão por enviar. Quando chama o Write método, os dados são colocados no buffer de rede de saída. Esta propriedade pode ser usada para garantir que estes dados são enviados para o host remoto antes de o Close método cortar a ligação.

Para permitir o lingering, crie uma LingerOption instância contendo os valores desejados e defina a LingerState propriedade para essa instância.

A tabela seguinte descreve o comportamento do Close método para os possíveis valores da Enabled propriedade e da LingerTime propriedade armazenada nela LingerState .

LingerState.Enabled LingerState.LingerTime Comportamento
false (desativado), o valor padrão O time-out não é aplicável (por defeito). Tentativas de enviar dados pendentes até que o tempo de expiração do protocolo IP predefinido.
true (ativado) Um time-out não nulo Tenta enviar dados pendentes até expirar o tempo especificado e, se a tentativa falhar, o Winsock reinicia a ligação.
true (ativado) Um tempo morto. Descarta quaisquer dados pendentes e o Winsock reinicia a ligação.

A pilha IP calcula o período predefinido de timeout do protocolo IP a usar com base no tempo de ida e volta da ligação. Na maioria dos casos, o time-out calculado pela pilha é mais relevante do que um definido por uma aplicação. Este é o comportamento padrão de um socket quando a LingerState propriedade não está definida.

Quando a LingerTime propriedade armazenada nessa LingerState propriedade é definida como maior do que o time-out padrão do protocolo IP, o time-out padrão do protocolo IP continuará a aplicar-se e a sobrescrever.

Aplica-se a

Ver também