Socket.SendAsync Metoda

Zdroj:

Socket.Tasks.cs

Zdroj:

Socket.Tasks.cs

Zdroj:

Socket.Tasks.cs

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

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

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

Parametry

Návraty

Asynchronní úloha, která se dokončí s počtem odeslaných bajtů.

Výjimky

Zdroj:

Socket.Tasks.cs

Zdroj:

Socket.Tasks.cs

Zdroj:

Socket.Tasks.cs

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers, System::Net::Sockets::SocketFlags socketFlags);

public System.Threading.Tasks.Task<int> SendAsync (System.Collections.Generic.IList<ArraySegment<byte>> buffers, System.Net.Sockets.SocketFlags socketFlags);

member this.SendAsync : System.Collections.Generic.IList<ArraySegment<byte>> * System.Net.Sockets.SocketFlags -> System.Threading.Tasks.Task<int>

Public Function SendAsync (buffers As IList(Of ArraySegment(Of Byte)), socketFlags As SocketFlags) As Task(Of Integer)

Parametry

Návraty

Asynchronní úloha, která se dokončí s počtem odeslaných bajtů.

Výjimky

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Send(IList<ArraySegment<Byte>>, SocketFlags).

Zdroj:

Socket.Tasks.cs

Zdroj:

Socket.Tasks.cs

Zdroj:

Socket.Tasks.cs

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

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

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

Public Function SendAsync (buffer As ArraySegment(Of Byte), socketFlags As SocketFlags) As Task(Of Integer)

Parametry

Návraty

Asynchronní úloha, která se dokončí s počtem odeslaných bajtů.

Výjimky

Zdroj:

Socket.Tasks.cs

Zdroj:

Socket.Tasks.cs

Zdroj:

Socket.Tasks.cs

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

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

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

Parametry

Návraty

Asynchronní úloha, která se dokončí s počtem odeslaných bajtů.

Výjimky

Zdroj:

Socket.Tasks.cs

Zdroj:

Socket.Tasks.cs

Zdroj:

Socket.Tasks.cs

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers);

public System.Threading.Tasks.Task<int> SendAsync (System.Collections.Generic.IList<ArraySegment<byte>> buffers);

member this.SendAsync : System.Collections.Generic.IList<ArraySegment<byte>> -> System.Threading.Tasks.Task<int>

Public Function SendAsync (buffers As IList(Of ArraySegment(Of Byte))) As Task(Of Integer)

Parametry

Návraty

Asynchronní úloha, která se dokončí s počtem odeslaných bajtů.

Výjimky

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Send(IList<ArraySegment<Byte>>).

Zdroj:

Socket.Tasks.cs

Zdroj:

Socket.Tasks.cs

Zdroj:

Socket.Tasks.cs

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(ArraySegment<System::Byte> buffer);

public System.Threading.Tasks.Task<int> SendAsync (ArraySegment<byte> buffer);

member this.SendAsync : ArraySegment<byte> -> System.Threading.Tasks.Task<int>

Public Function SendAsync (buffer As ArraySegment(Of Byte)) As Task(Of Integer)

Parametry

Návraty

Asynchronní úloha, která se dokončí s počtem odeslaných bajtů.

Výjimky

Zdroj:

Socket.cs

Zdroj:

Socket.cs

Zdroj:

Socket.cs

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

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

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

Public Function SendAsync (e As SocketAsyncEventArgs) As Boolean

Parametry

Návraty

true pokud operace V/V čeká na vyřízení. Událost Completed parametru e se vyvolá po dokončení operace.

false pokud se vstupně-výstupní operace dokončila synchronně. V tomto případě událost parametru e nebude vyvolána a e objekt předaný jako parametr může být prozkoumán okamžitě poté, Completed co se volání metody vrátí, aby se načetl výsledek operace.

Výjimky

Poznámky

Metoda SendAsync se používá k zápisu odchozích dat z jedné nebo více vyrovnávacích pamětí v soketu orientovaném na připojení. Tuto metodu lze použít také u soketů bez připojení, které určily vzdáleného hostitele při operaci připojení.

Metoda SendAsync spustí operaci asynchronního odeslání vzdálenému hostiteli vytvořenému Acceptv metodě , AcceptAsync, BeginAccept, BeginConnect, Connectnebo ConnectAsync .

Následující vlastnosti a události na objektu System.Net.Sockets.SocketAsyncEventArgs jsou vyžadovány k úspěšnému volání této metody:

• SocketAsyncEventArgs.Buffer nebo SocketAsyncEventArgs.BufferList

• SocketAsyncEventArgs.Count pokud SocketAsyncEventArgs.Buffer je nastavená

• SocketAsyncEventArgs.Offset pokud SocketAsyncEventArgs.Buffer je nastavená

• SocketAsyncEventArgs.Completed

Volající může nastavit SocketAsyncEventArgs.UserToken vlastnost na libovolný objekt stavu uživatele požadovaný před voláním SendAsync metody tak, aby informace bylo možné získat v metodě zpětného volání. Pokud zpětné volání potřebuje více informací než jeden objekt, lze vytvořit malou třídu, která bude obsahovat ostatní požadované informace o stavu jako členy.

Metoda SendAsync vyvolá výjimku, pokud nejprve nezavoláte Accept, AcceptAsync, BeginAcceptBeginConnect, Connectnebo ConnectAsync.

SendAsync Volání metody vám dává možnost odesílat data v rámci samostatného vlákna provádění.

U soketů orientovaných na zprávy nepřekračujte maximální velikost zprávy základního zprostředkovatele služby Sokety systému Windows. Pokud jsou data příliš dlouhá na to, aby se předala atomicky prostřednictvím základního poskytovatele služeb, nepřenesou se žádná data a SendAsync metoda vyvolá SocketException chybu se SocketAsyncEventArgs.SocketError sadou na nativní kód chyby Winsock WSAEMSGSIZE (10040).

Všimněte si, že úspěšné dokončení SendAsync metody neznamená, že data byla úspěšně doručena.

Viz také

• SocketAsyncEventArgs
• Buffer
• BufferList
• Completed
• Count
• Offset
• UserToken