WebClient.OpenWrite メソッド

定義

指定した URI を持つリソースへデータを書き込むストリームを開きます。Opens a stream for writing data to a resource with the specified URI.

オーバーロード

OpenWrite(String)

指定したリソースにデータを書き込むためのストリームを開きます。Opens a stream for writing data to the specified resource.

OpenWrite(Uri)

指定したリソースにデータを書き込むためのストリームを開きます。Opens a stream for writing data to the specified resource.

OpenWrite(String, String)

指定したメソッドを使用して、指定したリソースにデータを書き込むためのストリームを開きます。Opens a stream for writing data to the specified resource, using the specified method.

OpenWrite(Uri, String)

指定したメソッドを使用して、指定したリソースにデータを書き込むためのストリームを開きます。Opens a stream for writing data to the specified resource, by using the specified method.

OpenWrite(String)

指定したリソースにデータを書き込むためのストリームを開きます。Opens a stream for writing data to the specified resource.

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。The URI of the resource to receive the data.

戻り値

Stream

リソースにデータを書き込むために使用する StreamA Stream used to write data to the resource.

例外

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.

次のコード例では、コマンドラインからデータを読み取り、を使用して OpenWrite データを書き込むストリームを取得します。The following code example reads data from the command line and uses OpenWrite to obtain a stream for writing the data. Streamによって返されたは、 OpenWrite データが送信された後に閉じられます。The Stream returned by OpenWrite is closed after the data is sent.

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 リソースにデータを送信するために使用される書き込み可能なストリームを返します。The OpenWrite method returns a writable stream that is used to send data to a resource. このメソッドは、ストリームを開くときにブロックします。This method blocks while opening the stream. ストリームの待機中に実行を継続するには、メソッドのいずれかを使用し OpenWriteAsync ます。To continue executing while waiting for the stream, use one of the OpenWriteAsync 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.

適用対象

OpenWrite(Uri)

指定したリソースにデータを書き込むためのストリームを開きます。Opens a stream for writing data to the specified resource.

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。The URI of the resource to receive the data.

戻り値

Stream

リソースにデータを書き込むために使用する StreamA Stream used to write data to the resource.

例外

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.

注釈

メソッドは、 OpenWrite リソースにデータを送信するために使用される書き込み可能なストリームを返します。The OpenWrite method returns a writable stream that is used to send data to a resource. このメソッドは、ストリームを開くときにブロックします。This method blocks while opening the stream. ストリームの待機中に実行を継続するには、メソッドのいずれかを使用し OpenWriteAsync ます。To continue executing while waiting for the stream, use one of the OpenWriteAsync 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.

適用対象

OpenWrite(String, String)

指定したメソッドを使用して、指定したリソースにデータを書き込むためのストリームを開きます。Opens a stream for writing data to the specified resource, using the specified method.

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。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.

戻り値

Stream

リソースにデータを書き込むために使用する StreamA Stream used to write data to the resource.

例外

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.

次のコード例では、コマンドラインからデータを読み取り、を使用して OpenWrite データの書き込みに使用されるストリームを取得します。The following code example reads data from the command line and uses OpenWrite to obtain a stream used to write the data. Streamによって返されたは、 OpenWrite データを送信するために閉じる必要があります。The Stream returned by OpenWrite must be closed to send 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 .
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 リソースにデータを送信するために使用される書き込み可能なストリームを返します。The OpenWrite method returns a writable stream that is used to send data to a resource. 基になる要求は、パラメーターで指定されたメソッドを使用して行われ method ます。The underlying request is made with the method specified in the method parameter. ストリームを閉じると、データがサーバーに送信されます。The data is sent to the server when you close the stream. このメソッドは、ストリームを開くときにブロックします。This method blocks while opening the stream. ストリームの待機中に実行を継続するには、メソッドのいずれかを使用し OpenWriteAsync ます。To continue executing while waiting for the stream, use one of the OpenWriteAsync methods.

パラメーターで、 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.

BaseAddressプロパティが空の文字列 ("") ではなく、絶対アドレスも指定されていない場合 address 、は、 address 要求された BaseAddress データの絶対 uri を形成するためにと組み合わせられる相対 uri である必要があります。If the BaseAddress property is not an empty string ("") and address does not specify an absolute address, 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.

適用対象

OpenWrite(Uri, String)

指定したメソッドを使用して、指定したリソースにデータを書き込むためのストリームを開きます。Opens a stream for writing data to the specified resource, by using the specified method.

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。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.

戻り値

Stream

リソースにデータを書き込むために使用する StreamA Stream used to write data to the resource.

例外

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.

注釈

メソッドは、 OpenWrite リソースにデータを送信するために使用される書き込み可能なストリームを返します。The OpenWrite method returns a writable stream that is used to send data to a resource. このメソッドは、ストリームを開くときにブロックします。This method blocks while opening the stream. ストリームの待機中に実行を継続するには、メソッドのいずれかを使用し OpenWriteAsync ます。To continue executing while waiting for the stream, use one of the OpenWriteAsync 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.

適用対象