WebHeaderCollection.Add Metode

Referensi

Definisi

Ruang nama:: System.Net

Rakitan:: System.Net.WebHeaderCollection.dll

Rakitan:: System.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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

ArgumentNullException

header adalah null atau Empty.

ArgumentException

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.

ArgumentOutOfRangeException

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

Pada semua versi .NET Framework yang berlaku: WebHeaderCollection Instans yang dikembalikan oleh Headers properti akan menampilkan ArgumentOutOfRangeException jika panjang bagian headernilai lebih besar dari 65535. Semua instans lain WebHeaderCollection menerima nilai dengan panjang berapa pun.
Pada versi .NET Core melalui versi 3.1: Instans yang WebHeaderCollection digunakan dengan header jenis HttpResponseHeader apa pun akan melemparkan ArgumentOutOfRangeException jika panjang bagian headernilai lebih besar dari 65535. Semua instans lain WebHeaderCollection menerima nilai dengan panjang berapa pun.
Pada .NET 5 dan versi yang lebih baru: WebHeaderCollection menerima nilai dengan panjang berapa pun.

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

ArgumentOutOfRangeException

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

InvalidOperationException

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.

Pada semua versi .NET Framework yang berlaku: WebHeaderCollection Instans yang dikembalikan oleh Headers properti akan menampilkan ArgumentOutOfRangeException jika panjangnya value lebih besar dari 65535. Semua instans lain WebHeaderCollection menerima value panjang apa pun.
Pada versi .NET Core melalui versi 3.1: Instans yang WebHeaderCollection digunakan dengan header jenis HttpResponseHeader apa pun akan melempar ArgumentOutOfRangeException jika panjangnya value lebih besar dari 65535. Semua instans lain WebHeaderCollection menerima value panjang apa pun.
Pada .NET 5 dan versi yang lebih baru: WebHeaderCollection menerima value panjang apa pun.

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

ArgumentOutOfRangeException

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

InvalidOperationException

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.

Pada semua versi .NET Framework yang berlaku: WebHeaderCollection Instans yang dikembalikan oleh Headers properti akan menampilkan ArgumentOutOfRangeException jika panjangnya value lebih besar dari 65535. Semua instans lain WebHeaderCollection menerima value panjang apa pun.
Pada versi .NET Core melalui versi 3.1: Instans yang WebHeaderCollection digunakan dengan header jenis HttpResponseHeader apa pun akan melempar ArgumentOutOfRangeException jika panjangnya value lebih besar dari 65535. Semua instans lain WebHeaderCollection menerima value panjang apa pun.
Pada .NET 5 dan versi yang lebih baru: WebHeaderCollection menerima value panjang apa pun.

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

ArgumentException

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.

ArgumentOutOfRangeException

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

Pada semua versi .NET Framework yang berlaku: WebHeaderCollection Instans yang dikembalikan oleh Headers properti akan menampilkan ArgumentOutOfRangeException jika panjangnya value lebih besar dari 65535. Semua instans lain WebHeaderCollection menerima value panjang apa pun.
Pada versi .NET Core melalui versi 3.1: Instans yang WebHeaderCollection digunakan dengan header jenis HttpResponseHeader apa pun akan melempar ArgumentOutOfRangeException jika panjangnya value lebih besar dari 65535. Semua instans lain WebHeaderCollection menerima value panjang apa pun.
Pada .NET 5 dan versi yang lebih baru: WebHeaderCollection menerima value panjang apa pun.

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

Bagikan melalui

WebHeaderCollection.Add Metode

Definisi

Overload

Add(String)

Parameter

Pengecualian

Contoh

Keterangan

Berlaku untuk

Add(HttpRequestHeader, String)

Parameter

Pengecualian

Keterangan

Berlaku untuk

Add(HttpResponseHeader, String)

Parameter

Pengecualian

Keterangan

Berlaku untuk

Add(String, String)

Parameter

Pengecualian

Contoh

Keterangan

Berlaku untuk

Sumber Daya Tambahan: