Socket.SendToAsync Método

Definición

Espacio de nombres:

System.Net.Sockets

Ensamblado:

System.Net.Sockets.dll

Sobrecargas

SendToAsync(SocketAsyncEventArgs)	Envía datos de forma asincrónica a un host remoto concreto.
SendToAsync(ArraySegment<Byte>, EndPoint)	Envía datos al host remoto especificado.
SendToAsync(ArraySegment<Byte>, SocketFlags, EndPoint)	Envía datos al host remoto especificado.
SendToAsync(ReadOnlyMemory<Byte>, EndPoint, CancellationToken)	Envía datos al host remoto especificado.
SendToAsync(ReadOnlyMemory<Byte>, SocketFlags, EndPoint, CancellationToken)	Envía datos al host remoto especificado.
SendToAsync(ReadOnlyMemory<Byte>, SocketFlags, SocketAddress, CancellationToken)	Envía datos a un extremo específico mediante el marcador SocketFlags especificado.

SendToAsync(SocketAsyncEventArgs)

Source:

Socket.cs

Envía datos de forma asincrónica a un host remoto concreto.

public:
 bool SendToAsync(System::Net::Sockets::SocketAsyncEventArgs ^ e);

public bool SendToAsync (System.Net.Sockets.SocketAsyncEventArgs e);

member this.SendToAsync : System.Net.Sockets.SocketAsyncEventArgs -> bool

Public Function SendToAsync (e As SocketAsyncEventArgs) As Boolean

Parámetros

e

SocketAsyncEventArgs

Objeto SocketAsyncEventArgs que se usa para esta operación de socket asincrónica.

Devoluciones

Boolean

Devuelve true si la operación de E/S está pendiente. Al completar la operación se provoca el evento Completed del parámetro e.

Devuelve false si la operación de E/S se ha completado de forma sincrónica. En ese caso, el evento Completed del parámetro e no se provoca y el objeto e que se pasa como parámetro puede examinarse inmediatamente después de que se devuelva la llamada al método para recuperar el resultado de la operación.

Excepciones

ArgumentNullException

RemoteEndPoint no puede ser null.

InvalidOperationException

Ya hay una operación de socket en curso que utiliza el objeto SocketAsyncEventArgs especificado en el parámetro e.

ObjectDisposedException

El Socket se ha cerrado.

SocketException

El protocolo especificado está orientado a la conexión, pero el Socket no está conectado todavía.

Comentarios

El SendToAsync método inicia una operación de envío asincrónica al host remoto especificado en la SocketAsyncEventArgs.RemoteEndPoint propiedad del e parámetro . Llamar al SendToAsync método le permite enviar datos dentro de un subproceso de ejecución independiente. Aunque este método está pensado para protocolos sin conexión, SendToAsync funciona con protocolos sin conexión y orientados a conexiones.

Para recibir una notificación de finalización, debe crear un método de devolución de llamada que implemente el delegado EventHandler<SocketAsyncEventArgs> y adjunte la devolución de llamada al SocketAsyncEventArgs.Completed evento.

Se requieren las siguientes propiedades y eventos en el System.Net.Sockets.SocketAsyncEventArgs objeto para llamar correctamente a este método:

• SocketAsyncEventArgs.Buffer

• SocketAsyncEventArgs.Count

• SocketAsyncEventArgs.Offset

• SocketAsyncEventArgs.RemoteEndPoint

• SocketAsyncEventArgs.Completed

El autor de la llamada puede establecer la SocketAsyncEventArgs.UserToken propiedad en cualquier objeto de estado de usuario deseado antes de llamar al SendToAsync método , de modo que la información se pueda recuperar en el método de devolución de llamada. Si la devolución de llamada necesita más información que un único objeto, se puede crear una clase pequeña para contener la otra información de estado necesaria como miembros.

Si usa un protocolo orientado a la conexión, primero debe llamar al Acceptmétodo , AcceptAsync, BeginAcceptBeginConnect, , Connecto ConnectAsync . De lo contrario SendToAsync , producirá una SocketExceptionexcepción . Cuando se usa un protocolo orientado a la conexión, el SendToAsync método omitirá la SocketAsyncEventArgs.RemoteEndPoint propiedad y enviará datos al System.Net.EndPoint objeto establecido en el Acceptmétodo , AcceptAsync, BeginAccept, BeginConnect, Connecto ConnectAsync .

Si usa un protocolo sin conexión, no es necesario establecer un host remoto predeterminado con el BeginConnectmétodo , Connecto ConnectAsync antes de llamar SendToAsynca . Solo tiene que hacerlo si piensa llamar a los BeginSend métodos o SendAsync . Si llama al BeginConnectmétodo , Connecto ConnectAsync antes de llamar SendToAsynca , la SocketAsyncEventArgs.RemoteEndPoint propiedad invalidará el host remoto predeterminado especificado para esa operación de envío. Tampoco es necesario llamar al Bind método . En este caso, el proveedor de servicios subyacente asignará la dirección IP de red local y el número de puerto más adecuados. Use un número de puerto de cero si desea que el proveedor de servicios subyacente seleccione un puerto libre. Si necesita identificar la dirección IP de red local asignada y el número de puerto, puede usar la LocalEndPoint propiedad después de que se señale el SocketAsyncEventArgs.Completed evento y se llame a los delegados asociados.

Si desea enviar datos a una dirección de difusión, primero debe llamar al SetSocketOption método y establecer la opción de socket para en SocketOptionName.Broadcast true. También debe asegurarse de que el tamaño del búfer no supere el tamaño máximo del paquete del proveedor de servicios subyacente. Si es así, el datagrama no se enviará y SendToAsync producirá una SocketExceptionexcepción .

Si especifica la marca DontRoute en la SocketAsyncEventArgs.SocketFlags propiedad , los datos que envía no se enrutarán.

En el caso de los sockets orientados a mensajes, se debe tener cuidado de no superar el tamaño máximo del mensaje del transporte subyacente. Si el tamaño del búfer supera el tamaño máximo del paquete del proveedor de servicios subyacente, el datagrama no se envía y SendToAsync producirá una SocketExceptionexcepción . La finalización correcta de un SendToAsync método no indica que los datos se entregaron correctamente.

Consulte también

• SocketAsyncEventArgs
• Buffer
• Completed
• Count
• Offset
• RemoteEndPoint
• UserToken

SendToAsync(ArraySegment<Byte>, EndPoint)

Source:

Socket.Tasks.cs

Envía datos al host remoto especificado.

public:
 System::Threading::Tasks::Task<int> ^ SendToAsync(ArraySegment<System::Byte> buffer, System::Net::EndPoint ^ remoteEP);

public System.Threading.Tasks.Task<int> SendToAsync (ArraySegment<byte> buffer, System.Net.EndPoint remoteEP);

member this.SendToAsync : ArraySegment<byte> * System.Net.EndPoint -> System.Threading.Tasks.Task<int>

Public Function SendToAsync (buffer As ArraySegment(Of Byte), remoteEP As EndPoint) As Task(Of Integer)

Parámetros

buffer

ArraySegment<Byte>

Búfer de los datos que se van a enviar.

remoteEP

EndPoint

Host remoto al que se van a enviar los datos.

Devoluciones

Task<Int32>

Tarea asincrónica que se completa con el número de bytes enviados.

Excepciones

ArgumentNullException

remoteEP es null.

SocketException

Error al intentar acceder al socket.

ObjectDisposedException

El Socket se ha cerrado.

SendToAsync(ArraySegment<Byte>, SocketFlags, EndPoint)

Source:

Socket.Tasks.cs

Envía datos al host remoto especificado.

public:
 System::Threading::Tasks::Task<int> ^ SendToAsync(ArraySegment<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags, System::Net::EndPoint ^ remoteEP);

public System.Threading.Tasks.Task<int> SendToAsync (ArraySegment<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, System.Net.EndPoint remoteEP);

member this.SendToAsync : ArraySegment<byte> * System.Net.Sockets.SocketFlags * System.Net.EndPoint -> System.Threading.Tasks.Task<int>

Public Function SendToAsync (buffer As ArraySegment(Of Byte), socketFlags As SocketFlags, remoteEP As EndPoint) As Task(Of Integer)

Parámetros

buffer

ArraySegment<Byte>

Búfer de los datos que se van a enviar.

socketFlags

SocketFlags

Combinación bit a bit de valores SocketFlags que se usarán al enviar los datos.

remoteEP

EndPoint

Host remoto al que se van a enviar los datos.

Devoluciones

Task<Int32>

Tarea asincrónica que se completa con el número de bytes enviados.

Excepciones

ArgumentNullException

remoteEP es null.

SocketException

Error al intentar acceder al socket.

ObjectDisposedException

El Socket se ha cerrado.

SendToAsync(ReadOnlyMemory<Byte>, EndPoint, CancellationToken)

Source:

Socket.Tasks.cs

Envía datos al host remoto especificado.

public System.Threading.Tasks.ValueTask<int> SendToAsync (ReadOnlyMemory<byte> buffer, System.Net.EndPoint remoteEP, System.Threading.CancellationToken cancellationToken = default);

member this.SendToAsync : ReadOnlyMemory<byte> * System.Net.EndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendToAsync (buffer As ReadOnlyMemory(Of Byte), remoteEP As EndPoint, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parámetros

buffer

ReadOnlyMemory<Byte>

Búfer de los datos que se van a enviar.

remoteEP

EndPoint

Host remoto al que se van a enviar los datos.

cancellationToken

CancellationToken

Token de cancelación que se puede usar para cancelar la operación asincrónica.

Devoluciones

ValueTask<Int32>

Tarea asincrónica que se completa con el número de bytes enviados.

Excepciones

ArgumentNullException

remoteEP es null.

SocketException

Error al intentar acceder al socket.

ObjectDisposedException

El Socket se ha cerrado.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

SendToAsync(ReadOnlyMemory<Byte>, SocketFlags, EndPoint, CancellationToken)

Source:

Socket.Tasks.cs

Envía datos al host remoto especificado.

public System.Threading.Tasks.ValueTask<int> SendToAsync (ReadOnlyMemory<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, System.Net.EndPoint remoteEP, System.Threading.CancellationToken cancellationToken = default);

member this.SendToAsync : ReadOnlyMemory<byte> * System.Net.Sockets.SocketFlags * System.Net.EndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendToAsync (buffer As ReadOnlyMemory(Of Byte), socketFlags As SocketFlags, remoteEP As EndPoint, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parámetros

buffer

ReadOnlyMemory<Byte>

Búfer de los datos que se van a enviar.

socketFlags

SocketFlags

Combinación bit a bit de valores SocketFlags que se usarán al enviar los datos.

remoteEP

EndPoint

Host remoto al que se van a enviar los datos.

cancellationToken

CancellationToken

Token de cancelación que se puede usar para cancelar la operación asincrónica.

Devoluciones

ValueTask<Int32>

Tarea asincrónica que se completa con el número de bytes enviados.

Excepciones

ArgumentNullException

remoteEP es null.

SocketException

Error al intentar acceder al socket.

ObjectDisposedException

El Socket se ha cerrado.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

SendToAsync(ReadOnlyMemory<Byte>, SocketFlags, SocketAddress, CancellationToken)

Source:

Socket.Tasks.cs

Envía datos a un extremo específico mediante el marcador SocketFlags especificado.

public System.Threading.Tasks.ValueTask<int> SendToAsync (ReadOnlyMemory<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, System.Net.SocketAddress socketAddress, System.Threading.CancellationToken cancellationToken = default);

member this.SendToAsync : ReadOnlyMemory<byte> * System.Net.Sockets.SocketFlags * System.Net.SocketAddress * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendToAsync (buffer As ReadOnlyMemory(Of Byte), socketFlags As SocketFlags, socketAddress As SocketAddress, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parámetros

buffer

ReadOnlyMemory<Byte>

Búfer de los datos que se van a enviar.

socketFlags

SocketFlags

Combinación bit a bit de SocketFlags valores que se usarán al enviar los datos.

socketAddress

SocketAddress

SocketAddress que representa el destino de los datos.

cancellationToken

CancellationToken

Token de cancelación que se puede usar para cancelar la operación asincrónica.

Devoluciones

ValueTask<Int32>

Tarea asincrónica que se completa con el número de bytes enviados.

Excepciones

ArgumentNullException

socketAddress es null.

SocketException

Error al intentar acceder al socket.

ObjectDisposedException

El Socket se ha cerrado.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.