WebClient.OpenWrite メソッド

定義

名前空間:

System.Net

アセンブリ:

System.Net.WebClient.dll

指定した URI を持つリソースへデータを書き込むストリームを開きます。

オーバーロード

OpenWrite(String)	指定したリソースにデータを書き込むためのストリームを開きます。
OpenWrite(Uri)	指定したリソースにデータを書き込むためのストリームを開きます。
OpenWrite(String, String)	指定したメソッドを使用して、指定したリソースにデータを書き込むためのストリームを開きます。
OpenWrite(Uri, String)	指定したメソッドを使用して、指定したリソースにデータを書き込むためのストリームを開きます。

OpenWrite(String)

ソース:

WebClient.cs

指定したリソースにデータを書き込むためのストリームを開きます。

public:
 System::IO::Stream ^ OpenWrite(System::String ^ address);

public System.IO.Stream OpenWrite (string address);

member this.OpenWrite : string -> System.IO.Stream

Public Function OpenWrite (address As String) As Stream

パラメーター

address

String

データを受信するリソースの URI。

戻り値

Stream

リソースにデータを書き込むために使用する Stream。

例外

ArgumentNullException

address パラメーターが null です。

WebException

BaseAddress および address を組み合わせて形成された URI が無効です。

- または -

ストリームのオープン中にエラーが発生しました。

例

次のコード例では、コマンド ラインからデータを読み取り、 を使用 OpenWrite してデータを書き込むためのストリームを取得します。 によってOpenWrite返される はStream、データの送信後に閉じられます。

String^ uriString;
Console::Write( "\nPlease enter the URI to post data to: " );
uriString = Console::ReadLine();
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
// Apply Ascii Encoding to obtain an array of bytes.
array<Byte>^ postArray = Encoding::ASCII->GetBytes( postData );

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;

// postStream implicitly sets HTTP POST as the request method.
Console::WriteLine( "Uploading to {0} ...", uriString );
Stream^ postStream = myWebClient->OpenWrite( uriString );

postStream->Write( postArray, 0, postArray->Length );

// Close the stream and release resources.
postStream->Close();

Console::WriteLine( "\nSuccessfully posted the data." );

string uriString;
Console.Write("\nPlease enter the URI to post data to : ");
uriString = Console.ReadLine();
Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
string postData = Console.ReadLine();
// Apply Ascii Encoding to obtain an array of bytes. 
byte[] postArray = Encoding.ASCII.GetBytes(postData);

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();

// postStream implicitly sets HTTP POST as the request method.
Console.WriteLine("Uploading to {0} ...",  uriString);							Stream postStream = myWebClient.OpenWrite(uriString);

postStream.Write(postArray,0,postArray.Length);

// Close the stream and release resources.
postStream.Close();

Console.WriteLine("\nSuccessfully posted the data.");

Dim uriString As String
Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
uriString = Console.ReadLine()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)

Dim postData As String = Console.ReadLine()

' Apply ASCII Encoding to obtain an array of bytes .
Dim postArray As Byte() = Encoding.ASCII.GetBytes(postData)

' Create a new WebClient instance.
Dim myWebClient As New WebClient()

Console.WriteLine("Uploading to {0} ...", uriString)

' OpenWrite implicitly sets HTTP POST as the request method.
Dim postStream As Stream = myWebClient.OpenWrite(uriString)
postStream.Write(postArray, 0, postArray.Length)

' Close the stream and release resources.
postStream.Close()

Console.WriteLine(ControlChars.Cr + "Successfully posted the data.")

注釈

メソッドは OpenWrite 、リソースにデータを送信するために使用される書き込み可能なストリームを返します。 このメソッドは、ストリームを開くときにブロックします。 ストリームの待機中に実行を続行するには、いずれかのメソッドを OpenWriteAsync 使用します。

プロパティが空の BaseAddress 文字列 ("") address ではなく、絶対 URI を含まない場合は、 address と組み合わせて BaseAddress 要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが QueryString 空の文字列でない場合は、 に address追加されます。

このメソッドでは、STOR コマンドを使用して FTP リソースをアップロードします。 HTTP リソースの場合は、POST メソッドが使用されます。

Note

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

OpenWrite(Uri)

ソース:

WebClient.cs

指定したリソースにデータを書き込むためのストリームを開きます。

public:
 System::IO::Stream ^ OpenWrite(Uri ^ address);

public System.IO.Stream OpenWrite (Uri address);

member this.OpenWrite : Uri -> System.IO.Stream

Public Function OpenWrite (address As Uri) As Stream

パラメーター

address

Uri

データを受信するリソースの URI。

戻り値

Stream

リソースにデータを書き込むために使用する Stream。

例外

ArgumentNullException

address パラメーターが null です。

WebException

BaseAddress および address を組み合わせて形成された URI が無効です。

- または -

ストリームのオープン中にエラーが発生しました。

注釈

メソッドは OpenWrite 、リソースにデータを送信するために使用される書き込み可能なストリームを返します。 このメソッドは、ストリームを開くときにブロックします。 ストリームの待機中に実行を続行するには、いずれかのメソッドを OpenWriteAsync 使用します。

プロパティが空の BaseAddress 文字列 ("") address ではなく、絶対 URI を含まない場合は、 address と組み合わせて BaseAddress 要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが QueryString 空の文字列でない場合は、 に address追加されます。

このメソッドでは、STOR コマンドを使用して FTP リソースをアップロードします。 HTTP リソースの場合は、POST メソッドが使用されます。

Note

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

OpenWrite(String, String)

ソース:

WebClient.cs

指定したメソッドを使用して、指定したリソースにデータを書き込むためのストリームを開きます。

public:
 System::IO::Stream ^ OpenWrite(System::String ^ address, System::String ^ method);

public System.IO.Stream OpenWrite (string address, string? method);

member this.OpenWrite : string * string -> System.IO.Stream

Public Function OpenWrite (address As String, method As String) As Stream

パラメーター

address

String

データを受信するリソースの URI。

method

String

リソースにデータを送信するために使用するメソッド。 null の場合、http の既定値は POST、ftp の既定値は STOR です。

戻り値

Stream

リソースにデータを書き込むために使用する Stream。

例外

ArgumentNullException

address パラメーターが null です。

WebException

BaseAddress および address を組み合わせて形成された URI が無効です。

- または -

ストリームのオープン中にエラーが発生しました。

例

次のコード例では、コマンド ラインからデータを読み取り、 を使用 OpenWrite してデータの書き込みに使用されるストリームを取得します。 によってOpenWrite返される はStream、データを送信するために閉じる必要があります。

String^ uriString;
Console::Write( "\nPlease enter the URI to post data to: " );
uriString = Console::ReadLine();
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
// Apply ASCII encoding to obtain an array of bytes .
array<Byte>^ postArray = Encoding::ASCII->GetBytes( postData );

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;

Console::WriteLine( "Uploading to {0} ...", uriString );
Stream^ postStream = myWebClient->OpenWrite( uriString, "POST" );
postStream->Write( postArray, 0, postArray->Length );

// Close the stream and release resources.
postStream->Close();
Console::WriteLine( "\nSuccessfully posted the data." );

string uriString;
Console.Write("\nPlease enter the URI to post data to : ");
uriString = Console.ReadLine();
Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
string postData = Console.ReadLine();
// Apply ASCII encoding to obtain an array of bytes .
byte[] postArray = Encoding.ASCII.GetBytes(postData);

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();

Console.WriteLine("Uploading to {0} ...",  uriString);						
Stream postStream = myWebClient.OpenWrite(uriString,"POST");
postStream.Write(postArray,0,postArray.Length);

// Close the stream and release resources.
postStream.Close();
Console.WriteLine("\nSuccessfully posted the data.");

Dim uriString As String
Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
uriString = Console.ReadLine()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)
Dim postData As String = Console.ReadLine()
' Apply ASCII encoding to obtain an array of bytes.
Dim postArray As Byte() = Encoding.ASCII.GetBytes(postData)

' Create a new WebClient instance.
Dim myWebClient As New WebClient()

Console.WriteLine("Uploading to {0} ...", uriString)
Dim postStream As Stream = myWebClient.OpenWrite(uriString, "POST")

postStream.Write(postArray, 0, postArray.Length)

' Close the stream and release resources.
postStream.Close()

Console.WriteLine(ControlChars.Cr + "Successfully posted the data.")

注釈

メソッドは OpenWrite 、リソースにデータを送信するために使用される書き込み可能なストリームを返します。 基になる要求は、 パラメーターで指定された メソッドを使用して method 行われます。 ストリームを閉じると、データがサーバーに送信されます。 このメソッドは、ストリームを開くときにブロックします。 ストリームの待機中に実行を続行するには、いずれかのメソッドを OpenWriteAsync 使用します。

パラメーターが method サーバーで認識されないメソッドを指定する場合、基になるプロトコル クラスによって何が発生するかが決まります。 通常、 WebException は、エラーを示すために プロパティが Status 設定された状態でスローされます。

プロパティが空の BaseAddress 文字列 ("") address ではなく、絶対アドレスを指定しない場合は、 address と組み合わせて BaseAddress 要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが QueryString 空の文字列でない場合は、 に address追加されます。

Note

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

OpenWrite(Uri, String)

ソース:

WebClient.cs

指定したメソッドを使用して、指定したリソースにデータを書き込むためのストリームを開きます。

public:
 System::IO::Stream ^ OpenWrite(Uri ^ address, System::String ^ method);

public System.IO.Stream OpenWrite (Uri address, string? method);

member this.OpenWrite : Uri * string -> System.IO.Stream

Public Function OpenWrite (address As Uri, method As String) As Stream

パラメーター

address

Uri

データを受信するリソースの URI。

method

String

リソースにデータを送信するために使用するメソッド。 null の場合、http の既定値は POST、ftp の既定値は STOR です。

戻り値

Stream

リソースにデータを書き込むために使用する Stream。

例外

ArgumentNullException

address パラメーターが null です。

WebException

BaseAddress および address を組み合わせて形成された URI が無効です。

- または -

ストリームのオープン中にエラーが発生しました。

注釈

メソッドは OpenWrite 、リソースにデータを送信するために使用される書き込み可能なストリームを返します。 このメソッドは、ストリームを開くときにブロックします。 ストリームの待機中に実行を続行するには、いずれかのメソッドを OpenWriteAsync 使用します。

プロパティが空の BaseAddress 文字列 ("") address ではなく、絶対 URI を含まない場合は、 address と組み合わせて BaseAddress 要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが QueryString 空の文字列でない場合は、 に address追加されます。

Note

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