WebClient.UploadData メソッド

リファレンス

定義

名前空間:: System.Net

アセンブリ:: System.Net.WebClient.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

指定した URI を持つリソースへデータバッファーをアップロードします。

オーバーロード

UploadData(String, Byte[])	URI で識別されたリソースへデータバッファーをアップロードします。
UploadData(Uri, Byte[])	URI で識別されたリソースへデータバッファーをアップロードします。
UploadData(String, String, Byte[])	指定したメソッドを使用して、指定したリソースにデータバッファーをアップロードします。
UploadData(Uri, String, Byte[])	指定したメソッドを使用して、指定したリソースにデータバッファーをアップロードします。

UploadData(String, Byte[])

ソース:: WebClient.cs

ソース:: WebClient.cs

ソース:: WebClient.cs

URI で識別されたリソースへデータバッファーをアップロードします。

public:
 cli::array <System::Byte> ^ UploadData(System::String ^ address, cli::array <System::Byte> ^ data);

public byte[] UploadData (string address, byte[] data);

member this.UploadData : string * byte[] -> byte[]

Public Function UploadData (address As String, data As Byte()) As Byte()

パラメーター

address: String

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

data: Byte[]

リソースに送信するデータバッファー。

戻り値

Byte[]

リソースからの応答の本文を格納している Byte 配列。

例外

ArgumentNullException

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

WebException

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

- または -

data が nullです。

- または -

データの送信中にエラーが発生しました。

- または -

リソースをホストしているサーバーから応答がありませんでした。

例

次のコード例では、コンソールから入力した文字列を配列に Byte 変換し、を使用して UploadData配列を指定したサーバーにポストします。サーバーからの応答がコンソールに表示されます。

Console::Write( "\nPlease enter the URI to post data to: " );
String^ uriString = Console::ReadLine();
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
// Apply ASCII Encoding to obtain the String* as a Byte array.
array<Byte>^ postArray = Encoding::ASCII->GetBytes( postData );
Console::WriteLine( "Uploading to {0} ...", uriString );
myWebClient->Headers->Add( "Content-Type", "application/x-www-form-urlencoded" );

//UploadData implicitly sets HTTP POST as the request method.
array<Byte>^responseArray = myWebClient->UploadData( uriString, postArray );

// Decode and display the response.
Console::WriteLine( "\nResponse received was: {0}", Encoding::ASCII->GetString( responseArray ) );

    Console.Write("\nPlease enter the URI to post data to : ");
    string uriString = Console.ReadLine();
    // Create a new WebClient instance.
    WebClient myWebClient = new WebClient();
    Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
    string postData = Console.ReadLine();
    // Apply ASCII Encoding to obtain the string as a byte array.
    byte[] postArray = Encoding.ASCII.GetBytes(postData);
    Console.WriteLine("Uploading to {0} ...",  uriString);							
 myWebClient.Headers.Add("Content-Type","application/x-www-form-urlencoded");

    //UploadData implicitly sets HTTP POST as the request method.
    byte[] responseArray = myWebClient.UploadData(uriString,postArray);

    // Decode and display the response.
    Console.WriteLine("\nResponse received was :{0}", Encoding.ASCII.GetString(responseArray));

Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
Dim uriString As String = Console.ReadLine()

' Create a new WebClient instance.
Dim myWebClient As New WebClient()
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 the string as a byte array.
Dim postArray As Byte() = Encoding.ASCII.GetBytes(postData)
Console.WriteLine("Uploading to {0} ...", uriString)
myWebClient.Headers.Add("Content-Type", "application/x-www-form-urlencoded")

' UploadData implicitly sets HTTP POST as the request method.
Dim responseArray As Byte() = myWebClient.UploadData(uriString, postArray)

' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :{0}", Encoding.ASCII.GetString(responseArray))

注釈

メソッドは UploadData 、データバッファーをリソースに送信します。

このメソッドは、STOR コマンドを使用して FTP リソースをアップロードします。 HTTP リソースの場合は、POST メソッドが使用されます。基になる要求がサーバーによって認識されない場合、基になるプロトコルクラスによって何が発生するかが決まります。通常、 WebException は、エラーを示すためにプロパティが Status 設定された状態でスローされます。

メソッドは UploadData 、の data コンテンツをエンコードせずにサーバーに送信します。このメソッドは、データのアップロード中にブロックします。サーバーの応答の待機中に実行を続行するには、いずれかのメソッドを UploadDataAsync 使用します。

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

Note

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

適用対象

UploadData(Uri, Byte[])

ソース:: WebClient.cs

ソース:: WebClient.cs

ソース:: WebClient.cs

URI で識別されたリソースへデータバッファーをアップロードします。

public:
 cli::array <System::Byte> ^ UploadData(Uri ^ address, cli::array <System::Byte> ^ data);

public byte[] UploadData (Uri address, byte[] data);

member this.UploadData : Uri * byte[] -> byte[]

Public Function UploadData (address As Uri, data As Byte()) As Byte()

パラメーター

address: Uri

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

data: Byte[]

リソースに送信するデータバッファー。

戻り値

Byte[]

リソースからの応答の本文を格納している Byte 配列。

例外

ArgumentNullException

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

WebException

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

- または -

data が nullです。

- または -

データの送信中にエラーが発生しました。

- または -

リソースをホストしているサーバーから応答がありませんでした。

注釈

メソッドは UploadData 、データバッファーをリソースに送信します。

Note

適用対象

UploadData(String, String, Byte[])

ソース:: WebClient.cs

ソース:: WebClient.cs

ソース:: WebClient.cs

指定したメソッドを使用して、指定したリソースにデータバッファーをアップロードします。

public:
 cli::array <System::Byte> ^ UploadData(System::String ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public byte[] UploadData (string address, string? method, byte[] data);

public byte[] UploadData (string address, string method, byte[] data);

member this.UploadData : string * string * byte[] -> byte[]

Public Function UploadData (address As String, method As String, data As Byte()) As Byte()

パラメーター

address: String

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

method: String

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

data: Byte[]

リソースに送信するデータバッファー。

戻り値

Byte[]

リソースからの応答の本文を格納している Byte 配列。

例外

ArgumentNullException

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

WebException

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

- または -

data が nullです。

- または -

データのアップロード中にエラーが発生しました。

- または -

リソースをホストしているサーバーから応答がありませんでした。

例

次のコード例では、コンソールから入力した文字列をバイト配列に変換し、を使用して UploadData配列を指定したサーバーにポストします。サーバーからの応答がコンソールに表示されます。

String^ uriString;
Console::Write( "\nPlease enter the URI to post data to {for example, http://www.contoso.com}: " );
uriString = Console::ReadLine();

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
myWebClient->Headers->Add( "Content-Type", "application/x-www-form-urlencoded" );

// Displays the headers in the request
Console::Write( "Resulting Request Headers: ");
Console::WriteLine(myWebClient->Headers);

// Apply ASCII Encoding to obtain the String^ as a Byte array.
array<Byte>^ byteArray = Encoding::ASCII->GetBytes( postData );
Console::WriteLine( "Uploading to {0} ...", uriString );
// Upload the input String* using the HTTP 1.0 POST method.
array<Byte>^responseArray = myWebClient->UploadData( uriString, "POST", byteArray );
// Decode and display the response.
Console::WriteLine( "\nResponse received was {0}",
   Encoding::ASCII->GetString( responseArray ) );

   string uriString;
       Console.Write("\nPlease enter the URI to post data to {for example, http://www.contoso.com} : ");
       uriString = Console.ReadLine();

       // Create a new WebClient instance.
       WebClient myWebClient = new WebClient();
       Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
       string postData = Console.ReadLine();
       myWebClient.Headers.Add("Content-Type","application/x-www-form-urlencoded");

 // Display the headers in the request
       Console.Write("Resulting Request Headers: ");
       Console.WriteLine(myWebClient.Headers.ToString());
       
       // Apply ASCII Encoding to obtain the string as a byte array.

       byte[] byteArray = Encoding.ASCII.GetBytes(postData);
       Console.WriteLine("Uploading to {0} ...",  uriString);						
       // Upload the input string using the HTTP 1.0 POST method.
       byte[] responseArray = myWebClient.UploadData(uriString,"POST",byteArray);
       
       // Decode and display the response.
       Console.WriteLine("\nResponse received was {0}",
       Encoding.ASCII.GetString(responseArray));

Dim uriString As String
Console.Write(ControlChars.Cr + "Please enter the URI to post data to{for example, http://www.contoso.com} : ")
uriString = Console.ReadLine()

' Create a new WebClient instance.
Dim myWebClient As New WebClient()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)
Dim postData As String = Console.ReadLine()
myWebClient.Headers.Add("Content-Type", "application/x-www-form-urlencoded")

' Display the headers in the request
Console.Write("Resulting Request Headers: ")
Console.Writeline(myWebClient.Headers.ToString())

' Apply ASCII Encoding to obtain the string as a byte array.
Dim byteArray As Byte() = Encoding.ASCII.GetBytes(postData)
Console.WriteLine("Uploading to {0} ...", uriString)
' Upload the input string using the HTTP 1.0 POST method.
Dim responseArray As Byte() = myWebClient.UploadData(uriString, "POST", byteArray)
' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :{0}", Encoding.ASCII.GetString(responseArray))

注釈

メソッドは UploadData 、パラメーターで指定された HTTP メソッドを使用してリソースにデータバッファーを method 送信し、サーバーからの応答を返します。このメソッドは、データのアップロード中にブロックします。サーバーの応答の待機中に実行を続行するには、いずれかのメソッドを UploadDataAsync 使用します。

メソッドは UploadData 、の data コンテンツをエンコードせずにサーバーに送信します。

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

Note

適用対象

UploadData(Uri, String, Byte[])

ソース:: WebClient.cs

ソース:: WebClient.cs

ソース:: WebClient.cs

指定したメソッドを使用して、指定したリソースにデータバッファーをアップロードします。

public:
 cli::array <System::Byte> ^ UploadData(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public byte[] UploadData (Uri address, string? method, byte[] data);

public byte[] UploadData (Uri address, string method, byte[] data);

member this.UploadData : Uri * string * byte[] -> byte[]

Public Function UploadData (address As Uri, method As String, data As Byte()) As Byte()

パラメーター

address: Uri

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

method: String

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

data: Byte[]

リソースに送信するデータバッファー。

戻り値

Byte[]

リソースからの応答の本文を格納している Byte 配列。

例外

ArgumentNullException

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

WebException

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

- または -

data が nullです。

- または -

データのアップロード中にエラーが発生しました。

- または -

リソースをホストしているサーバーから応答がありませんでした。

注釈

メソッドは UploadData 、パラメーターで指定された HTTP メソッドを使用してリソースにデータバッファーを method 送信し、サーバーからの応答を返します。このメソッドは、データのアップロード中にブロックします。サーバーの応答を待機しながら実行を続行するには、いずれかのメソッドを UploadDataAsync 使用します。

メソッドは UploadData 、の data コンテンツをエンコードせずにサーバーに送信します。

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

Note

適用対象

WebClient.UploadData メソッド

定義

オーバーロード

UploadData(String, Byte[])

パラメーター

戻り値

例外

例

注釈

適用対象

UploadData(Uri, Byte[])

パラメーター

戻り値

例外

注釈

適用対象

UploadData(String, String, Byte[])

パラメーター

戻り値

例外

例

注釈

適用対象

UploadData(Uri, String, Byte[])

パラメーター

戻り値

例外

注釈

適用対象

フィードバック

その他のリソース