Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo WebHeaderCollection.Add (String)

 

Data di pubblicazione: ottobre 2016

Inserisce nella raccolta l'intestazione specificata.

Spazio dei nomi:   System.Net
Assembly:  System (in System.dll)

public void Add(
	string header
)

Parametri

header
Type: System.String

L'intestazione da aggiungere, con il nome e il valore separati dal carattere dei due punti (:).

Exception Condition
ArgumentNullException

header è null o Empty.

ArgumentException

header non contiene un carattere due punti (:).

La lunghezza di value è maggiore di 65535.

-oppure-

La parte del nome header è Empty o contiene caratteri non validi.

-oppure-

header è un'intestazione con restrizioni che deve essere impostata con una proprietà.

-oppure-

Parte del valore header contiene caratteri non validi.

ArgumentOutOfRangeException

La lunghezza della stringa dopo i due punti (:) è maggiore di 65535.

Il header parametro deve essere specificato nel formato "nome: valore". Se l'intestazione specificata non esiste nella raccolta, una nuova intestazione viene aggiunto alla raccolta.

Se l'intestazione specificata header è già presente nella raccolta, parte del valore di header viene concatenata con il valore esistente.

Nell'esempio seguente aggiunge una coppia nome/valore a un WebHeaderCollection utilizzando il Add metodo.

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);
}

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: