WebHeaderCollection.Add Método

Referencia

Definición

Espacio de nombres:: System.Net

Ensamblado:: System.Net.WebHeaderCollection.dll

Ensamblado:: System.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Inserta un nuevo encabezado en la colección.

Sobrecargas

Add(String)	Inserta el encabezado especificado en la colección.
Add(HttpRequestHeader, String)	Inserta el encabezado especificado con el valor especificado en la colección.
Add(HttpResponseHeader, String)	Inserta el encabezado especificado con el valor especificado en la colección.
Add(String, String)	Inserta en la colección un encabezado con el nombre y valor especificados.

Add(String)

Source:: WebHeaderCollection.cs

Source:: WebHeaderCollection.cs

Source:: WebHeaderCollection.cs

Inserta el encabezado especificado en la colección.

public:
 void Add(System::String ^ header);

public void Add (string header);

override this.Add : string -> unit

Public Sub Add (header As String)

Parámetros

header: String

Encabezado que se va a agregar, con el nombre y el valor separados por dos puntos.

Excepciones

ArgumentNullException

header es null o Empty.

ArgumentException

header no contiene un carácter de dos puntos (:).

La longitud de value es mayor que 65535.

o bien

La parte correspondiente al nombre de header es Empty o contiene caracteres no válidos.

o bien

header es un encabezado restringido que debe establecerse con una propiedad.

o bien

La parte correspondiente al valor de header contiene caracteres no válidos.

ArgumentOutOfRangeException

.NET Framework y versiones 2.0-3.1 de .NET Core únicamente: la longitud de la cadena después de los dos puntos (:) es mayor de 65 535.

Ejemplos

En el ejemplo siguiente se agrega un par nombre-valor a mediante WebHeaderCollection el Add método .

try
{
   //Create a web request for S"www.msn.com".
   HttpWebRequest^ myHttpWebRequest = dynamic_cast<HttpWebRequest^>(WebRequest::Create( "http://www.msn.com" ));

   //Get the headers associated with the request.
   WebHeaderCollection^ myWebHeaderCollection = myHttpWebRequest->Headers;
   Console::WriteLine( "Configuring Webrequest to accept Danish and English language using 'Add' method" );

   //Add the Accept-Language header (for Danish) in the request.
   myWebHeaderCollection->Add( "Accept-Language:da" );

   //Include English in the Accept-Langauge header.
   myWebHeaderCollection->Add( "Accept-Language:en;q=0.8" );

   //Get the associated response for the above request.
   HttpWebResponse^ myHttpWebResponse = dynamic_cast<HttpWebResponse^>(myHttpWebRequest->GetResponse());

   //Print the headers for the request.
   printHeaders( myWebHeaderCollection );
   myHttpWebResponse->Close();
}
//Catch exception if trying to add a restricted header.
catch ( ArgumentException^ e ) 
{
   Console::WriteLine( e->Message );
}
catch ( WebException^ e ) 
{
   Console::WriteLine( "\nWebException is thrown. \nMessage is : {0}", e->Message );
   if ( e->Status == WebExceptionStatus::ProtocolError )
   {
      Console::WriteLine( "Status Code : {0}", (dynamic_cast<HttpWebResponse^>(e->Response))->StatusCode );
      Console::WriteLine( "Status Description : {0}", (dynamic_cast<HttpWebResponse^>(e->Response))->StatusDescription );
      Console::WriteLine( "Server : {0}", (dynamic_cast<HttpWebResponse^>(e->Response))->Server );
   }
}
catch ( Exception^ e ) 
{
   Console::WriteLine( "Exception is thrown. Message is : {0}", e->Message );
}

try {
    //Create a web request for "www.msn.com".
    HttpWebRequest myHttpWebRequest = (HttpWebRequest) WebRequest.Create("http://www.msn.com");

    //Get the headers associated with the request.
    WebHeaderCollection myWebHeaderCollection = myHttpWebRequest.Headers;

    Console.WriteLine("Configuring Webrequest to accept Danish and English language using 'Add' method");

    //Add the Accept-Language header (for Danish) in the request.
    myWebHeaderCollection.Add("Accept-Language:da");

    //Include English in the Accept-Langauge header. 
    myWebHeaderCollection.Add("Accept-Language","en;q=0.8");

    //Get the associated response for the above request.
    HttpWebResponse myHttpWebResponse = (HttpWebResponse) myHttpWebRequest.GetResponse();

    //Print the headers for the request.
    printHeaders(myWebHeaderCollection);
    myHttpWebResponse.Close();
}
//Catch exception if trying to add a restricted header.
catch(ArgumentException e) {
    Console.WriteLine(e.Message);
}
catch(WebException e) {
    Console.WriteLine("\nWebException is thrown. \nMessage is :" + e.Message);
    if(e.Status == WebExceptionStatus.ProtocolError) {
        Console.WriteLine("Status Code : {0}", ((HttpWebResponse)e.Response).StatusCode);
        Console.WriteLine("Status Description : {0}", ((HttpWebResponse)e.Response).StatusDescription);
        Console.WriteLine("Server : {0}", ((HttpWebResponse)e.Response).Server);
    }
}
catch(Exception e) {
    Console.WriteLine("Exception is thrown. Message is :" + e.Message);
}

Public Shared Sub Main()

 Try
        'Create a web request for "www.msn.com".
        Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create("http://www.msn.com"), HttpWebRequest)
        
        'Get the headers associated with the request.
        Dim myWebHeaderCollection As WebHeaderCollection = myHttpWebRequest.Headers
        
    Console.WriteLine("Configuring Webrequest to accept Danish and English language using 'Add' method")
        
    'Add the Accept-Language header (for Danish) in the request.
        myWebHeaderCollection.Add("Accept-Language:da")
        
        'Include English in the Accept-Langauge header. 
        myWebHeaderCollection.Add("Accept-Language","en;q" + ChrW(61) + "0.8")
        
        'Get the associated response for the above request.
        Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
        
        'Print the headers for the request.
        printHeaders(myWebHeaderCollection)
        myHttpWebResponse.Close()
    'Catch exception if trying to add a restricted header.
    Catch e As ArgumentException
        Console.WriteLine(e.Message)
    Catch e As WebException
        Console.WriteLine(e.Message)
        If e.Status = WebExceptionStatus.ProtocolError Then
            Console.WriteLine("Status Code : {0}", CType(e.Response, HttpWebResponse).StatusCode)
            Console.WriteLine("Status Description : {0}", CType(e.Response, HttpWebResponse).StatusDescription)
            Console.WriteLine("Server : {0}", CType(e.Response, HttpWebResponse).Server)
        End If
    Catch e As Exception
        Console.WriteLine(e.Message)
    End Try
End Sub

Nota

La longitud de la parte de valor de header, es decir, la cadena después de los dos puntos (:), solo se valida en .NET Framework y .NET Core versiones 2.0 - 3.1.

En todas las versiones de .NET Framework aplicables: una WebHeaderCollection instancia devuelta por la Headers propiedad producirá una ArgumentOutOfRangeException si la longitud de la parte de valor de header es mayor que 65535. Todas las demás WebHeaderCollection instancias aceptan un valor de cualquier longitud.
En las versiones de .NET Core a la versión 3.1: una WebHeaderCollection instancia usada con cualquier encabezado de tipo HttpResponseHeader producirá si ArgumentOutOfRangeException la longitud de la parte de valor de header es mayor que 65535. Todas las demás WebHeaderCollection instancias aceptan un valor de cualquier longitud.
En .NET 5 y versiones posteriores: WebHeaderCollection acepta un valor de cualquier longitud.

Comentarios

El header parámetro debe especificarse con el formato "name:value". Si el encabezado especificado no existe en la colección, se agrega un nuevo encabezado a la colección.

Si el encabezado especificado en header ya está presente en la colección, la parte de valor de header se concatena con el valor existente.

Se aplica a

Add(HttpRequestHeader, String)

Source:: WebHeaderCollection.cs

Source:: WebHeaderCollection.cs

Source:: WebHeaderCollection.cs

Inserta el encabezado especificado con el valor especificado en la colección.

public:
 void Add(System::Net::HttpRequestHeader header, System::String ^ value);

public void Add (System.Net.HttpRequestHeader header, string? value);

public void Add (System.Net.HttpRequestHeader header, string value);

override this.Add : System.Net.HttpRequestHeader * string -> unit

Public Sub Add (header As HttpRequestHeader, value As String)

Parámetros

header: HttpRequestHeader

Encabezado que se agrega a la colección.

value: String

El contenido del encabezado.

Excepciones

ArgumentOutOfRangeException

.NET Framework y versiones 2.0-3.1 de .NET Core únicamente: la longitud de value es mayor de 65 535.

InvalidOperationException

Esta instancia de WebHeaderCollection no permite instancias de HttpRequestHeader.

Comentarios

Si el encabezado especificado no existe, el Add método inserta un nuevo encabezado en la lista de pares nombre-valor de encabezado.

Si el encabezado especificado ya está presente, value se agrega a la lista separada por comas de valores asociados al encabezado.

Nota

La longitud de value solo se valida en .NET Framework y .NET Core versiones 2.0 - 3.1.

En todas las versiones de .NET Framework aplicables: una WebHeaderCollection instancia devuelta por la Headers propiedad producirá una ArgumentOutOfRangeException excepción si la longitud de value es mayor que 65535. Todas las demás WebHeaderCollection instancias aceptan una value longitud de cualquier longitud.
En las versiones de .NET Core a través de la versión 3.1: una WebHeaderCollection instancia usada con cualquier encabezado de tipo HttpResponseHeader producirá una ArgumentOutOfRangeException excepción si la longitud de value es mayor que 65535. Todas las demás WebHeaderCollection instancias aceptan una value longitud de cualquier longitud.
En .NET 5 y versiones posteriores: WebHeaderCollection acepta una value longitud de cualquier longitud.

Se aplica a

Add(HttpResponseHeader, String)

Source:: WebHeaderCollection.cs

Source:: WebHeaderCollection.cs

Source:: WebHeaderCollection.cs

Inserta el encabezado especificado con el valor especificado en la colección.

public:
 void Add(System::Net::HttpResponseHeader header, System::String ^ value);

public void Add (System.Net.HttpResponseHeader header, string? value);

public void Add (System.Net.HttpResponseHeader header, string value);

override this.Add : System.Net.HttpResponseHeader * string -> unit

Public Sub Add (header As HttpResponseHeader, value As String)

Parámetros

header: HttpResponseHeader

Encabezado que se agrega a la colección.

value: String

El contenido del encabezado.

Excepciones

ArgumentOutOfRangeException

.NET Framework y versiones 2.0-3.1 de .NET Core únicamente: la longitud de value es mayor de 65 535.

InvalidOperationException

Esta instancia de WebHeaderCollection no permite instancias de HttpResponseHeader.

Comentarios

Si el encabezado especificado no existe, el Add método inserta un nuevo encabezado en la lista de pares nombre-valor de encabezado.

Si el encabezado especificado ya está presente, value se agrega a la lista separada por comas de valores asociados al encabezado.

Nota

La longitud de value solo se valida en .NET Framework y .NET Core versiones 2.0 - 3.1.

En todas las versiones de .NET Framework aplicables: una WebHeaderCollection instancia devuelta por la Headers propiedad producirá una ArgumentOutOfRangeException excepción si la longitud de value es mayor que 65535. Todas las demás WebHeaderCollection instancias aceptan una value longitud de cualquier longitud.
En las versiones de .NET Core a través de la versión 3.1: una WebHeaderCollection instancia usada con cualquier encabezado de tipo HttpResponseHeader producirá una ArgumentOutOfRangeException excepción si la longitud de value es mayor que 65535. Todas las demás WebHeaderCollection instancias aceptan una value longitud de cualquier longitud.
En .NET 5 y versiones posteriores: WebHeaderCollection acepta una value longitud de cualquier longitud.

Se aplica a

Add(String, String)

Source:: WebHeaderCollection.cs

Source:: WebHeaderCollection.cs

Source:: WebHeaderCollection.cs

Inserta en la colección un encabezado con el nombre y valor especificados.

public:
 override void Add(System::String ^ name, System::String ^ value);

public override void Add (string name, string? value);

public override void Add (string name, string value);

override this.Add : string * string -> unit

Public Overrides Sub Add (name As String, value As String)

Parámetros

name: String

Encabezado que se agrega a la colección.

value: String

El contenido del encabezado.

Excepciones

ArgumentException

name es null, Empty o contiene caracteres no válidos.

o bien

name es un encabezado restringido que debe establecerse con un valor de propiedad.

o bien

value contiene caracteres no válidos.

ArgumentOutOfRangeException

.NET Framework y versiones 2.0-3.1 de .NET Core únicamente: la longitud de value es mayor de 65 535.

Ejemplos

En el ejemplo siguiente se agrega un par nombre-valor a mediante WebHeaderCollection el Add método .

try
{
   //Create a web request for S"www.msn.com".
   HttpWebRequest^ myHttpWebRequest = dynamic_cast<HttpWebRequest^>(WebRequest::Create( "http://www.msn.com" ));

   //Get the headers associated with the request.
   WebHeaderCollection^ myWebHeaderCollection = myHttpWebRequest->Headers;
   Console::WriteLine( "Configuring Webrequest to accept Danish and English language using 'Add' method" );

   //Add the Accept-Language header (for Danish) in the request.
   myWebHeaderCollection->Add( "Accept-Language:da" );

   //Include English in the Accept-Langauge header.
   myWebHeaderCollection->Add( "Accept-Language:en;q=0.8" );

   //Get the associated response for the above request.
   HttpWebResponse^ myHttpWebResponse = dynamic_cast<HttpWebResponse^>(myHttpWebRequest->GetResponse());

   //Print the headers for the request.
   printHeaders( myWebHeaderCollection );
   myHttpWebResponse->Close();
}
//Catch exception if trying to add a restricted header.
catch ( ArgumentException^ e ) 
{
   Console::WriteLine( e->Message );
}
catch ( WebException^ e ) 
{
   Console::WriteLine( "\nWebException is thrown. \nMessage is : {0}", e->Message );
   if ( e->Status == WebExceptionStatus::ProtocolError )
   {
      Console::WriteLine( "Status Code : {0}", (dynamic_cast<HttpWebResponse^>(e->Response))->StatusCode );
      Console::WriteLine( "Status Description : {0}", (dynamic_cast<HttpWebResponse^>(e->Response))->StatusDescription );
      Console::WriteLine( "Server : {0}", (dynamic_cast<HttpWebResponse^>(e->Response))->Server );
   }
}
catch ( Exception^ e ) 
{
   Console::WriteLine( "Exception is thrown. Message is : {0}", e->Message );
}

try {
    //Create a web request for "www.msn.com".
    HttpWebRequest myHttpWebRequest = (HttpWebRequest) WebRequest.Create("http://www.msn.com");

    //Get the headers associated with the request.
    WebHeaderCollection myWebHeaderCollection = myHttpWebRequest.Headers;

    Console.WriteLine("Configuring Webrequest to accept Danish and English language using 'Add' method");

    //Add the Accept-Language header (for Danish) in the request.
    myWebHeaderCollection.Add("Accept-Language:da");

    //Include English in the Accept-Langauge header. 
    myWebHeaderCollection.Add("Accept-Language","en;q=0.8");

    //Get the associated response for the above request.
    HttpWebResponse myHttpWebResponse = (HttpWebResponse) myHttpWebRequest.GetResponse();

    //Print the headers for the request.
    printHeaders(myWebHeaderCollection);
    myHttpWebResponse.Close();
}
//Catch exception if trying to add a restricted header.
catch(ArgumentException e) {
    Console.WriteLine(e.Message);
}
catch(WebException e) {
    Console.WriteLine("\nWebException is thrown. \nMessage is :" + e.Message);
    if(e.Status == WebExceptionStatus.ProtocolError) {
        Console.WriteLine("Status Code : {0}", ((HttpWebResponse)e.Response).StatusCode);
        Console.WriteLine("Status Description : {0}", ((HttpWebResponse)e.Response).StatusDescription);
        Console.WriteLine("Server : {0}", ((HttpWebResponse)e.Response).Server);
    }
}
catch(Exception e) {
    Console.WriteLine("Exception is thrown. Message is :" + e.Message);
}

Public Shared Sub Main()

 Try
        'Create a web request for "www.msn.com".
        Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create("http://www.msn.com"), HttpWebRequest)
        
        'Get the headers associated with the request.
        Dim myWebHeaderCollection As WebHeaderCollection = myHttpWebRequest.Headers
        
    Console.WriteLine("Configuring Webrequest to accept Danish and English language using 'Add' method")
        
    'Add the Accept-Language header (for Danish) in the request.
        myWebHeaderCollection.Add("Accept-Language:da")
        
        'Include English in the Accept-Langauge header. 
        myWebHeaderCollection.Add("Accept-Language","en;q" + ChrW(61) + "0.8")
        
        'Get the associated response for the above request.
        Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
        
        'Print the headers for the request.
        printHeaders(myWebHeaderCollection)
        myHttpWebResponse.Close()
    'Catch exception if trying to add a restricted header.
    Catch e As ArgumentException
        Console.WriteLine(e.Message)
    Catch e As WebException
        Console.WriteLine(e.Message)
        If e.Status = WebExceptionStatus.ProtocolError Then
            Console.WriteLine("Status Code : {0}", CType(e.Response, HttpWebResponse).StatusCode)
            Console.WriteLine("Status Description : {0}", CType(e.Response, HttpWebResponse).StatusDescription)
            Console.WriteLine("Server : {0}", CType(e.Response, HttpWebResponse).Server)
        End If
    Catch e As Exception
        Console.WriteLine(e.Message)
    End Try
End Sub

Nota

La longitud de value solo se valida en .NET Framework y .NET Core versiones 2.0 - 3.1.

En todas las versiones de .NET Framework aplicables: una WebHeaderCollection instancia devuelta por la Headers propiedad producirá una ArgumentOutOfRangeException excepción si la longitud de value es mayor que 65535. Todas las demás WebHeaderCollection instancias aceptan una value longitud de cualquier longitud.
En las versiones de .NET Core a través de la versión 3.1: una WebHeaderCollection instancia usada con cualquier encabezado de tipo HttpResponseHeader producirá una ArgumentOutOfRangeException excepción si la longitud de value es mayor que 65535. Todas las demás WebHeaderCollection instancias aceptan una value longitud de cualquier longitud.
En .NET 5 y versiones posteriores: WebHeaderCollection acepta una value longitud de cualquier longitud.

Comentarios

Si el encabezado especificado en name no existe, el Add método inserta un nuevo encabezado en la lista de pares nombre-valor de encabezado.

Si el encabezado especificado en name ya está presente, value se agrega a la lista de valores separados por comas existentes asociadas a name.

Se aplica a

WebHeaderCollection.Add Método

Definición

Sobrecargas

Add(String)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

Add(HttpRequestHeader, String)

Parámetros

Excepciones

Comentarios

Se aplica a

Add(HttpResponseHeader, String)

Parámetros

Excepciones

Comentarios

Se aplica a

Add(String, String)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

Comentarios

Recursos adicionales