WebClient.OpenWriteTaskAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
タスク オブジェクトを使用した非同期操作として指定されたリソースにデータを書き込むストリームを開きます。 これらのメソッドは、呼び出し元のスレッドをブロックしません。
オーバーロード
OpenWriteTaskAsync(String) |
タスク オブジェクトを使用した非同期操作として指定されたリソースにデータを書き込むストリームを開きます。 |
OpenWriteTaskAsync(Uri) |
タスク オブジェクトを使用した非同期操作として指定されたリソースにデータを書き込むストリームを開きます。 |
OpenWriteTaskAsync(String, String) |
タスク オブジェクトを使用した非同期操作として指定されたリソースにデータを書き込むストリームを開きます。 |
OpenWriteTaskAsync(Uri, String) |
タスク オブジェクトを使用した非同期操作として指定されたリソースにデータを書き込むストリームを開きます。 |
OpenWriteTaskAsync(String)
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
タスク オブジェクトを使用した非同期操作として指定されたリソースにデータを書き込むストリームを開きます。
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address);
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address);
member this.OpenWriteTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenWriteTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenWriteTaskAsync (address As String) As Task(Of Stream)
パラメーター
- address
- String
データを受信するリソースの URI。
戻り値
非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、リソースへのデータの書き込みに使用される Stream を返します。
- 属性
例外
address
パラメーターが null
です。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、データ リソースへの書き込み可能なストリームが開かれた後に完了します。 このメソッドは、ストリームが開いている間、呼び出し元のスレッドをブロックしません。
このメソッドは、 パラメーターで Stream 指定されたリソースにデータを書き込むのに使用されるインスタンスを address
取得します。 ストリームは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して取得されます。
注意
が終了Streamしたら、 を呼び出Stream.Closeして、システム リソースが不足しないようにする必要があります。
.NET Framework と .NET Core 1.0 では、 メソッドを呼び出すことで、完了していない非同期操作を CancelAsync 取り消すことができます。
プロパティが BaseAddress 空の文字列 ("") address
ではなく、絶対 URI を含まない場合は、 address
と組み合わせて BaseAddress 、要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが空の QueryString 文字列でない場合は、 に address
追加されます。
このメソッドは、STOR コマンドを使用して FTP リソースをアップロードします。 HTTP リソースの場合は、POST メソッドが使用されます。
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「 .NET Framework でのネットワーク トレース」を参照してください。
こちらもご覧ください
適用対象
OpenWriteTaskAsync(Uri)
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
タスク オブジェクトを使用した非同期操作として指定されたリソースにデータを書き込むストリームを開きます。
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address);
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address);
member this.OpenWriteTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenWriteTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenWriteTaskAsync (address As Uri) As Task(Of Stream)
パラメーター
- address
- Uri
データを受信するリソースの URI。
戻り値
非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、リソースへのデータの書き込みに使用される Stream を返します。
- 属性
例外
address
パラメーターが null
です。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、データ リソースへの書き込み可能なストリームが開かれた後に完了します。 このメソッドは、ストリームが開いている間、呼び出し元のスレッドをブロックしません。
このメソッドは、 パラメーターで Stream 指定されたリソースにデータを書き込むのに使用されるインスタンスを address
取得します。 ストリームは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して取得されます。
注意
が終了Streamしたら、 を呼び出Stream.Closeして、システム リソースが不足しないようにする必要があります。
.NET Framework と .NET Core 1.0 では、 メソッドを呼び出すことで、完了していない非同期操作を CancelAsync 取り消すことができます。
プロパティが BaseAddress 空の文字列 ("") address
ではなく、絶対 URI を含まない場合は、 address
と組み合わせて BaseAddress 、要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが空の QueryString 文字列でない場合は、 に address
追加されます。
このメソッドは、STOR コマンドを使用して FTP リソースをアップロードします。 HTTP リソースの場合は、POST メソッドが使用されます。
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「 .NET Framework でのネットワーク トレース」を参照してください。
適用対象
OpenWriteTaskAsync(String, String)
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
タスク オブジェクトを使用した非同期操作として指定されたリソースにデータを書き込むストリームを開きます。
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address, System::String ^ method);
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address, string? method);
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address, string method);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address, string method);
member this.OpenWriteTaskAsync : string * string -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenWriteTaskAsync : string * string -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenWriteTaskAsync (address As String, method As String) As Task(Of Stream)
パラメーター
- address
- String
データを受信するリソースの URI。
- method
- String
リソースにデータを送信するために使用するメソッド。 null の場合、http の既定値は POST、ftp の既定値は STOR です。
戻り値
非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、リソースへのデータの書き込みに使用される Stream を返します。
- 属性
例外
address
パラメーターが null
です。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、データ リソースへの書き込み可能なストリームが開かれた後に完了します。 このメソッドは、ストリームが開いている間、呼び出し元のスレッドをブロックしません。
このメソッドは、 パラメーターで Stream 指定されたリソースにデータを書き込むのに使用されるインスタンスを address
取得します。 ストリームは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して取得されます。
注意
が終了Streamしたら、 を呼び出Stream.Closeして、システム リソースが不足しないようにする必要があります。
パラメーターで method
サーバーで認識されないメソッドが指定されている場合、基になるプロトコル クラスによって何が発生するかが決まります。 通常、 WebException は、エラーを示すために プロパティが Status 設定された 状態でスローされます。
.NET Framework と .NET Core 1.0 では、 メソッドを呼び出すことで、完了していない非同期操作を CancelAsync 取り消すことができます。
プロパティが BaseAddress 空の文字列 ("") address
ではなく、絶対 URI を含まない場合は、 address
と組み合わせて BaseAddress 、要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが空の QueryString 文字列でない場合は、 に address
追加されます。
このメソッドは、STOR コマンドを使用して FTP リソースをアップロードします。 HTTP リソースの場合は、POST メソッドが使用されます。
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「 .NET Framework でのネットワーク トレース」を参照してください。
こちらもご覧ください
適用対象
OpenWriteTaskAsync(Uri, String)
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
- ソース:
- WebClient.cs
タスク オブジェクトを使用した非同期操作として指定されたリソースにデータを書き込むストリームを開きます。
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address, System::String ^ method);
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address, string? method);
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address, string method);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address, string method);
member this.OpenWriteTaskAsync : Uri * string -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenWriteTaskAsync : Uri * string -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenWriteTaskAsync (address As Uri, method As String) As Task(Of Stream)
パラメーター
- address
- Uri
データを受信するリソースの URI。
- method
- String
リソースにデータを送信するために使用するメソッド。 null の場合、http の既定値は POST、ftp の既定値は STOR です。
戻り値
非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、リソースへのデータの書き込みに使用される Stream を返します。
- 属性
例外
address
パラメーターが null
です。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、データ リソースへの書き込み可能なストリームが開かれた後に完了します。 このメソッドは、ストリームが開いている間、呼び出し元のスレッドをブロックしません。
このメソッドは、 パラメーターで Stream 指定されたリソースにデータを書き込むのに使用されるインスタンスを address
取得します。 ストリームは、スレッド プールから自動的に割り当てられるスレッド リソースを使用して取得されます。
注意
が終了Streamしたら、 を呼び出Stream.Closeして、システム リソースが不足しないようにする必要があります。
パラメーターが method
サーバーで認識されないメソッドを指定する場合、基になるプロトコル クラスによって何が発生するかが決まります。 通常、 WebException は、エラーを示すために プロパティが Status 設定された状態でスローされます。
.NET Framework と .NET Core 1.0 では、 メソッドを呼び出すことで、完了していない非同期操作を CancelAsync 取り消すことができます。
プロパティが空の BaseAddress 文字列 ("") address
ではなく、絶対 URI を含まない場合は、 address
と組み合わせて BaseAddress 要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが QueryString 空の文字列でない場合は、 に address
追加されます。
このメソッドでは、STOR コマンドを使用して FTP リソースをアップロードします。 HTTP リソースの場合は、POST メソッドが使用されます。
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「 .NET Framework でのネットワーク トレース」を参照してください。
こちらもご覧ください
適用対象
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示