Socket.EndSend Método
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Finaliza un envío asincrónico pendiente.
EndSend(IAsyncResult) |
Finaliza un envío asincrónico pendiente. |
EndSend(IAsyncResult, SocketError) |
Finaliza un envío asincrónico pendiente. |
- Source:
- Socket.cs
- Source:
- Socket.cs
- Source:
- Socket.cs
Finaliza un envío asincrónico pendiente.
public:
int EndSend(IAsyncResult ^ asyncResult);
public int EndSend (IAsyncResult asyncResult);
member this.EndSend : IAsyncResult -> int
Public Function EndSend (asyncResult As IAsyncResult) As Integer
Parámetros
- asyncResult
- IAsyncResult
IAsyncResult que almacena información de estado para esta operación asincrónica.
Devoluciones
Si se realiza con éxito, el número de bytes enviados al objeto Socket; en caso contrario, un error de Socket no válido.
Excepciones
asyncResult
es null
.
asyncResult
no se devolvió mediante una llamada al método BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object).
EndSend(IAsyncResult) fue llamado previamente para el envío asincrónico.
Solo .NET Framework, .NET Core y .NET 5-6: Socket se ha cerrado .
Comentarios
Importante
Se trata de una API de compatibilidad. No se recomienda usar los métodos de APM (Begin*
y End*
) para el nuevo desarrollo. En su lugar, use los Task
equivalentes basados en .
EndSend completa la operación iniciada por BeginSend. Debe pasar el IAsyncResult objeto creado por la llamada coincidente BeginSend .
Si usa un protocolo sin conexión, EndSend se bloqueará hasta que se envíe el datagrama. Si usa un protocolo orientado a la conexión, EndSend se bloqueará hasta que se envíe parte del búfer. Si el valor devuelto de EndSend indica que el búfer no se envió por completo, llame BeginSend al método de nuevo, modificando el búfer para contener los datos no enviados.
No hay ninguna garantía de que los datos que envíe aparecerán en la red inmediatamente. Para aumentar la eficiencia de la red, el sistema subyacente puede retrasar la transmisión hasta que se recopile una cantidad significativa de datos salientes. Una finalización correcta del BeginSend método significa que el sistema subyacente ha tenido espacio para almacenar en búfer los datos de un envío de red.
Nota
Si recibe un SocketException, use la SocketException.ErrorCode propiedad para obtener el código de error específico.
Nota
Todas las E/S iniciadas por un subproceso determinado se cancelan cuando se cierra ese subproceso. Se puede producir un error en una operación asincrónica pendiente si el subproceso sale antes de que se complete la operación.
Nota
La finalización correcta de un envío no indica que los datos se entregaron correctamente. Si no hay espacio en búfer disponible en el sistema de transporte para contener los datos que se van a transmitir, el envío se bloqueará a menos que el socket se haya colocado en modo de no bloqueo.
Nota
Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, consulte Seguimiento de red en .NET Framework.
Consulte también
- BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object)
- AsyncCallback
- AsyncState
- SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)
- NoDelay
Se aplica a
.NET 9 y otras versiones
Producto | Versiones |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- Source:
- Socket.cs
- Source:
- Socket.cs
- Source:
- Socket.cs
Finaliza un envío asincrónico pendiente.
public:
int EndSend(IAsyncResult ^ asyncResult, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode);
public int EndSend (IAsyncResult asyncResult, out System.Net.Sockets.SocketError errorCode);
member this.EndSend : IAsyncResult * SocketError -> int
Public Function EndSend (asyncResult As IAsyncResult, ByRef errorCode As SocketError) As Integer
Parámetros
- asyncResult
- IAsyncResult
IAsyncResult que almacena información de estado para esta operación asincrónica.
- errorCode
- SocketError
Objeto SocketError que almacena el error de socket.
Devoluciones
Si se realiza con éxito, el número de bytes enviados al objeto Socket; en caso contrario, un error de Socket no válido.
Excepciones
asyncResult
es null
.
asyncResult
no se devolvió mediante una llamada al método BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object).
EndSend(IAsyncResult) fue llamado previamente para el envío asincrónico.
Solo .NET Framework, .NET Core y .NET 5-6: Socket se ha cerrado .
Comentarios
Importante
Se trata de una API de compatibilidad. No se recomienda usar los métodos de APM (Begin*
y End*
) para el nuevo desarrollo. En su lugar, use los Task
equivalentes basados en .
EndSend completa la operación iniciada por BeginSend. Debe pasar el IAsyncResult objeto creado por la llamada coincidente BeginSend .
Si usa un protocolo sin conexión, EndSend se bloqueará hasta que se envíe el datagrama. Si usa un protocolo orientado a la conexión, EndSend se bloqueará hasta que se envíe parte del búfer. Si el valor devuelto de EndSend indica que el búfer no se envió por completo, llame BeginSend al método de nuevo, modificando el búfer para contener los datos no enviados.
No hay ninguna garantía de que los datos que envíe aparecerán en la red inmediatamente. Para aumentar la eficiencia de la red, el sistema subyacente puede retrasar la transmisión hasta que se recopile una cantidad significativa de datos salientes. Una finalización correcta del BeginSend método significa que el sistema subyacente ha tenido espacio para almacenar en búfer los datos de un envío de red.
Nota
Si recibe un SocketException, use la SocketException.ErrorCode propiedad para obtener el código de error específico.
Nota
Todas las E/S iniciadas por un subproceso determinado se cancelan cuando se cierra ese subproceso. Se puede producir un error en una operación asincrónica pendiente si el subproceso sale antes de que se complete la operación.
Nota
La finalización correcta de un envío no indica que los datos se entregaron correctamente. Si no hay espacio en búfer disponible en el sistema de transporte para contener los datos que se van a transmitir, el envío se bloqueará a menos que el socket se haya colocado en modo de no bloqueo.
Nota
Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, consulte Seguimiento de red en .NET Framework.
Consulte también
- BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object)
- AsyncCallback
- AsyncState
- SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)
- NoDelay
Se aplica a
.NET 9 y otras versiones
Producto | Versiones |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: