Socket.Shutdown(SocketShutdown) Socket.Shutdown(SocketShutdown) Socket.Shutdown(SocketShutdown) Socket.Shutdown(SocketShutdown) Method

Definición

Deshabilita los envíos y recepciones en un objeto Socket.Disables sends and receives on a Socket.

public:
 void Shutdown(System::Net::Sockets::SocketShutdown how);
public void Shutdown (System.Net.Sockets.SocketShutdown how);
member this.Shutdown : System.Net.Sockets.SocketShutdown -> unit
Public Sub Shutdown (how As SocketShutdown)

Parámetros

how
SocketShutdown SocketShutdown SocketShutdown SocketShutdown

Uno de los valores de SocketShutdown que especifica la operación que ya no estará permitida.One of the SocketShutdown values that specifies the operation that will no longer be allowed.

Excepciones

Error al intentar acceder al socket.An error occurred when attempting to access the socket.

Ejemplos

El siguiente ejemplo de código usa Shutdown para deshabilitar el Socket.The following code example uses Shutdown to disable the Socket.

aSocket->Shutdown( SocketShutdown::Both );
aSocket->Close();
if ( aSocket->Connected )
{
   Console::WriteLine( "Winsock error: {0}", Convert::ToString(
      System::Runtime::InteropServices::Marshal::GetLastWin32Error() ) );
}
aSocket.Shutdown(SocketShutdown.Both);
aSocket.Close();
    aSocket.Shutdown(SocketShutdown.Both)
    aSocket.Close()

End Sub 'SocketClose

Comentarios

Cuando se usa un orientado a conexión Socket, llame siempre a la Shutdown método antes de cerrar el Socket.When using a connection-oriented Socket, always call the Shutdown method before closing the Socket. Esto garantiza que todos los datos se envía y recibe en el socket conectado antes de cerrarse.This ensures that all data is sent and received on the connected socket before it is closed.

Llame a la Close método para liberar todos los recursos administrados y asociados con el Socket.Call the Close method to free all managed and unmanaged resources associated with the Socket. No intente reutilizar el Socket después del cierre.Do not attempt to reuse the Socket after closing.

La tabla siguiente muestra la SocketShutdown valores de enumeración que son válidos para el how parámetro.The following table shows the SocketShutdown enumeration values that are valid for the how parameter.

ValorValue DescripciónDescription
EnviarSend Deshabilite los envíos en Socket.Disable sending on this Socket.
RecibirReceive Deshabilite las recepciones en esto Socket.Disable receiving on this Socket.
AmbosBoth Deshabilitar el envío y recepción en esto Socket.Disable both sending and receiving on this Socket.

Establecer how a Send especifica que las siguientes llamadas a Send no se permiten.Setting how to Send specifies that subsequent calls to Send are not allowed. Si usa un protocolo sin conexión Socket, especificando Send no tendrá ningún efecto.If you are using a connectionless Socket, specifying Send will have no effect.

Establecer how a Receive especifica que las siguientes llamadas a Receive no se permiten.Setting how to Receive specifies that subsequent calls to Receive are not allowed. Esto no tiene ningún efecto en las capas inferiores de protocolo.This has no effect on lower protocol layers. Si utiliza un protocolo orientado a conexiones, la conexión finaliza si cualquiera de las siguientes condiciones existe después de llamar a Shutdown :If you are using a connection-oriented protocol, the connection is terminated if either of the following conditions exist after a call to Shutdown :

  • Datos están en el búfer de red entrante a la espera de recibirse.Data is in the incoming network buffer waiting to be received.

  • Ha llegado más datos.More data has arrived.

Si usa un protocolo sin conexión, los datagramas se aceptan y en cola.If you are using a connectionless protocol, datagrams are accepted and queued. Sin embargo, si no hay espacio de búfer disponible para los datagramas entrantes adicionales, se descartarán y no se devolverá ningún error al remitente.However, if no buffer space is available for additional incoming datagrams, they will be discarded and no error will be returned to the sender. Uso de Shutdown en un protocolo sin conexión Socket no se recomienda.Using Shutdown on a connectionless Socket is not recommended.

Establecer how a Both deshabilita tanto los envíos y recepciones como se describió anteriormente.Setting how to Both disables both sends and receives as described above.

Nota

Si recibe un SocketException al llamar a la Shutdown método, use el SocketException.ErrorCode propiedad para obtener el código de error específico.If you receive a SocketException when calling the Shutdown method, use the SocketException.ErrorCode property to obtain the specific error code. Después de haber obtenido este código, consulte el código de error de API de la versión 2 de Windows Sockets documentación para obtener una descripción detallada del error.After you have obtained this code, refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Nota

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación.This member outputs trace information when you enable network tracing in your application. Para obtener más información, consulte seguimiento de red en .NET Framework.For more information, see Network Tracing in the .NET Framework.

Se aplica a

Consulte también: