WebHeaderCollection.Add Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Net

Zestaw:: System.Net.WebHeaderCollection.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wstawia nowy nagłówek do kolekcji.

Przeciążenia

Add(String)	Wstawia określony nagłówek do kolekcji.
Add(HttpRequestHeader, String)	Wstawia określony nagłówek z określoną wartością do kolekcji.
Add(HttpResponseHeader, String)	Wstawia określony nagłówek z określoną wartością do kolekcji.
Add(String, String)	Wstawia nagłówek o określonej nazwie i wartości do kolekcji.

Add(String)

Źródło:: WebHeaderCollection.cs

Źródło:: WebHeaderCollection.cs

Źródło:: WebHeaderCollection.cs

Wstawia określony nagłówek do kolekcji.

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

public void Add (string header);

override this.Add : string -> unit

Public Sub Add (header As String)

Parametry

header: String

Nagłówek do dodania z nazwą i wartością rozdzielaną dwukropkiem.

Wyjątki

ArgumentNullException

header to null lub Empty.

ArgumentException

header nie zawiera dwukropka (znak :).

Długość value jest większa niż 65535.

-lub-

Część nazwy elementu header jest Empty lub zawiera nieprawidłowe znaki.

-lub-

header jest nagłówkiem z ograniczeniami, który należy ustawić z właściwością.

-lub-

Część wartości zawiera header nieprawidłowe znaki.

ArgumentOutOfRangeException

Tylko programy .NET Framework i .NET Core w wersji 2.0 – 3.1: długość ciągu po dwukropku (:) jest większa niż 65535.

Przykłady

Poniższy przykład dodaje parę nazwa/wartość do klasy WebHeaderCollection przy użyciu Add metody .

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

Uwaga

Długość części headerwartości , czyli ciąg po dwukropku (:), jest weryfikowany tylko w programach .NET Framework i .NET Core w wersji 2.0 –3.1.

We wszystkich odpowiednich wersjach programu .NET Framework: WebHeaderCollection wystąpienie zwrócone przez Headers właściwość zgłosi, ArgumentOutOfRangeException jeśli długość części headerwartości jest większa niż 65535. Wszystkie inne WebHeaderCollection wystąpienia akceptują wartość dowolnej długości.
Na platformie .NET Core w wersji 3.1: WebHeaderCollection wystąpienie używane z dowolnym nagłówkiem typu HttpResponseHeader zgłosi, ArgumentOutOfRangeException jeśli długość części headerwartości jest większa niż 65535. Wszystkie inne WebHeaderCollection wystąpienia akceptują wartość dowolnej długości.
Na platformie .NET 5 i nowszych wersjach: WebHeaderCollection akceptuje wartość dowolnej długości.

Uwagi

Parametr header musi być określony w formacie "name:value". Jeśli określony nagłówek nie istnieje w kolekcji, do kolekcji zostanie dodany nowy nagłówek.

Jeśli nagłówek określony w header pliku jest już obecny w kolekcji, część header wartości jest połączona z istniejącą wartością.

Dotyczy

Add(HttpRequestHeader, String)

Źródło:: WebHeaderCollection.cs

Źródło:: WebHeaderCollection.cs

Źródło:: WebHeaderCollection.cs

Wstawia określony nagłówek z określoną wartością do kolekcji.

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)

Parametry

header: HttpRequestHeader

Nagłówek do dodania do kolekcji.

value: String

Zawartość nagłówka.

Wyjątki

ArgumentOutOfRangeException

Tylko programy .NET Framework i .NET Core w wersji 2.0 – 3.1: długość value programu jest większa niż 65535.

InvalidOperationException

To WebHeaderCollection wystąpienie nie zezwala na wystąpienia programu HttpRequestHeader.

Uwagi

Jeśli określony nagłówek nie istnieje, Add metoda wstawia nowy nagłówek do listy par nazwa/wartość nagłówka.

Jeśli określony nagłówek jest już obecny, value zostanie dodany do rozdzielanej przecinkami listy wartości skojarzonych z nagłówkiem.

Uwaga

Długość wartości value jest weryfikowana tylko w programach .NET Framework i .NET Core w wersji 2.0–3.1.

We wszystkich odpowiednich wersjach programu .NET Framework: WebHeaderCollection wystąpienie zwrócone przez Headers właściwość zwróci wartość ArgumentOutOfRangeException , jeśli długość value jest większa niż 65535. Wszystkie inne WebHeaderCollection wystąpienia akceptują dowolną value długość.
Na platformie .NET Core w wersji 3.1: WebHeaderCollection wystąpienie używane z dowolnym nagłówkiem typu HttpResponseHeader zgłosi, ArgumentOutOfRangeException jeśli długość value jest większa niż 65535. Wszystkie inne WebHeaderCollection wystąpienia akceptują dowolną value długość.
Na platformie .NET 5 i nowszych wersjach: WebHeaderCollection akceptuje dowolną value długość.

Dotyczy

Add(HttpResponseHeader, String)

Źródło:: WebHeaderCollection.cs

Źródło:: WebHeaderCollection.cs

Źródło:: WebHeaderCollection.cs

Wstawia określony nagłówek z określoną wartością do kolekcji.

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)

Parametry

header: HttpResponseHeader

Nagłówek do dodania do kolekcji.

value: String

Zawartość nagłówka.

Wyjątki

ArgumentOutOfRangeException

Tylko programy .NET Framework i .NET Core w wersji 2.0 – 3.1: długość value programu jest większa niż 65535.

InvalidOperationException

To WebHeaderCollection wystąpienie nie zezwala na wystąpienia programu HttpResponseHeader.

Uwagi

Jeśli określony nagłówek nie istnieje, Add metoda wstawia nowy nagłówek do listy par nazwa/wartość nagłówka.

Jeśli określony nagłówek jest już obecny, value zostanie dodany do rozdzielanej przecinkami listy wartości skojarzonych z nagłówkiem.

Uwaga

Długość wartości value jest weryfikowana tylko w programach .NET Framework i .NET Core w wersji 2.0–3.1.

We wszystkich odpowiednich wersjach programu .NET Framework: WebHeaderCollection wystąpienie zwrócone przez Headers właściwość zwróci wartość ArgumentOutOfRangeException , jeśli długość value jest większa niż 65535. Wszystkie inne WebHeaderCollection wystąpienia akceptują dowolną value długość.
Na platformie .NET Core w wersji 3.1: WebHeaderCollection wystąpienie używane z dowolnym nagłówkiem typu HttpResponseHeader zgłosi, ArgumentOutOfRangeException jeśli długość value jest większa niż 65535. Wszystkie inne WebHeaderCollection wystąpienia akceptują dowolną value długość.
Na platformie .NET 5 i nowszych wersjach: WebHeaderCollection akceptuje dowolną value długość.

Dotyczy

Add(String, String)

Źródło:: WebHeaderCollection.cs

Źródło:: WebHeaderCollection.cs

Źródło:: WebHeaderCollection.cs

Wstawia nagłówek o określonej nazwie i wartości do kolekcji.

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)

Parametry

name: String

Nagłówek do dodania do kolekcji.

value: String

Zawartość nagłówka.

Wyjątki

ArgumentException

name to null, Emptylub zawiera nieprawidłowe znaki.

-lub-

name jest nagłówkiem z ograniczeniami, który należy ustawić z ustawieniem właściwości.

-lub-

value zawiera nieprawidłowe znaki.

ArgumentOutOfRangeException

Tylko programy .NET Framework i .NET Core w wersji 2.0 – 3.1: długość value programu jest większa niż 65535.

Przykłady

Poniższy przykład dodaje parę nazwa/wartość do klasy WebHeaderCollection przy użyciu Add metody .

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

Uwaga

Długość wartości value jest weryfikowana tylko w programach .NET Framework i .NET Core w wersji 2.0–3.1.

We wszystkich odpowiednich wersjach programu .NET Framework: WebHeaderCollection wystąpienie zwrócone przez Headers właściwość zwróci wartość ArgumentOutOfRangeException , jeśli długość value jest większa niż 65535. Wszystkie inne WebHeaderCollection wystąpienia akceptują dowolną value długość.
Na platformie .NET Core w wersji 3.1: WebHeaderCollection wystąpienie używane z dowolnym nagłówkiem typu HttpResponseHeader zgłosi, ArgumentOutOfRangeException jeśli długość value jest większa niż 65535. Wszystkie inne WebHeaderCollection wystąpienia akceptują dowolną value długość.
Na platformie .NET 5 i nowszych wersjach: WebHeaderCollection akceptuje dowolną value długość.

Uwagi

Jeśli nagłówek określony w name pliku nie istnieje, Add metoda wstawia nowy nagłówek do listy par nazwa/wartość nagłówka.

Jeśli nagłówek określony w pliku name jest już obecny, value zostanie dodany do istniejącej listy wartości rozdzielonych przecinkami skojarzonych z name.

Dotyczy

Udostępnij za pośrednictwem

WebHeaderCollection.Add Metoda

Definicja

Przeciążenia

Add(String)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

Add(HttpRequestHeader, String)

Parametry

Wyjątki

Uwagi

Dotyczy

Add(HttpResponseHeader, String)

Parametry

Wyjątki

Uwagi

Dotyczy

Add(String, String)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

Dodatkowe zasoby