Socket.EndSendFile(IAsyncResult) メソッド

定義

名前空間:

System.Net.Sockets

アセンブリ:

System.Net.Sockets.dll

ソース:

Socket.cs

ファイルの保留中の非同期送信を終了します。

public:
 void EndSendFile(IAsyncResult ^ asyncResult);

public void EndSendFile (IAsyncResult asyncResult);

member this.EndSendFile : IAsyncResult -> unit

Public Sub EndSendFile (asyncResult As IAsyncResult)

パラメーター

asyncResult

IAsyncResult

この非同期操作の状態情報を格納する IAsyncResult オブジェクト。

例外

NotSupportedException

.NET 8 以降のみ: ソケットがリモート ホストに接続されていません。

ObjectDisposedException

.NET Framework、.NET Core、.NET 5-6 のみ: がSocket閉じられました。

ArgumentNullException

asyncResult が空です。

ArgumentException

BeginSendFile(String, AsyncCallback, Object) メソッドへの呼び出しで asyncResult が返されませんでした。

InvalidOperationException

EndSendFile(IAsyncResult) が、非同期の BeginSendFile(String, AsyncCallback, Object) のために以前に呼び出されています。

SocketException

ソケットへのアクセスを試行しているときにエラーが発生しました。

- または -

.NET 7 以降のみ: が Socket 閉じられました。

注釈

重要

これは互換性 API です。 新しい開発に APM (Begin* および End*) メソッドを使用することはお勧めしません。 代わりに、 ベースの Task同等のものを使用してください。

EndSendFile によって BeginSend開始された操作が完了します。 一致する呼び出しによって作成された を IAsyncResult 渡す必要があります BeginSend 。

コネクションレス プロトコルを使用している場合は、 EndSendFile データグラムが送信されるまでブロックします。 接続指向プロトコルを使用している場合は、 EndSendFile ファイル全体が送信されるまでブロックします。 送信したデータがネットワークにすぐに表示される保証はありません。 ネットワーク効率を高めるために、基になるシステムは、大量の送信データが収集されるまで送信を遅らせる場合があります。 メソッドが正常に BeginSendFile 完了すると、基になるシステムにネットワーク送信用のデータをバッファーする領域があることを意味します。

Note

を受け取った場合は SocketException、 プロパティを SocketException.ErrorCode 使用して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。

Note

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。