WebClient.Headers Vlastnost

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.WebClient.dll

Zdroj:

WebClient.cs

Získá nebo nastaví kolekci dvojic název/hodnota hlavičky přidružené k požadavku.

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

Hodnota vlastnosti

WebHeaderCollection

A WebHeaderCollection obsahující páry název/hodnota hlavičky přidružené k tomuto požadavku.

Příklady

Následující příklad kódu používá Headers kolekci k nastavení hlavičky application/x-www-form-urlencoded, HTTP Content-Type na upozornění serveru, že data formuláře jsou připojena k post.

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))

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Vlastnost Headers obsahuje WebHeaderCollection instanci obsahující hlavičky protokolu, které WebClient odesílá s požadavkem.

Některé běžné hlavičky jsou považovány za omezené a jsou chráněny systémem a nelze je nastavit nebo změnit v objektu WebHeaderCollection . Všechny pokusy o nastavení jedné z těchto omezených hlaviček v objektu WebHeaderCollection přidruženém k objektu WebClient vyvolá výjimku později při pokusu WebClient o odeslání požadavku.

Omezená záhlaví chráněná systémem zahrnují, ale nejsou omezeny na následující:

• Rande

• Hostitel

Kromě toho jsou při použití objektu WebClient také omezeny některé další hlavičky. Mezi tyto hlavičky s omezeným přístupem patří, ale nejsou omezeny na následující:

• Přijmout

• Připojení

• Délka obsahu

• Očekávejte (pokud je hodnota nastavená na "100-continue".

• If-Modified-Since

• Rozmezí

• Transfer-Encoding

Třída HttpWebRequest má vlastnosti pro nastavení některých z výše uvedených hlaviček. Pokud je důležité, aby aplikace nastavil tyto hlavičky, HttpWebRequest měla by být třída použita místo WebRequest třídy.

Neměli byste předpokládat, že hodnoty hlaviček zůstanou beze změny, protože webové servery a mezipaměti můžou změnit nebo přidat hlavičky do webového požadavku.

Viz také

• Headers
• Headers