WebHeaderCollection.IsRestricted Methode

Definition

Namespace:: System.Net

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

Assembly:: System.Net.WebHeaderCollection.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Testet, ob der angegebene HTTP-Header festgelegt werden kann.

Überlädt

Name	Beschreibung
IsRestricted(String)	Testet, ob der angegebene HTTP-Header für die Anforderung festgelegt werden kann.
IsRestricted(String, Boolean)	Testet, ob der angegebene HTTP-Header für die Anforderung oder die Antwort festgelegt werden kann.

IsRestricted(String)

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Testet, ob der angegebene HTTP-Header für die Anforderung festgelegt werden kann.

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

Parameter

headerName: String

Der zu testde Header.

Gibt zurück

Boolean

true wenn die Kopfzeile eingeschränkt ist; andernfalls false.

Ausnahmen

ArgumentNullException

headerName ist null oder Empty.

ArgumentException

headerName enthält ungültige Zeichen.

Beispiele

Im folgenden Beispiel wird die IsRestricted Eigenschaft überprüft, um festzustellen, ob Kopfzeilen nicht festgelegt werden dürfen.

    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

Hinweise

Die IsRestricted Methode gibt true zurück, um anzugeben, dass eine Kopfzeile eingeschränkt ist und mithilfe von Eigenschaften anstelle direkt festgelegt oder vom System festgelegt werden muss. Die eingeschränkten Header sind:

Akzeptieren
Verbindung
Inhaltslänge
Content-Type
Date
Erwarten
Host
If-Modified-Since
Bereich
Referer
Transfer-Encoding
User-Agent
Proxy-Connection

Gilt für:

IsRestricted(String, Boolean)

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Testet, ob der angegebene HTTP-Header für die Anforderung oder die Antwort festgelegt werden kann.

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

Parameter

headerName: String

Der zu testde Header.

response: Boolean

true um die Antwort zu testen; false um die Anforderung zu testen.

Gibt zurück

Boolean

truewenn die Kopfzeile eingeschränkt ist; andernfalls . false

Ausnahmen

ArgumentNullException

headerName ist null oder Empty.

ArgumentException

headerName enthält ungültige Zeichen.

Beispiele

Im folgenden Beispiel wird die IsRestricted Eigenschaft überprüft, um festzustellen, ob Anforderungsheader nicht festgelegt werden dürfen.

    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

Hinweise

Die IsRestricted Methode gibt true zurück, um anzugeben, dass ein Anforderungs- oder Antwortheader eingeschränkt ist und mithilfe von Eigenschaften anstelle direkt festgelegt oder vom System festgelegt werden muss. Die eingeschränkten Header sind:

Akzeptieren
Verbindung
Inhaltslänge
Content-Type
Date
Erwarten
Host
If-Modified-Since
Bereich
Referer
Transfer-Encoding
User-Agent
Proxy-Connection

Gilt für:

Feedback

War diese Seite hilfreich?