WebClient.UploadValues Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
Array Byte yang berisi isi respons dari sumber daya.
Pengecualian
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
Array Byte yang berisi isi respons dari sumber daya.
Pengecualian
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
Array Byte yang berisi isi respons dari sumber daya.
Pengecualian
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-type
null
, 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
Array Byte yang berisi isi respons dari sumber daya.
Pengecualian
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-type
null
, 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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk