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

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

Contoh

Contoh kode berikut menggunakan Headers koleksi untuk mengatur header HTTP Content-Type 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

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

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

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

• Tanggal

• Host

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

• Terima

• Koneksi

• Panjang-Konten

• Expect (ketika nilai diatur ke "100-continue"

• If-Modified-Since

• Rentang

• Pengodean-Transfer

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

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