WebHeaderCollection.IsRestricted Метод

Определение

Пространство имен:: System.Net

Сборки:: netstandard.dll, System.Net.WebHeaderCollection.dll

Сборка:: System.Net.WebHeaderCollection.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Проверяет, можно ли задать указанный заголовок HTTP.

Перегрузки

Имя	Описание
IsRestricted(String)	Проверяет, можно ли задать указанный заголовок HTTP для запроса.
IsRestricted(String, Boolean)	Проверяет, можно ли задать указанный заголовок HTTP для запроса или ответа.

IsRestricted(String)

Исходный код:: WebHeaderCollection.cs

Исходный код:: WebHeaderCollection.cs

Исходный код:: WebHeaderCollection.cs

Исходный код:: WebHeaderCollection.cs

Исходный код:: WebHeaderCollection.cs

Проверяет, можно ли задать указанный заголовок HTTP для запроса.

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

Параметры

headerName: String

Заголовок для тестирования.

Возвращаемое значение

Boolean

true Значение , если заголовок ограничен; в противном случае false.

Исключения

ArgumentNullException

headerName is null или Empty.

ArgumentException

headerName содержит недопустимые символы.

Примеры

В следующем примере проверяется IsRestricted , запрещено ли задать какие-либо заголовки.

    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

Метод IsRestricted возвращает true значение, указывающее, что заголовок ограничен и должен быть задан с помощью свойств, а не напрямую или задан системой. Ограниченные заголовки:

Принять
Подключение
Длина содержимого
Тип контента
Дата
Ожидать
Host
If-Modified-Since
Диапазон
Реферер
Transfer-Encoding
User-Agent
Proxy-Connection

Применяется к

IsRestricted(String, Boolean)

Исходный код:: WebHeaderCollection.cs

Исходный код:: WebHeaderCollection.cs

Исходный код:: WebHeaderCollection.cs

Исходный код:: WebHeaderCollection.cs

Исходный код:: WebHeaderCollection.cs

Проверяет, можно ли задать указанный заголовок HTTP для запроса или ответа.

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

Параметры

headerName: String

Заголовок для тестирования.

response: Boolean

true для проверки ответа; false для тестирования запроса.

Возвращаемое значение

Boolean

true Значение , если заголовок ограничен; falseв противном случае .

Исключения

ArgumentNullException

headerName is null или Empty.

ArgumentException

headerName содержит недопустимые символы.

Примеры

В следующем примере проверяется IsRestricted , запрещено ли задавать заголовки запросов.

    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

Метод IsRestricted возвращает true значение, указывающее, что заголовок запроса или ответа ограничен и должен быть задан с помощью свойств, а не напрямую или задан системой. Ограниченные заголовки:

Принять
Подключение
Длина содержимого
Тип контента
Дата
Ожидать
Host
If-Modified-Since
Диапазон
Реферер
Transfer-Encoding
User-Agent
Proxy-Connection

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

WebHeaderCollection.IsRestricted Метод

Определение

Перегрузки

IsRestricted(String)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

Применяется к

IsRestricted(String, Boolean)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

Применяется к