次の方法で共有


WebClient.OpenWrite メソッド

定義

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

オーバーロード

OpenWrite(String)

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

OpenWrite(Uri)

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

OpenWrite(String, String)

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

OpenWrite(Uri, String)

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

OpenWrite(String)

ソース:
WebClient.cs
ソース:
WebClient.cs
ソース:
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 リソースにデータを書き込むのに使用されます。

例外

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

BaseAddressaddress を組み合わせて形成された 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.")

注釈

注意

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

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

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

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

手記

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

適用対象

OpenWrite(Uri)

ソース:
WebClient.cs
ソース:
WebClient.cs
ソース:
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 リソースにデータを書き込むのに使用されます。

例外

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

BaseAddressaddress を組み合わせて形成された URI が無効です。

-又は-

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

注釈

注意

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

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

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

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

手記

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

適用対象

OpenWrite(String, String)

ソース:
WebClient.cs
ソース:
WebClient.cs
ソース:
WebClient.cs

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

public:
 System::IO::Stream ^ OpenWrite(System::String ^ address, System::String ^ method);
public System.IO.Stream OpenWrite (string address, 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 リソースにデータを書き込むのに使用されます。

例外

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

BaseAddressaddress を組み合わせて形成された 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.")

注釈

注意

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

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

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

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

手記

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

適用対象

OpenWrite(Uri, String)

ソース:
WebClient.cs
ソース:
WebClient.cs
ソース:
WebClient.cs

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

public:
 System::IO::Stream ^ OpenWrite(Uri ^ address, System::String ^ method);
public System.IO.Stream OpenWrite (Uri address, 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 リソースにデータを書き込むのに使用されます。

例外

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

BaseAddressaddress を組み合わせて形成された URI が無効です。

-又は-

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

注釈

注意

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

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

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

手記

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

適用対象