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.")

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。 代わりに HttpClient を使用してください。

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

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

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

手記

このメンバーは、アプリケーションでネットワーク トレースを有効にすると、トレース情報を出力します。 詳細については、「.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 が無効です。

-又は-

ストリームを開くときにエラーが発生しました。

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。 代わりに HttpClient を使用してください。

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

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

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

手記

このメンバーは、アプリケーションでネットワーク トレースを有効にすると、トレース情報を出力します。 詳細については、「.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.")

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。 代わりに HttpClient を使用してください。

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

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

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

手記

このメンバーは、アプリケーションでネットワーク トレースを有効にすると、トレース情報を出力します。 詳細については、「.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 が無効です。

-又は-

ストリームを開くときにエラーが発生しました。

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。 代わりに HttpClient を使用してください。

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

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

手記

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