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

untuk NameValueCollection mengirim ke sumber daya.

Mengembalikan

Byte[]

Array Byte yang berisi isi respons dari sumber daya.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya data adalah null.

WebException

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

-atau-

dataadalah null.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

Terjadi kesalahan saat membuka aliran.

-atau-

Header Content-type bukan 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

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

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

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

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

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

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan 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

untuk NameValueCollection mengirim ke sumber daya.

Mengembalikan

Byte[]

Array Byte yang berisi isi respons dari sumber daya.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya data adalah null.

WebException

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

-atau-

dataadalah null.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

Terjadi kesalahan saat membuka aliran.

-atau-

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

Keterangan

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

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

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

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

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

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan 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

untuk NameValueCollection mengirim ke sumber daya.

Mengembalikan

Byte[]

Array Byte yang berisi isi respons dari sumber daya.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya data adalah null.

WebException

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

-atau-

dataadalah null.

-atau-

Terjadi kesalahan saat membuka aliran.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

Nilai Content-type header bukan null dan bukan 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

Metode UploadValues mengirimkan NameValueCollection ke sumber daya menggunakan metode yang ditentukan dalam method parameter dan mengembalikan respons apa pun dari server. Metode ini memblokir saat mengunggah data. Untuk terus mengeksekusi sambil menunggu respons server, gunakan salah UploadValuesAsync satu metode .

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

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

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

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan 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

untuk NameValueCollection mengirim ke sumber daya.

Mengembalikan

Byte[]

Array Byte yang berisi isi respons dari sumber daya.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya data adalah null.

WebException

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

-atau-

dataadalah null.

-atau-

Terjadi kesalahan saat membuka aliran.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

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

Keterangan

Metode UploadValues mengirimkan NameValueCollection ke sumber daya menggunakan metode yang ditentukan dalam method parameter dan mengembalikan respons apa pun dari server. Metode ini memblokir saat mengunggah data. Untuk terus mengeksekusi sambil menunggu respons server, gunakan salah UploadValuesAsync satu metode .

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

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

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

Catatan

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

Berlaku untuk