HttpServerUtility Класс

Определение

Предоставляет вспомогательные методы для обработки веб-запросов.

public ref class HttpServerUtility sealed
public sealed class HttpServerUtility
type HttpServerUtility = class
Public NotInheritable Class HttpServerUtility
Наследование
HttpServerUtility

Примеры

Проект веб-сайта Visual Studio с исходным кодом доступен для сопровождения этого раздела: скачивание.

В следующем примере показано, как использовать HtmlEncode метод и UrlEncode метод HttpServerUtility класса. Этот HtmlEncode метод помогает убедиться, что любые введенные пользователем строковые данные будут отображаться в виде статического текста в браузерах, а не исполняемых скриптов или HTML-элементов. Метод UrlEncode кодирует URL-адреса таким образом, чтобы они правильно передавались в HTTP-потоке.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void Button1_Click(object sender, EventArgs e)
    {
        if (!String.IsNullOrEmpty(TextBox1.Text))
        {
            // Access the HttpServerUtility methods through
            // the intrinsic Server object.
            Label1.Text = "Welcome, " +
                Server.HtmlEncode(TextBox1.Text) +
                ".<br/> The url is " + 
                Server.UrlEncode(Request.Url.ToString());
        }
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpServerUtility Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        Enter your name:<br />

        <asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
        <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="Submit" />
        <br />
        <asp:Label ID="Label1" runat="server"/>
        </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    Protected Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)

        If (Not String.IsNullOrEmpty(TextBox1.Text)) Then
            
            ' Access the HttpServerUtility methods through
            ' the intrinsic Server object.
            Label1.Text = "Welcome, " & _
                Server.HtmlEncode(TextBox1.Text) & _
                ".<br/> The url is " & _
                Server.UrlEncode(Request.Url.ToString())
        End If
        
        
        
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>HttpServerUtility Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        Enter your name:<br />

        <asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
        <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="Submit" />
        <br />
        <asp:Label ID="Label1" runat="server"/>
        </div>
    </form>
</body>
</html>

Комментарии

Методы и свойства HttpServerUtility класса предоставляются через встроенный Server объект, предоставляемый ASP.NET.

Свойства

MachineName

Получает имя компьютера сервера.

ScriptTimeout

Получает или задает значение времени ожидания запроса в секундах.

Методы

ClearError()

Удаляет предыдущее исключение.

CreateObject(String)

Создает на сервере экземпляр объекта СОМ, заданный программным идентификатором объектов (ProgID).

CreateObject(Type)

Создает на сервере экземпляр объекта СОМ, заданный с помощью типа объекта.

CreateObjectFromClsid(String)

Создает на сервере экземпляр объекта СОМ, заданный идентификатором класса объектов (CLSID).

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
Execute(IHttpHandler, TextWriter, Boolean)

Выполняет действия обработчика для заданного виртуального пути в контексте текущего запроса. TextWriter перенаправляет выходные данные от выполненного обработчика, а логический параметр указывает, необходимо ли очищать коллекции QueryString и Form.

Execute(String)

Выполняет действия обработчика для заданного виртуального пути в контексте текущего запроса.

Execute(String, Boolean)

Выполняет действия обработчика для заданного виртуального пути в контексте текущего запроса и указывает, необходимо ли очистить коллекции QueryString и Form.

Execute(String, TextWriter)

Выполняет действия обработчика для заданного виртуального пути в контексте текущего запроса. TextWriter перенаправляет выходные данные выполненного обработчика.

Execute(String, TextWriter, Boolean)

Выполняет действия обработчика для заданного виртуального пути в контексте текущего запроса. TextWriter перенаправляет выходные данные со страницы, а логический параметр указывает, необходимо ли очищать коллекции QueryString и Form.

GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetLastError()

Возвращает предыдущее исключение.

GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
HtmlDecode(String)

Декодирует строку в кодировке HTML с последующим возвращением.

HtmlDecode(String, TextWriter)

Декодирует строку в кодировке HTML и отправляет конечные выходные данные в поток выходных данных TextWriter.

HtmlEncode(String)

Кодирует строку в формате HTML и возвращает закодированную строку.

HtmlEncode(String, TextWriter)

Кодирует строку в формате HTML и отправляет результирующие выходные данные в поток вывода TextWriter.

MapPath(String)

Возвращает физический путь к файлу, соответствующий указанному виртуальному пути.

MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)
Transfer(IHttpHandler, Boolean)

Прекращает выполнение текущей страницы и начинает выполнение новой страницы при помощи пользовательского обработчика HTTP-данных, который содержит реализацию интерфейса IHttpHandler, и указывает, необходимо ли очистить коллекции QueryString и Form.

Transfer(String)

Для текущего запроса прекращает выполнение текущей страницы и начинает выполнение новой страницы с помощью заданного URL-пути к странице.

Transfer(String, Boolean)

Прекращает выполнение текущей страницы и начинает выполнение новой страницы с помощью заданного URL-пути к странице. Указывает, необходимо ли очистить коллекции QueryString и Form.

TransferRequest(String)

Выполняет асинхронное выполнение заданного URL-адреса.

TransferRequest(String, Boolean)

Выполняет асинхронное выполнение заданного URL-адреса и сохраняет параметры строки запросов.

TransferRequest(String, Boolean, String, NameValueCollection)

Выполняет асинхронное выполнение заданного URL-адреса с использованием указанного метода и заголовков HTTP.

TransferRequest(String, Boolean, String, NameValueCollection, Boolean)

Выполняет асинхронно заданный URL-адрес, используя указанный метод HTTP, заголовки и путь, а также, при необходимости, сохраняет значения формы и удостоверение пользователя.

UrlDecode(String)

Расшифровывает строку в кодировке URL с последующим возвращением.

UrlDecode(String, TextWriter)

Декодирует строку HTML, полученную с кодировкой URL, и отправляет конечные выходные данные в поток выходных данных TextWriter.

UrlEncode(String)

Кодирует строку в кодировке URL и возвращает закодированную строку.

UrlEncode(String, TextWriter)

Кодирует в URL строку и отправляет конечные выходные данные в поток выходных данных TextWriter.

UrlPathEncode(String)

Не использовать; предназначено исключительно для совместимости браузеров. Используйте ключевое слово UrlEncode(String).

UrlTokenDecode(String)

Расшифровывает лексему строки в кодировке URL в эквивалентный массив байтов, используя базовые 64 цифры.

UrlTokenEncode(Byte[])

Кодирует массив байтов в эквивалентное представление строки при помощи 64 знаков, используемых для передачи в кодировке URL.

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

См. также раздел