WebClient.OpenWriteAsync メソッド

定義

指定したリソースにデータを書き込むためのストリームを開きます。Opens a stream for writing data to the specified resource. これらのメソッドは、呼び出し元のスレッドをブロックしません。These methods do not block the calling thread.

オーバーロード

OpenWriteAsync(Uri, String, Object)

指定したメソッドを使用して、指定したリソースにデータを書き込むためのストリームを開きます。Opens a stream for writing data to the specified resource, using the specified method. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

OpenWriteAsync(Uri, String)

指定したリソースにデータを書き込むためのストリームを開きます。Opens a stream for writing data to the specified resource. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

OpenWriteAsync(Uri)

指定したリソースにデータを書き込むためのストリームを開きます。Opens a stream for writing data to the specified resource. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

OpenWriteAsync(Uri, String, Object)

指定したメソッドを使用して、指定したリソースにデータを書き込むためのストリームを開きます。Opens a stream for writing data to the specified resource, using the specified method. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

public:
 void OpenWriteAsync(Uri ^ address, System::String ^ method, System::Object ^ userToken);
public void OpenWriteAsync (Uri address, string? method, object? userToken);
public void OpenWriteAsync (Uri address, string method, object userToken);
member this.OpenWriteAsync : Uri * string * obj -> unit
Public Sub OpenWriteAsync (address As Uri, method As String, userToken As Object)

パラメーター

address
Uri

データを受信するリソースの URI。The URI of the resource to receive the data.

method
String

リソースにデータを送信するために使用するメソッド。The method used to send the data to the resource. null の場合、http の既定値は POST、ftp の既定値は STOR です。If null, the default is POST for http and STOR for ftp.

userToken
Object

非同期操作の完了時に呼び出されるメソッドに渡されるユーザー定義のオブジェクト。A user-defined object that is passed to the method invoked when the asynchronous operation completes

例外

address パラメーターが null です。The address parameter is null.

BaseAddress および address を組み合わせて形成された URI が無効です。The URI formed by combining BaseAddress and address is invalid.

- または --or-

ストリームのオープン中にエラーが発生しました。An error occurred while opening the stream.

注釈

このメソッドは、リソースにデータを送信するために使用される書き込み可能なストリームを取得します。This method retrieves a writable stream that is used to send data to a resource. ストリームは、スレッドプールから自動的に割り当てられたスレッドリソースを使用して非同期的に取得されます。The stream is retrieved asynchronously using thread resources that are automatically allocated from the thread pool. ストリームが使用可能になったときに通知を受け取るには、イベントにイベントハンドラーを追加し OpenWriteCompleted ます。To receive notification when the stream is available, add an event handler to the OpenWriteCompleted event. ストリームを閉じると、ストリームの内容がサーバーに送信されます。The contents of the stream are sent to the server when you close the stream.

パラメーターで、 method サーバーで認識されないメソッドが指定されている場合、基になるプロトコルクラスによって何が発生するかが決まります。If the method parameter specifies a method that is not understood by the server, the underlying protocol classes determine what occurs. 通常、 WebException エラーを示すには、プロパティが設定されたがスローされ Status ます。Typically, a WebException is thrown with the Status property set to indicate the error.

.NET Framework と .NET Core 1.0 では、メソッドを呼び出して、完了していない非同期操作を取り消すことができ CancelAsync ます。In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

このメソッドは、ストリームのオープン中に、呼び出し元のスレッドをブロックしません。This method does not block the calling thread while the stream is being opened. ストリームの待機中にブロックするには、メソッドのいずれかを使用し OpenWrite ます。To block while waiting for the stream, use one of the OpenWrite methods.

BaseAddressプロパティが空の文字列 ("") ではなく、 address 絶対 uri も含まれていない場合、は、 address 要求された BaseAddress データの絶対 uri を形成するためにと組み合わせた相対 uri である必要があります。If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. QueryStringプロパティが空の文字列でない場合は、に追加され address ます。If the QueryString property is not an empty string, it is appended to address.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。This member outputs trace information when you enable network tracing in your application. 詳細については、「 .NET Framework のネットワークトレース」を参照してください。For more information, see Network Tracing in .NET Framework.

適用対象

OpenWriteAsync(Uri, String)

指定したリソースにデータを書き込むためのストリームを開きます。Opens a stream for writing data to the specified resource. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

public:
 void OpenWriteAsync(Uri ^ address, System::String ^ method);
public void OpenWriteAsync (Uri address, string? method);
public void OpenWriteAsync (Uri address, string method);
member this.OpenWriteAsync : Uri * string -> unit
Public Sub OpenWriteAsync (address As Uri, method As String)

パラメーター

address
Uri

データを受信するリソースの URI。The URI of the resource to receive the data.

method
String

リソースにデータを送信するために使用するメソッド。The method used to send the data to the resource. null の場合、http の既定値は POST、ftp の既定値は STOR です。If null, the default is POST for http and STOR for ftp.

例外

address パラメーターが null です。The address parameter is null.

注釈

このメソッドは、リソースにデータを送信するために使用される書き込み可能なストリームを取得します。This method retrieves a writable stream that is used to send data to a resource. ストリームは、スレッドプールから自動的に割り当てられたスレッドリソースを使用して取得されます。The stream is retrieved using thread resources that are automatically allocated from the thread pool. ストリームが使用可能になったときに通知を受け取るには、イベントにイベントハンドラーを追加し OpenWriteCompleted ます。To receive notification when the stream is available, add an event handler to the OpenWriteCompleted event. ストリームを閉じると、要求がに送信され、応答が受信されるまで、スレッドはブロックされ address ます。When you close the stream, the thread blocks until the request is sent to address and a response is received.

このメソッドは、ストリームのオープン中に、呼び出し元のスレッドをブロックしません。This method does not block the calling thread while the stream is being opened. ストリームの待機中にブロックするには、メソッドのいずれかを使用し OpenWrite ます。To block while waiting for the stream, use one of the OpenWrite methods.

BaseAddressプロパティが空の文字列 ("") ではなく、 address 絶対 uri も含まれていない場合、は、 address 要求された BaseAddress データの絶対 uri を形成するためにと組み合わせた相対 uri である必要があります。If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. QueryStringプロパティが空の文字列でない場合は、に追加され address ます。If the QueryString property is not an empty string, it is appended to address.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。This member outputs trace information when you enable network tracing in your application. 詳細については、「 .NET Framework のネットワークトレース」を参照してください。For more information, see Network Tracing in .NET Framework.

適用対象

OpenWriteAsync(Uri)

指定したリソースにデータを書き込むためのストリームを開きます。Opens a stream for writing data to the specified resource. このメソッドは、呼び出し元のスレッドをブロックしません。This method does not block the calling thread.

public:
 void OpenWriteAsync(Uri ^ address);
public void OpenWriteAsync (Uri address);
member this.OpenWriteAsync : Uri -> unit
Public Sub OpenWriteAsync (address As Uri)

パラメーター

address
Uri

データを受信するリソースの URI。The URI of the resource to receive the data.

例外

address パラメーターが null です。The address parameter is null.

注釈

このメソッドは、リソースにデータを送信するために使用される書き込み可能なストリームを取得します。This method retrieves a writable stream that is used to send data to a resource. ストリームは、スレッドプールから自動的に割り当てられたスレッドリソースを使用して取得されます。The stream is retrieved using thread resources that are automatically allocated from the thread pool. ストリームが使用可能になったときに通知を受け取るには、イベントにイベントハンドラーを追加し OpenWriteCompleted ます。To receive notification when the stream is available, add an event handler to the OpenWriteCompleted event. ストリームを閉じると、要求がに送信され、応答が受信されるまで、スレッドはブロックされ address ます。When you close the stream, the thread blocks until the request is sent to address and a response is received.

このメソッドは、ストリームのオープン中に、呼び出し元のスレッドをブロックしません。This method does not block the calling thread while the stream is being opened. ストリームの待機中にブロックするには、メソッドのいずれかを使用し OpenWrite ます。To block while waiting for the stream, use one of the OpenWrite methods.

BaseAddressプロパティが空の文字列 ("") ではなく、 address 絶対 uri も含まれていない場合、は、 address 要求された BaseAddress データの絶対 uri を形成するためにと組み合わせた相対 uri である必要があります。If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. QueryStringプロパティが空の文字列でない場合は、に追加され address ます。If the QueryString property is not an empty string, it is appended to address.

このメソッドでは、STOR コマンドを使用して FTP リソースをアップロードします。This method uses the STOR command to upload an FTP resource. HTTP リソースの場合は、POST メソッドが使用されます。For an HTTP resource, the POST method is used.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。This member outputs trace information when you enable network tracing in your application. 詳細については、「 .NET Framework のネットワークトレース」を参照してください。For more information, see Network Tracing in .NET Framework.

適用対象