Bagikan melalui

WebClient.UploadData Metode

  • Referensi

Definisi

Ruang nama:
System.Net
Rakitan:
System.Net.WebClient.dll
Rakitan:
System.dll
Rakitan:
netstandard.dll

Mengunggah buffer data ke sumber daya dengan URI yang ditentukan.

Overload

UploadData(String, Byte[])

Mengunggah buffer data ke sumber daya yang diidentifikasi oleh URI.
UploadData(Uri, Byte[])

Mengunggah buffer data ke sumber daya yang diidentifikasi oleh URI.
UploadData(String, String, Byte[])

Mengunggah buffer data ke sumber daya yang ditentukan, menggunakan metode yang ditentukan.
UploadData(Uri, String, Byte[])

Mengunggah buffer data ke sumber daya yang ditentukan, menggunakan metode yang ditentukan.

UploadData(String, Byte[])

Sumber:
WebClient.cs
Sumber:
WebClient.cs
Sumber:
WebClient.cs

Mengunggah buffer data ke sumber daya yang diidentifikasi oleh 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()

Parameter

address
String

URI sumber daya untuk menerima data.

data
Byte[]

Buffer data untuk dikirim ke sumber daya.

Mengembalikan

Byte[]

Array Byte yang berisi isi respons dari sumber daya.

Pengecualian

ArgumentNullException

Parameter addressnull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress, dan address tidak valid.

-atau-

data null.

-atau-

Terjadi kesalahan saat mengirim data.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

Contoh

Contoh kode berikut mengonversi string yang dimasukkan dari konsol ke array Byte dan memposting array ke server yang ditentukan menggunakan UploadData. Respons apa pun dari server ditampilkan ke konsol.

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

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode UploadData mengirim buffer data ke sumber daya.

Metode ini menggunakan perintah STOR untuk mengunggah sumber daya FTP. Untuk sumber daya HTTP, metode POST digunakan. Jika permintaan yang mendasar tidak dipahami oleh server, kelas protokol yang mendasar menentukan apa yang terjadi. Biasanya, WebException dilemparkan dengan properti Status diatur untuk menunjukkan kesalahan.

Metode UploadData mengirim konten data ke server tanpa mengodekannya. Metode ini memblokir saat mengunggah data. Untuk terus mengeksekusi sambil menunggu respons server, gunakan salah satu metode UploadDataAsync.

Jika properti BaseAddress bukan string kosong ("") dan address tidak berisi URI absolut, address harus URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data yang diminta. Jika properti QueryString bukan string kosong, properti ditambahkan ke address.

Nota

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Network Tracing di .NET Framework.

Berlaku untuk

UploadData(Uri, Byte[])

Sumber:
WebClient.cs
Sumber:
WebClient.cs
Sumber:
WebClient.cs

Mengunggah buffer data ke sumber daya yang diidentifikasi oleh 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()

Parameter

address
Uri

URI sumber daya untuk menerima data.

data
Byte[]

Buffer data untuk dikirim ke sumber daya.

Mengembalikan

Byte[]

Array Byte yang berisi isi respons dari sumber daya.

Pengecualian

ArgumentNullException

Parameter addressnull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress, dan address tidak valid.

-atau-

data null.

-atau-

Terjadi kesalahan saat mengirim data.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode UploadData mengirim buffer data ke sumber daya.

Metode ini menggunakan perintah STOR untuk mengunggah sumber daya FTP. Untuk sumber daya HTTP, metode POST digunakan. Jika permintaan yang mendasar tidak dipahami oleh server, kelas protokol yang mendasar menentukan apa yang terjadi. Biasanya, WebException dilemparkan dengan properti Status diatur untuk menunjukkan kesalahan.

Metode UploadData mengirim konten data ke server tanpa mengodekannya. Metode ini memblokir saat mengunggah data. Untuk terus mengeksekusi sambil menunggu respons server, gunakan salah satu metode UploadDataAsync.

Jika properti BaseAddress bukan string kosong ("") dan address tidak berisi URI absolut, address harus URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data yang diminta. Jika properti QueryString bukan string kosong, properti ditambahkan ke address.

Nota

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Network Tracing di .NET Framework.

Berlaku untuk

UploadData(String, String, Byte[])

Sumber:
WebClient.cs
Sumber:
WebClient.cs
Sumber:
WebClient.cs

Mengunggah buffer data ke sumber daya yang ditentukan, menggunakan metode yang ditentukan.

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()

Parameter

address
String

URI sumber daya untuk menerima data.

method
String

Metode HTTP yang digunakan untuk mengirim data ke sumber daya. Jika null, defaultnya adalah POST untuk http dan STOR untuk ftp.

data
Byte[]

Buffer data untuk dikirim ke sumber daya.

Mengembalikan

Byte[]

Array Byte yang berisi isi respons dari sumber daya.

Pengecualian

ArgumentNullException

Parameter addressnull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress, dan address tidak valid.

-atau-

data null.

-atau-

Terjadi kesalahan saat mengunggah data.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

Contoh

Contoh kode berikut mengonversi string yang dimasukkan dari konsol menjadi array byte dan memposting array ke server yang ditentukan menggunakan UploadData. Respons apa pun dari server ditampilkan ke konsol.

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

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode UploadData mengirim buffer data ke sumber daya menggunakan metode HTTP yang ditentukan dalam parameter method, dan mengembalikan respons apa pun dari server. Metode ini memblokir saat mengunggah data. Untuk terus mengeksekusi sambil menunggu respons server, gunakan salah satu metode UploadDataAsync.

Metode UploadData mengirim konten data ke server tanpa mengodekannya.

Jika parameter method menentukan kata kerja yang tidak dipahami oleh server, kelas protokol yang mendasar menentukan apa yang terjadi. Biasanya, WebException dilemparkan dengan properti Status diatur untuk menunjukkan kesalahan.

Jika properti BaseAddress bukan string kosong ("") dan address tidak berisi URI absolut, address harus URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data yang diminta. Jika properti QueryString bukan string kosong, properti ditambahkan ke address.

Nota

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Network Tracing di .NET Framework.

Berlaku untuk

UploadData(Uri, String, Byte[])

Sumber:
WebClient.cs
Sumber:
WebClient.cs
Sumber:
WebClient.cs

Mengunggah buffer data ke sumber daya yang ditentukan, menggunakan metode yang ditentukan.

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()

Parameter

address
Uri

URI sumber daya untuk menerima data.

method
String

Metode HTTP yang digunakan untuk mengirim data ke sumber daya. Jika null, defaultnya adalah POST untuk http dan STOR untuk ftp.

data
Byte[]

Buffer data untuk dikirim ke sumber daya.

Mengembalikan

Byte[]

Array Byte yang berisi isi respons dari sumber daya.

Pengecualian

ArgumentNullException

Parameter addressnull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress, dan address tidak valid.

-atau-

data null.

-atau-

Terjadi kesalahan saat mengunggah data.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode UploadData mengirim buffer data ke sumber daya menggunakan metode HTTP yang ditentukan dalam parameter method, dan mengembalikan respons apa pun dari server. Metode ini memblokir saat mengunggah data. Untuk terus mengeksekusi sambil menunggu respons server, gunakan salah satu metode UploadDataAsync.

Metode UploadData mengirim konten data ke server tanpa mengodekannya.

Jika parameter method menentukan kata kerja yang tidak dipahami oleh server, kelas protokol yang mendasar menentukan apa yang terjadi. Biasanya, WebException dilemparkan dengan properti Status diatur untuk menunjukkan kesalahan.

Jika properti BaseAddress bukan string kosong ("") dan address tidak berisi URI absolut, address harus URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data yang diminta. Jika properti QueryString bukan string kosong, properti ditambahkan ke address.

Nota

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Network Tracing di .NET Framework.

Berlaku untuk