WebClient.Headers Properti

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

Sumber:

WebClient.cs

Mendapatkan atau mengatur kumpulan pasangan nama/nilai header yang terkait dengan permintaan.

public:
 property System::Net::WebHeaderCollection ^ Headers { System::Net::WebHeaderCollection ^ get(); void set(System::Net::WebHeaderCollection ^ value); };

public System.Net.WebHeaderCollection Headers { get; set; }

member this.Headers : System.Net.WebHeaderCollection with get, set

Public Property Headers As WebHeaderCollection

Nilai Properti

WebHeaderCollection

WebHeaderCollection yang berisi pasangan nama/nilai header yang terkait dengan permintaan ini.

Contoh

Contoh kode berikut menggunakan koleksi Headers untuk mengatur header Content-Type HTTP ke application/x-www-form-urlencoded, untuk memberi tahu server bahwa data formulir dilampirkan ke postingan.

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.

Properti Headers berisi instans WebHeaderCollection yang berisi header protokol yang dikirim WebClient dengan permintaan.

Beberapa header umum dianggap dibatasi dan dilindungi oleh sistem dan tidak dapat diatur atau diubah dalam objek WebHeaderCollection. Setiap upaya untuk mengatur salah satu header terbatas ini di objek WebHeaderCollection yang terkait dengan objek WebClient akan melemparkan pengecualian nanti saat mencoba mengirim permintaan WebClient.

Header terbatas yang dilindungi oleh sistem termasuk, tetapi tidak terbatas pada yang berikut ini:

• Tanggal

• Tuan rumah

Selain itu, beberapa header lain juga dibatasi saat menggunakan objek WebClient. Header terbatas ini termasuk, tetapi tidak terbatas pada yang berikut ini:

• Terima

• Sambungan

• Panjang Konten

• Mengharapkan (ketika nilai diatur ke "100-lanjutkan"

• Jika-Modified-Since

• Lingkup

• Transfer-Encoding

Kelas HttpWebRequest memiliki properti untuk mengatur beberapa header di atas. Jika penting bagi aplikasi untuk mengatur header ini, maka kelas HttpWebRequest harus digunakan alih-alih kelas WebRequest.

Anda tidak boleh berasumsi bahwa nilai header akan tetap tidak berubah, karena server web dan cache dapat mengubah atau menambahkan header ke permintaan Web.

Lihat juga

• Headers
• Headers