HttpWebRequest.Headers Propiedad

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.Requests.dll

Source:

HttpWebRequest.cs

Especifica una colección de los pares nombre-valor que componen los encabezados HTTP.

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

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

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

Public Overrides Property Headers As WebHeaderCollection

Valor de propiedad

WebHeaderCollection

Un WebHeaderCollection que contiene los pares nombre-valor que componen los encabezados de la solicitud HTTP.

Excepciones

InvalidOperationException

La solicitud se ha iniciado llamando al método GetRequestStream(), BeginGetRequestStream(AsyncCallback, Object), GetResponse()o BeginGetResponse(AsyncCallback, Object) .

Ejemplos

En el ejemplo de código siguiente se usa la propiedad Headers para imprimir los pares de nombre y valor del encabezado HTTP en la consola.

// Create a new 'HttpWebRequest' Object to the mentioned URL.
HttpWebRequest^ myHttpWebRequest = (HttpWebRequest^)( WebRequest::Create( "http://www.contoso.com" ) );
// Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
HttpWebResponse^ myHttpWebResponse = (HttpWebResponse^)( myHttpWebRequest->GetResponse() );
Console::WriteLine( "\nThe HttpHeaders are \n\n\tName\t\tValue\n {0}", myHttpWebRequest->Headers );
// Print the HTML contents of the page to the console.
Stream^ streamResponse = myHttpWebResponse->GetResponseStream();
StreamReader^ streamRead = gcnew StreamReader( streamResponse );
array<Char>^ readBuff = gcnew array<Char>(256);
int count = streamRead->Read( readBuff, 0, 256 );
Console::WriteLine( "\nThe HTML contents of page the are  : \n\n " );
while ( count > 0 )
{
   String^ outputData = gcnew String( readBuff,0,count );
   Console::Write( outputData );
   count = streamRead->Read( readBuff, 0, 256 );
}
streamResponse->Close();
streamRead->Close();
// Release the HttpWebResponse Resource.
myHttpWebResponse->Close();

// Create a new 'HttpWebRequest' Object to the mentioned URL.
HttpWebRequest myHttpWebRequest=(HttpWebRequest)WebRequest.Create("http://www.contoso.com");
// Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
HttpWebResponse myHttpWebResponse=(HttpWebResponse)myHttpWebRequest.GetResponse();
Console.WriteLine("\nThe HttpHeaders are \n\n\tName\t\tValue\n{0}",myHttpWebRequest.Headers);
// Print the HTML contents of the page to the console.
Stream streamResponse=myHttpWebResponse.GetResponseStream();
StreamReader streamRead = new StreamReader( streamResponse );
Char[] readBuff = new Char[256];
int count = streamRead.Read( readBuff, 0, 256 );
Console.WriteLine("\nThe HTML contents of page the are  : \n\n ");	
while (count > 0)
{
    String outputData = new String(readBuff, 0, count);
    Console.Write(outputData);
    count = streamRead.Read(readBuff, 0, 256);
}
// Close the Stream object.
streamResponse.Close();
streamRead.Close();
// Release the HttpWebResponse Resource.
myHttpWebResponse.Close();

     ' Create a new 'HttpWebRequest' Object to the mentioned URL.
     Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create("http://www.contoso.com"), HttpWebRequest)
     ' Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
     Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
     Console.WriteLine(ControlChars.Cr + "The HttpHeaders are " + ControlChars.Cr + ControlChars.Cr + ControlChars.Tab + "Name" + ControlChars.Tab + ControlChars.Tab + "Value" + ControlChars.Cr + "{0}", myHttpWebRequest.Headers)

     ' Print the HTML contents of the page to the console. 
     Dim streamResponse As Stream = myHttpWebResponse.GetResponseStream()
     Dim streamRead As New StreamReader(streamResponse)
     Dim readBuff(256) As [Char]
     Dim count As Integer = streamRead.Read(readBuff, 0, 256)
     Console.WriteLine(ControlChars.Cr + "The HTML contents of page the are  : " + ControlChars.Cr + ControlChars.Cr + " ")
     While count > 0
         Dim outputData As New [String](readBuff, 0, count)
         Console.Write(outputData)
         count = streamRead.Read(readBuff, 0, 256)
     End While
' Close the Stream object.
streamResponse.Close()
streamRead.Close()
' Release the HttpWebResponse Resource.
 myHttpWebResponse.Close()

Comentarios

Cautela

WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.

La colección Headers contiene los encabezados de protocolo asociados a la solicitud. En la tabla siguiente se enumeran los encabezados HTTP que no están almacenados en la colección Headers, pero que el sistema establece o establece mediante propiedades o métodos.

Encabezado	Establecido por
Aceptar	Establezca por la propiedad Accept.
Conexión	Establecido por la propiedad Connection y KeepAlive propiedad.
Longitud del contenido	Establezca por la propiedad ContentLength.
Tipo de contenido	Establezca por la propiedad ContentType.
Esperar	Establezca por la propiedad Expect.
Fecha	Establezca por la propiedad Date.
Anfitrión	Establezca por la propiedad Host.
If-Modified-Since	Establezca por la propiedad IfModifiedSince.
Gama	Establecido por el método AddRange.
Referer	Establezca por la propiedad Referer.
Transfer-Encoding	Establecido por la propiedad TransferEncoding (la propiedad SendChunked debe ser true).
User-Agent	Establezca por la propiedad UserAgent.

El método Add produce un ArgumentException si intenta establecer uno de estos encabezados protegidos.

Al cambiar la propiedad Headers después de iniciar la solicitud, se llama a GetRequestStream, BeginGetRequestStream, GetResponseo BeginGetResponse método produce un InvalidOperationException.

No debe suponer que los valores de encabezado permanecerán sin cambios, ya que los servidores web y las memorias caché pueden cambiar o agregar encabezados a una solicitud web.