WebHeaderCollection.IsRestricted Metodo

Definizione

Spazio dei nomi:: System.Net

Assembly:: netstandard.dll, System.Net.WebHeaderCollection.dll

Assembly:: System.Net.WebHeaderCollection.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Verifica se è possibile impostare l'intestazione HTTP specificata.

Overload

Nome	Descrizione
IsRestricted(String)	Verifica se l'intestazione HTTP specificata può essere impostata per la richiesta.
IsRestricted(String, Boolean)	Verifica se l'intestazione HTTP specificata può essere impostata per la richiesta o la risposta.

IsRestricted(String)

Origine:: WebHeaderCollection.cs

Origine:: WebHeaderCollection.cs

Origine:: WebHeaderCollection.cs

Origine:: WebHeaderCollection.cs

Origine:: WebHeaderCollection.cs

Verifica se l'intestazione HTTP specificata può essere impostata per la richiesta.

public:
 static bool IsRestricted(System::String ^ headerName);

public static bool IsRestricted(string headerName);

static member IsRestricted : string -> bool

Public Shared Function IsRestricted (headerName As String) As Boolean

Parametri

headerName: String

Intestazione da testare.

Valori restituiti

Boolean

true se l'intestazione è limitata; in caso contrario false, .

Eccezioni

ArgumentNullException

headerName è null o Empty.

ArgumentException

headerName contiene caratteri non validi.

Esempio

Nell'esempio seguente viene verificata la IsRestricted proprietà per verificare se è vietato impostare intestazioni.

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

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

        // Get the headers associated with the response.
        WebHeaderCollection myWebHeaderCollection = myHttpWebResponse.Headers;
        
        for (int i = 0; i < myWebHeaderCollection.Count;i++)	
        {
        // Check if the first response header is restricted.
        if(WebHeaderCollection.IsRestricted(myWebHeaderCollection.AllKeys[i]))
            Console.WriteLine("'{0}' is a restricted header", myWebHeaderCollection.AllKeys[i]);
        else
            Console.WriteLine("'{0}' is not a restricted header", myWebHeaderCollection.AllKeys[i]);
        }
        myHttpWebResponse.Close();
    }
    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 associated response for the above request.
        Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
        
        'Get the headers associated with the response.
        Dim myWebHeaderCollection As WebHeaderCollection = myHttpWebResponse.Headers
        
        'Check if the first response header is restricted.
    dim i as integer
    for i =0 to myWebHeaderCollection.Count-1
            If WebHeaderCollection.IsRestricted(myWebHeaderCollection.AllKeys(i)) Then
                Console.WriteLine("'{0}' is a restricted header", myWebHeaderCollection.AllKeys(i))
            Else
                Console.WriteLine("'{0}' is not a restricted header", myWebHeaderCollection.AllKeys(i))
            End If 
    next
    myHttpWebResponse.Close()
    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

Commenti

Il IsRestricted metodo restituisce true per indicare che un'intestazione è limitata e deve essere impostata utilizzando proprietà anziché direttamente o impostata dal sistema. Le intestazioni con restrizioni sono:

Accettare
Connection
La lunghezza del contenuto
Content-Type
Date
Aspettare
Host
If-Modified-Since
Intervallo
Referente
Transfer-Encoding
User-Agent
Proxy-Connection

Si applica a

IsRestricted(String, Boolean)

Origine:: WebHeaderCollection.cs

Origine:: WebHeaderCollection.cs

Origine:: WebHeaderCollection.cs

Origine:: WebHeaderCollection.cs

Origine:: WebHeaderCollection.cs

Verifica se l'intestazione HTTP specificata può essere impostata per la richiesta o la risposta.

public:
 static bool IsRestricted(System::String ^ headerName, bool response);

public static bool IsRestricted(string headerName, bool response);

static member IsRestricted : string * bool -> bool

Public Shared Function IsRestricted (headerName As String, response As Boolean) As Boolean

Parametri

headerName: String

Intestazione da testare.

response: Boolean

true per testare la risposta; false per testare la richiesta.

Valori restituiti

Boolean

true se l'intestazione è limitata; in caso contrario, false.

Eccezioni

ArgumentNullException

headerName è null o Empty.

ArgumentException

headerName contiene caratteri non validi.

Esempio

Nell'esempio seguente viene verificata la IsRestricted proprietà per verificare se le intestazioni di richiesta non sono consentite.

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

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

        // Get the headers associated with the response.
        WebHeaderCollection myWebHeaderCollection = myHttpWebResponse.Headers;
        
        for (int i = 0; i < myWebHeaderCollection.Count;i++)	
        {
        // Check if the first response header is restricted.
        if(WebHeaderCollection.IsRestricted(myWebHeaderCollection.AllKeys[i]))
            Console.WriteLine("'{0}' is a restricted header", myWebHeaderCollection.AllKeys[i]);
        else
            Console.WriteLine("'{0}' is not a restricted header", myWebHeaderCollection.AllKeys[i]);
        }
        myHttpWebResponse.Close();
    }
    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 associated response for the above request.
        Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
        
        'Get the headers associated with the response.
        Dim myWebHeaderCollection As WebHeaderCollection = myHttpWebResponse.Headers
        
        'Check if the first response header is restricted.
    dim i as integer
    for i =0 to myWebHeaderCollection.Count-1
            If WebHeaderCollection.IsRestricted(myWebHeaderCollection.AllKeys(i)) Then
                Console.WriteLine("'{0}' is a restricted header", myWebHeaderCollection.AllKeys(i))
            Else
                Console.WriteLine("'{0}' is not a restricted header", myWebHeaderCollection.AllKeys(i))
            End If 
    next
    myHttpWebResponse.Close()
    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

Commenti

Il IsRestricted metodo restituisce true per indicare che un'intestazione di richiesta o risposta è limitata e deve essere impostata utilizzando proprietà anziché direttamente o impostata dal sistema. Le intestazioni con restrizioni sono:

Accettare
Connection
La lunghezza del contenuto
Content-Type
Date
Aspettare
Host
If-Modified-Since
Intervallo
Referente
Transfer-Encoding
User-Agent
Proxy-Connection

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?