Socket.SendAsync メソッド

定義

名前空間:

System.Net.Sockets

アセンブリ:

System.Net.Sockets.dll

アセンブリ:

System.dll, System.Net.Sockets.dll

アセンブリ:

System.dll

アセンブリ:

netstandard.dll

オーバーロード

SendAsync(ReadOnlyMemory<Byte>, CancellationToken)	接続されたソケットでデータを送信します。
SendAsync(IList<ArraySegment<Byte>>, SocketFlags)	接続されたソケットでデータを送信します。
SendAsync(ArraySegment<Byte>, SocketFlags)	接続されたソケットでデータを送信します。
SendAsync(ReadOnlyMemory<Byte>, SocketFlags, CancellationToken)	接続されたソケットでデータを送信します。
SendAsync(IList<ArraySegment<Byte>>)	接続されたソケットでデータを送信します。
SendAsync(ArraySegment<Byte>)	接続されたソケットでデータを送信します。
SendAsync(SocketAsyncEventArgs)	接続されている Socket オブジェクトに、データを非同期に送信します。

SendAsync(ReadOnlyMemory<Byte>, CancellationToken)

接続されたソケットでデータを送信します。

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)

パラメーター

buffer

ReadOnlyMemory<Byte>

送信するデータのバッファー。

cancellationToken

CancellationToken

非同期操作を取り消すために使用できるキャンセル トークン。

戻り値

ValueTask<Int32>

送信されたバイト数で完了する非同期タスク。

SendAsync(IList<ArraySegment<Byte>>, SocketFlags)

接続されたソケットでデータを送信します。

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)

パラメーター

buffers

IList<ArraySegment<Byte>>

送信するデータのバッファーの一覧。

socketFlags

SocketFlags

データの送信時に使用される SocketFlags 値のビットごとの組み合わせ。

戻り値

Task<Int32>

送信されたバイト数で完了する非同期タスク。

SendAsync(ArraySegment<Byte>, SocketFlags)

接続されたソケットでデータを送信します。

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)

パラメーター

buffer

ArraySegment<Byte>

送信するデータのバッファー。

socketFlags

SocketFlags

データの送信時に使用される SocketFlags 値のビットごとの組み合わせ。

戻り値

Task<Int32>

送信されたバイト数で完了する非同期タスク。

SendAsync(ReadOnlyMemory<Byte>, SocketFlags, CancellationToken)

接続されたソケットでデータを送信します。

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)

パラメーター

buffer

ReadOnlyMemory<Byte>

送信するデータのバッファー。

socketFlags

SocketFlags

データの送信時に使用される SocketFlags 値のビットごとの組み合わせ。

cancellationToken

CancellationToken

非同期操作を取り消すために使用できるキャンセル トークン。

戻り値

ValueTask<Int32>

送信されたバイト数で完了する非同期タスク。

SendAsync(IList<ArraySegment<Byte>>)

接続されたソケットでデータを送信します。

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)

パラメーター

buffers

IList<ArraySegment<Byte>>

送信するデータのバッファーの一覧。

戻り値

Task<Int32>

送信されたバイト数で完了する非同期タスク。

SendAsync(ArraySegment<Byte>)

接続されたソケットでデータを送信します。

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)

パラメーター

buffer

ArraySegment<Byte>

送信するデータのバッファー。

戻り値

Task<Int32>

送信されたバイト数で完了する非同期タスク。

SendAsync(SocketAsyncEventArgs)

接続されている Socket オブジェクトに、データを非同期に送信します。

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

パラメーター

e

SocketAsyncEventArgs

この非同期ソケット操作に使用する SocketAsyncEventArgs オブジェクト。

戻り値

Boolean

I/O 操作が保留中の場合は true。 操作の完了時に、e パラメーターの Completed イベントが発生します。

I/O 操作が同期的に完了した場合は false。 この場合、e パラメーターの Completed イベントは発生しません。メソッド呼び出しから制御が戻った直後に、パラメーターとして渡された e オブジェクトを調べて操作の結果を取得できます。

例外

ArgumentException

e パラメーターの Buffer プロパティまたは BufferList プロパティは、有効なバッファーを参照する必要があります。 これらのプロパティは、どちらか 1 つを設定できます。一度に両方のプロパティを設定することはできません。

InvalidOperationException

e パラメーターに指定された SocketAsyncEventArgs オブジェクトを使用してソケット操作が既に進行していました。

NotSupportedException

このメソッドには Windows XP 以降が必要です。

ObjectDisposedException

Socket が閉じられました。

SocketException

Socket がまだ接続されていないか、Accept()、AcceptAsync(SocketAsyncEventArgs)、または BeginAccept の各メソッドによって取得されませんでした。

注釈

この SendAsync メソッドは、接続指向ソケット上の 1 つ以上のバッファーから送信データを書き込むのに使用されます。 ただし、このメソッドは、接続操作でリモート ホストを指定したコネクションレス ソケットでも使用できます。

メソッドは、またはConnectAsyncメソッドで確立されたリモート ホストへの非同期送信操作をAcceptAcceptAsyncBeginAcceptBeginConnectConnect開始します。SendAsync

このメソッドを正常に呼び出すには、オブジェクトの System.Net.Sockets.SocketAsyncEventArgs 次のプロパティとイベントが必要です。

• SocketAsyncEventArgs.Buffer または SocketAsyncEventArgs.BufferList

• SocketAsyncEventArgs.Count if SocketAsyncEventArgs.Buffer is set

• SocketAsyncEventArgs.Offset if SocketAsyncEventArgs.Buffer is set

• SocketAsyncEventArgs.Completed

呼び出し元は、コールバック メソッドで情報を取得できるように、メソッドを呼び出すSendAsync前に必要な任意のユーザー状態オブジェクトにプロパティを設定SocketAsyncEventArgs.UserTokenできます。 コールバックに 1 つのオブジェクトよりも多くの情報が必要な場合は、他の必須状態情報をメンバーとして保持する小さなクラスを作成できます。

最初に呼び出さない場合、メソッドはSendAsync例外をスローします。 ConnectBeginConnectAcceptAsyncBeginAcceptConnectAsyncAccept

このメソッドを SendAsync 呼び出すと、別の実行スレッド内でデータを送信できます。

メッセージ指向ソケットの場合は、基になる Windows ソケット サービス プロバイダーの最大メッセージ サイズを超えないようにします。 データが長すぎて基になるサービス プロバイダーをアトミックに通過できない場合、データは送信されませんSendAsync。メソッドは、ネイティブ Winsock WSAEMSGSIZE エラー コード (10040) に設定された a SocketAsyncEventArgs.SocketError をスローSocketExceptionします。

メソッドが正常に完了しても、 SendAsync データが正常に配信されたことは示されないことに注意してください。

こちらもご覧ください

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