Bagikan melalui


WebHeaderCollection.Add Metode

Definisi

Sisipkan header baru ke dalam koleksi.

Overload

Add(String)

Sisipkan header yang ditentukan ke dalam koleksi.

Add(HttpRequestHeader, String)

Menyisipkan header yang ditentukan dengan nilai yang ditentukan ke dalam koleksi.

Add(HttpResponseHeader, String)

Menyisipkan header yang ditentukan dengan nilai yang ditentukan ke dalam koleksi.

Add(String, String)

Menyisipkan header dengan nama dan nilai yang ditentukan ke dalam koleksi.

Add(String)

Sumber:
WebHeaderCollection.cs
Sumber:
WebHeaderCollection.cs
Sumber:
WebHeaderCollection.cs

Sisipkan header yang ditentukan ke dalam koleksi.

public:
 void Add(System::String ^ header);
public void Add (string header);
override this.Add : string -> unit
Public Sub Add (header As String)

Parameter

header
String

Header yang akan ditambahkan, dengan nama dan nilai dipisahkan oleh titik dua.

Pengecualian

header adalah null atau Empty.

header tidak berisi titik dua (karakter :).

Panjangnya value lebih besar dari 65535.

-atau-

Bagian nama dari header adalah Empty atau berisi karakter yang tidak valid.

-atau-

header adalah header terbatas yang harus diatur dengan properti .

-atau-

Bagian nilai dari header berisi karakter yang tidak valid.

.NET Framework dan .NET Core versi 2.0 - 3.1 saja: Panjang string setelah titik dua (:) lebih besar dari 65535.

Contoh

Contoh berikut menambahkan pasangan nama/nilai ke WebHeaderCollection menggunakan Add Metode .

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

Catatan

Panjang bagian nilai , headeryaitu, string setelah titik dua (:), hanya divalidasi dalam .NET Framework dan .NET Core versi 2.0 - 3.1.

Keterangan

Parameter header harus ditentukan dalam format "name:value". Jika header yang ditentukan tidak ada dalam koleksi, header baru ditambahkan ke koleksi.

Jika header yang ditentukan di header sudah ada dalam koleksi, bagian nilai dari header digabungkan dengan nilai yang ada.

Berlaku untuk

Add(HttpRequestHeader, String)

Sumber:
WebHeaderCollection.cs
Sumber:
WebHeaderCollection.cs
Sumber:
WebHeaderCollection.cs

Menyisipkan header yang ditentukan dengan nilai yang ditentukan ke dalam koleksi.

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)

Parameter

header
HttpRequestHeader

Header untuk ditambahkan ke koleksi.

value
String

Konten header.

Pengecualian

.NET Framework dan .NET Core versi 2.0 - 3.1 saja: Panjangnya value lebih besar dari 65535.

Instans ini WebHeaderCollection tidak mengizinkan instans HttpRequestHeader.

Keterangan

Jika header yang ditentukan tidak ada, Add metode menyisipkan header baru ke dalam daftar pasangan nama/nilai header.

Jika header yang ditentukan sudah ada, value ditambahkan ke daftar nilai yang dipisahkan koma yang terkait dengan header.

Catatan

Panjang value hanya divalidasi dalam .NET Framework dan .NET Core versi 2.0 - 3.1.

Berlaku untuk

Add(HttpResponseHeader, String)

Sumber:
WebHeaderCollection.cs
Sumber:
WebHeaderCollection.cs
Sumber:
WebHeaderCollection.cs

Menyisipkan header yang ditentukan dengan nilai yang ditentukan ke dalam koleksi.

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)

Parameter

header
HttpResponseHeader

Header untuk ditambahkan ke koleksi.

value
String

Konten header.

Pengecualian

.NET Framework dan .NET Core versi 2.0 - 3.1 saja: Panjangnya value lebih besar dari 65535.

Instans ini WebHeaderCollection tidak mengizinkan instans HttpResponseHeader.

Keterangan

Jika header yang ditentukan tidak ada, Add metode menyisipkan header baru ke dalam daftar pasangan nama/nilai header.

Jika header yang ditentukan sudah ada, value ditambahkan ke daftar nilai yang dipisahkan koma yang terkait dengan header.

Catatan

Panjang value hanya divalidasi dalam .NET Framework dan .NET Core versi 2.0 - 3.1.

Berlaku untuk

Add(String, String)

Sumber:
WebHeaderCollection.cs
Sumber:
WebHeaderCollection.cs
Sumber:
WebHeaderCollection.cs

Menyisipkan header dengan nama dan nilai yang ditentukan ke dalam koleksi.

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)

Parameter

name
String

Header untuk ditambahkan ke koleksi.

value
String

Konten header.

Pengecualian

name adalah null, Empty, atau berisi karakter yang tidak valid.

-atau-

name adalah header terbatas yang harus diatur dengan pengaturan properti.

-atau-

value berisi karakter yang tidak valid.

.NET Framework dan .NET Core versi 2.0 - 3.1 saja: Panjangnya value lebih besar dari 65535.

Contoh

Contoh berikut menambahkan pasangan nama/nilai ke WebHeaderCollection menggunakan Add Metode .

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

Catatan

Panjang value hanya divalidasi dalam .NET Framework dan .NET Core versi 2.0 - 3.1.

Keterangan

Jika header yang ditentukan di name tidak ada, Add metode menyisipkan header baru ke dalam daftar pasangan nama/nilai header.

Jika header yang ditentukan di name sudah ada, value ditambahkan ke daftar nilai yang dipisahkan koma yang ada yang terkait dengan name.

Berlaku untuk