Bagikan melalui

WebClient.UploadValues Metode

  • Referensi

Definisi

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

Mengunggah kumpulan nama/nilai ke sumber daya dengan URI yang ditentukan.

Overload

UploadValues(String, NameValueCollection)

Mengunggah kumpulan nama/nilai yang ditentukan ke sumber daya yang diidentifikasi oleh URI yang ditentukan.
UploadValues(Uri, NameValueCollection)

Mengunggah kumpulan nama/nilai yang ditentukan ke sumber daya yang diidentifikasi oleh URI yang ditentukan.
UploadValues(String, String, NameValueCollection)

Mengunggah kumpulan nama/nilai yang ditentukan ke sumber daya yang diidentifikasi oleh URI yang ditentukan, menggunakan metode yang ditentukan.
UploadValues(Uri, String, NameValueCollection)

Mengunggah kumpulan nama/nilai yang ditentukan ke sumber daya yang diidentifikasi oleh URI yang ditentukan, menggunakan metode yang ditentukan.

UploadValues(String, NameValueCollection)

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

Mengunggah kumpulan nama/nilai yang ditentukan ke sumber daya yang diidentifikasi oleh URI yang ditentukan.

public:
 cli::array <System::Byte> ^ UploadValues(System::String ^ address, System::Collections::Specialized::NameValueCollection ^ data);
public byte[] UploadValues (string address, System.Collections.Specialized.NameValueCollection data);
member this.UploadValues : string * System.Collections.Specialized.NameValueCollection -> byte[]
Public Function UploadValues (address As String, data As NameValueCollection) As Byte()

Parameter

address
String

URI sumber daya untuk menerima koleksi.

data
NameValueCollection

NameValueCollection untuk dikirim ke sumber daya.

Mengembalikan

Byte[]

Array Byte yang berisi isi respons dari sumber daya.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter datanull.

WebException

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

-atau-

data null.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

Terjadi kesalahan saat membuka aliran.

-atau-

Header Content-type tidak null atau "application/x-www-form-urlencoded".

Contoh

Contoh kode berikut mengumpulkan informasi dari pengguna (nama, usia, dan alamat) dan memposting nilai ke server menggunakan UploadValues. Respons apa pun dari server ditampilkan di konsol.

Console::Write( "\nPlease enter the URI to post data to: " );
String^ uriString = Console::ReadLine();

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;

// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection^ myNameValueCollection = gcnew NameValueCollection;

Console::WriteLine( "Please enter the following parameters to be posted to the URL" );
Console::Write( "Name: " );
String^ name = Console::ReadLine();

Console::Write( "Age: " );
String^ age = Console::ReadLine();

Console::Write( "Address: " );
String^ address = Console::ReadLine();

// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection->Add( "Name", name );
myNameValueCollection->Add( "Address", address );
myNameValueCollection->Add( "Age", age );

Console::WriteLine( "\nUploading to {0} ...", uriString );
// 'The Upload(String, NameValueCollection)' implicitly method sets HTTP POST as the request method.
array<Byte>^ responseArray = myWebClient->UploadValues( uriString, myNameValueCollection );

// Decode and display the response.
Console::WriteLine( "\nResponse received was :\n {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();

// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection myNameValueCollection = new NameValueCollection();

Console.WriteLine("Please enter the following parameters to be posted to the URL");
Console.Write("Name:");
string name = Console.ReadLine();

Console.Write("Age:");
string age = Console.ReadLine();

Console.Write("Address:");
string address = Console.ReadLine();

// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name",name);            
myNameValueCollection.Add("Address",address);
myNameValueCollection.Add("Age",age);

Console.WriteLine("\nUploading to {0} ...",  uriString);
// 'The Upload(String,NameValueCollection)' implicitly method sets HTTP POST as the request method.            
byte[] responseArray = myWebClient.UploadValues(uriString,myNameValueCollection);

// Decode and display the response.
Console.WriteLine("\nResponse received was :\n{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()
' Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
Dim myNameValueCollection As New NameValueCollection()
Console.WriteLine("Please enter the following parameters to be posted to the URL:")
Console.Write("Name:")
Dim name As String = Console.ReadLine()

Console.Write("Age:")
Dim age As String = Console.ReadLine()

Console.Write("Address:")
Dim address As String = Console.ReadLine()

' Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name", name)
myNameValueCollection.Add("Address", address)
myNameValueCollection.Add("Age", age)

Console.WriteLine(ControlChars.Cr + "Uploading to {0} ...", uriString)
' The Upload(String,NameValueCollection)' method implicitly sets the HTTP POST as the request method.			
Dim responseArray As Byte() = myWebClient.UploadValues(uriString, myNameValueCollection)

' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :" + ControlChars.Cr + "{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 UploadValues mengirim NameValueCollection ke server. Metode ini memblokir saat mengunggah data. Untuk terus mengeksekusi sambil menunggu respons server, gunakan salah satu metode UploadValuesAsync.

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.

Jika header Jenis konten null, metode UploadValues mengaturnya ke "application/x-www-form-urlencoded".

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.

Metode ini menggunakan perintah STOR untuk mengunggah sumber daya FTP. Untuk sumber daya HTTP, metode POST digunakan.

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

UploadValues(Uri, NameValueCollection)

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

Mengunggah kumpulan nama/nilai yang ditentukan ke sumber daya yang diidentifikasi oleh URI yang ditentukan.

public:
 cli::array <System::Byte> ^ UploadValues(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);
public byte[] UploadValues (Uri address, System.Collections.Specialized.NameValueCollection data);
member this.UploadValues : Uri * System.Collections.Specialized.NameValueCollection -> byte[]
Public Function UploadValues (address As Uri, data As NameValueCollection) As Byte()

Parameter

address
Uri

URI sumber daya untuk menerima koleksi.

data
NameValueCollection

NameValueCollection untuk dikirim ke sumber daya.

Mengembalikan

Byte[]

Array Byte yang berisi isi respons dari sumber daya.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter datanull.

WebException

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

-atau-

data null.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

Terjadi kesalahan saat membuka aliran.

-atau-

Header Content-type tidak null atau "application/x-www-form-urlencoded".

Keterangan

Hati

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

Metode UploadValues mengirim NameValueCollection ke server. Metode ini memblokir saat mengunggah data. Untuk terus mengeksekusi sambil menunggu respons server, gunakan salah satu metode UploadValuesAsync.

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.

Jika header Jenis konten null, metode UploadValues mengaturnya ke "application/x-www-form-urlencoded".

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.

Metode ini menggunakan perintah STOR untuk mengunggah sumber daya FTP. Untuk sumber daya HTTP, metode POST digunakan.

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

UploadValues(String, String, NameValueCollection)

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

Mengunggah kumpulan nama/nilai yang ditentukan ke sumber daya yang diidentifikasi oleh URI yang ditentukan, menggunakan metode yang ditentukan.

public:
 cli::array <System::Byte> ^ UploadValues(System::String ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);
public byte[] UploadValues (string address, string? method, System.Collections.Specialized.NameValueCollection data);
public byte[] UploadValues (string address, string method, System.Collections.Specialized.NameValueCollection data);
member this.UploadValues : string * string * System.Collections.Specialized.NameValueCollection -> byte[]
Public Function UploadValues (address As String, method As String, data As NameValueCollection) As Byte()

Parameter

address
String

URI sumber daya untuk menerima koleksi.

method
String

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

data
NameValueCollection

NameValueCollection untuk dikirim ke sumber daya.

Mengembalikan

Byte[]

Array Byte yang berisi isi respons dari sumber daya.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter datanull.

WebException

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

-atau-

data null.

-atau-

Terjadi kesalahan saat membuka aliran.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

Nilai header Content-type tidak null dan tidak application/x-www-form-urlencoded.

Contoh

Contoh kode berikut mengumpulkan informasi dari pengguna (nama, usia, dan alamat) dan memposting nilai ke server menggunakan UploadValues. Respons apa pun dari server ditampilkan di konsol.

Console::Write( "\nPlease enter the URL to post data to: " );
String^ uriString = Console::ReadLine();

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;

// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection^ myNameValueCollection = gcnew NameValueCollection;

Console::WriteLine( "Please enter the following parameters to be posted to the URI" );
Console::Write( "Name: " );
String^ name = Console::ReadLine();

Console::Write( "Age: " );
String^ age = Console::ReadLine();

Console::Write( "Address: " );
String^ address = Console::ReadLine();

// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection->Add( "Name", name );
myNameValueCollection->Add( "Address", address );
myNameValueCollection->Add( "Age", age );
Console::WriteLine( "\nUploading to {0} ...", uriString );

// Upload the NameValueCollection.
array<Byte>^ responseArray = myWebClient->UploadValues( uriString, "POST", myNameValueCollection );

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

Console.Write("\nPlease enter the URL to post data to : ");
string uriString = Console.ReadLine();

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();

// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection myNameValueCollection = new NameValueCollection();

Console.WriteLine("Please enter the following parameters to be posted to the URI");
Console.Write("Name:");
string name = Console.ReadLine();

Console.Write("Age:");
string age = Console.ReadLine();

Console.Write("Address:");
string address = Console.ReadLine();

// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name",name);			
myNameValueCollection.Add("Address",address);
myNameValueCollection.Add("Age",age);
Console.WriteLine("\nUploading to {0} ...",  uriString);

// Upload the NameValueCollection.
byte[] responseArray = myWebClient.UploadValues(uriString,"POST",myNameValueCollection);

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

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

' Create a new WebClient instance.
Dim myWebClient As New WebClient()

' Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
Dim myNameValueCollection As New NameValueCollection()

Console.WriteLine("Please enter the following parameters to be posted to the Url")
Console.Write("Name:")
Dim name As String = Console.ReadLine()

Console.Write("Age:")
Dim age As String = Console.ReadLine()

Console.Write("Address:")
Dim address As String = Console.ReadLine()

' Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name", name)
myNameValueCollection.Add("Address", address)
myNameValueCollection.Add("Age", age)

Console.WriteLine(ControlChars.Cr + "Uploading to {0} ...", uriString)

' Upload the NameValueCollection.
Dim responseArray As Byte() = myWebClient.UploadValues(uriString, "POST", myNameValueCollection)

' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :" + ControlChars.Cr + "{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 UploadValues mengirim NameValueCollection ke sumber daya menggunakan metode 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 UploadValuesAsync.

Jika header Content-typenull, metode UploadValues mengaturnya ke application/x-www-form-urlencoded.

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

UploadValues(Uri, String, NameValueCollection)

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

Mengunggah kumpulan nama/nilai yang ditentukan ke sumber daya yang diidentifikasi oleh URI yang ditentukan, menggunakan metode yang ditentukan.

public:
 cli::array <System::Byte> ^ UploadValues(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);
public byte[] UploadValues (Uri address, string? method, System.Collections.Specialized.NameValueCollection data);
public byte[] UploadValues (Uri address, string method, System.Collections.Specialized.NameValueCollection data);
member this.UploadValues : Uri * string * System.Collections.Specialized.NameValueCollection -> byte[]
Public Function UploadValues (address As Uri, method As String, data As NameValueCollection) As Byte()

Parameter

address
Uri

URI sumber daya untuk menerima koleksi.

method
String

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

data
NameValueCollection

NameValueCollection untuk dikirim ke sumber daya.

Mengembalikan

Byte[]

Array Byte yang berisi isi respons dari sumber daya.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter datanull.

WebException

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

-atau-

data null.

-atau-

Terjadi kesalahan saat membuka aliran.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

Nilai header Content-type tidak null dan tidak application/x-www-form-urlencoded.

Keterangan

Hati

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

Metode UploadValues mengirim NameValueCollection ke sumber daya menggunakan metode 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 UploadValuesAsync.

Jika header Content-typenull, metode UploadValues mengaturnya ke application/x-www-form-urlencoded.

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