HttpServerUtility HttpServerUtility HttpServerUtility HttpServerUtility Class

Определение

Предоставляет вспомогательные методы для обработки веб-запросов.Provides helper methods for processing Web requests.

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

Примеры

Для этого раздела доступен проект веб-сайта Visual Studio с исходным кодом: Скачайте.A Visual Studio Web site project with source code is available to accompany this topic: Download.

В следующем примере показано, как использовать HtmlEncode метод UrlEncode и метод HttpServerUtility класса.The following example demonstrates how to use the HtmlEncode method and the UrlEncode method of the HttpServerUtility class. HtmlEncode Метод гарантирует, что любые введенные пользователем строки будут подготавливаться к просмотру как статический текст в браузерах вместо исполняемых скриптов или HTML-элементов.The HtmlEncode method helps ensure that any user-supplied string input will be rendered as static text in browsers instead of executable script or HTML elements. UrlEncode Метод кодирует URL-адреса таким образом, чтобы они правильно передавались в потоке HTTP.The UrlEncode method encodes URLs so that they are correctly transmitted in the HTTP stream.

<%@ 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.The methods and properties of the HttpServerUtility class are exposed through the intrinsic Server object provided by ASP.NET.

Свойства

MachineName MachineName MachineName MachineName

Возвращает имя компьютера сервера.Gets the server's computer name.

ScriptTimeout ScriptTimeout ScriptTimeout ScriptTimeout

Возвращает или задает значение времени ожидания запроса в секундах.Gets or sets the request time-out value in seconds.

Методы

ClearError() ClearError() ClearError() ClearError()

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

CreateObject(String) CreateObject(String) CreateObject(String) CreateObject(String)

Создает на сервере экземпляр объекта СОМ, заданный программным идентификатором объектов (ProgID).Creates a server instance of a COM object identified by the object's programmatic identifier (ProgID).

CreateObject(Type) CreateObject(Type) CreateObject(Type) CreateObject(Type)

Создает на сервере экземпляр объекта СОМ, заданный с помощью типа объекта.Creates a server instance of a COM object identified by the object's type.

CreateObjectFromClsid(String) CreateObjectFromClsid(String) CreateObjectFromClsid(String) CreateObjectFromClsid(String)

Создает на сервере экземпляр объекта СОМ, заданный идентификатором класса объектов (CLSID).Creates a server instance of a COM object identified by the object's class identifier (CLSID).

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Execute(IHttpHandler, TextWriter, Boolean) Execute(IHttpHandler, TextWriter, Boolean) Execute(IHttpHandler, TextWriter, Boolean) Execute(IHttpHandler, TextWriter, Boolean)

Выполняет действия обработчика для заданного виртуального пути в контексте текущего запроса.Executes the handler for the specified virtual path in the context of the current request. TextWriter перенаправляет выходные данные от выполненного обработчика, а логический параметр указывает, необходимо ли очищать коллекции QueryString и Form.A TextWriter captures output from the executed handler and a Boolean parameter specifies whether to clear the QueryString and Form collections.

Execute(String) Execute(String) Execute(String) Execute(String)

Выполняет действия обработчика для заданного виртуального пути в контексте текущего запроса.Executes the handler for the specified virtual path in the context of the current request.

Execute(String, Boolean) Execute(String, Boolean) Execute(String, Boolean) Execute(String, Boolean)

Выполняет действия обработчика для заданного виртуального пути в контексте текущего запроса и указывает, необходимо ли очистить коллекции QueryString и Form.Executes the handler for the specified virtual path in the context of the current request and specifies whether to clear the QueryString and Form collections.

Execute(String, TextWriter) Execute(String, TextWriter) Execute(String, TextWriter) Execute(String, TextWriter)

Выполняет действия обработчика для заданного виртуального пути в контексте текущего запроса.Executes the handler for the specified virtual path in the context of the current request. TextWriter перенаправляет выходные данные выполненного обработчика.A TextWriter captures output from the executed handler.

Execute(String, TextWriter, Boolean) Execute(String, TextWriter, Boolean) Execute(String, TextWriter, Boolean) Execute(String, TextWriter, Boolean)

Выполняет действия обработчика для заданного виртуального пути в контексте текущего запроса.Executes the handler for the specified virtual path in the context of the current request. TextWriter перенаправляет выходные данные со страницы, а логический параметр указывает, необходимо ли очищать коллекции QueryString и Form.A TextWriter captures output from the page and a Boolean parameter specifies whether to clear the QueryString and Form collections.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetLastError() GetLastError() GetLastError() GetLastError()

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

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
HtmlDecode(String) HtmlDecode(String) HtmlDecode(String) HtmlDecode(String)

Декодирует строку в кодировке HTML с последующим возращением.Decodes an HTML-encoded string and returns the decoded string.

HtmlDecode(String, TextWriter) HtmlDecode(String, TextWriter) HtmlDecode(String, TextWriter) HtmlDecode(String, TextWriter)

Декодирует строку в кодировке HTML и отправляет конечные выходные данные в поток выходных данных TextWriter.Decodes an HTML-encoded string and sends the resulting output to a TextWriter output stream.

HtmlEncode(String) HtmlEncode(String) HtmlEncode(String) HtmlEncode(String)

Кодирует строку в формате HTML и возвращает закодированную строку.HTML-encodes a string and returns the encoded string.

HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter)

Кодирует строку в формате HTML и отправляет результирующие выходные данные в поток вывода TextWriter.HTML-encodes a string and sends the resulting output to a TextWriter output stream.

MapPath(String) MapPath(String) MapPath(String) MapPath(String)

Возвращает физический путь к файлу, соответствующий указанному виртуальному пути.Returns the physical file path that corresponds to the specified virtual path.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
Transfer(IHttpHandler, Boolean) Transfer(IHttpHandler, Boolean) Transfer(IHttpHandler, Boolean) Transfer(IHttpHandler, Boolean)

Прекращает выполнение текущей страницы и начинает выполнение новой страницы при помощи пользовательского обработчика HTTP-данных, который содержит реализацию интерфейса IHttpHandler, и указывает, необходимо ли очистить коллекции QueryString и Form.Terminates execution of the current page and starts execution of a new request by using a custom HTTP handler that implements the IHttpHandler interface and specifies whether to clear the QueryString and Form collections.

Transfer(String) Transfer(String) Transfer(String) Transfer(String)

Для текущего запроса прекращает выполнение текущей страницы и начинает выполнение новой страницы с помощью заданного URL-пути к странице.For the current request, terminates execution of the current page and starts execution of a new page by using the specified URL path of the page.

Transfer(String, Boolean) Transfer(String, Boolean) Transfer(String, Boolean) Transfer(String, Boolean)

Прекращает выполнение текущей страницы и начинает выполнение новой страницы с помощью заданного URL-пути к странице.Terminates execution of the current page and starts execution of a new page by using the specified URL path of the page. Указывает, необходимо ли очистить коллекции QueryString и Form.Specifies whether to clear the QueryString and Form collections.

TransferRequest(String) TransferRequest(String) TransferRequest(String) TransferRequest(String)

Выполняет асинхронное выполнение заданного URL-адреса.Performs an asynchronous execution of the specified URL.

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

Выполняет асинхронное выполнение заданного URL-адреса и сохраняет параметры строки запросов.Performs an asynchronous execution of the specified URL and preserves query string parameters.

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

Выполняет асинхронное выполнение заданного URL-адреса с использованием указанного метода и заголовков HTTP.Performs an asynchronous execution of the specified URL using the specified HTTP method and headers.

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

Выполняет асинхронно заданный url-адрес, используя указанный метод HTTP, заголовки и путь, а также, при необходимости, сохраняет значения формы и удостоверение пользователя.Performs an asynchronous execution of the specified URL using the specified HTTP method, headers, and path, and optionally preserves form values and the user identity.

UrlDecode(String) UrlDecode(String) UrlDecode(String) UrlDecode(String)

Расшифровывает строку в кодировке URL с последующим возвращением.URL-decodes a string and returns the decoded string.

UrlDecode(String, TextWriter) UrlDecode(String, TextWriter) UrlDecode(String, TextWriter) UrlDecode(String, TextWriter)

Декодирует строку HTML, полученную с кодировкой URL, и отправляет конечные выходные данные в поток выходных данных TextWriter.Decodes an HTML string received in a URL and sends the resulting output to a TextWriter output stream.

UrlEncode(String) UrlEncode(String) UrlEncode(String) UrlEncode(String)

Кодирует строку в кодировке URL и возвращает закодированную строку.URL-encodes a string and returns the encoded string.

UrlEncode(String, TextWriter) UrlEncode(String, TextWriter) UrlEncode(String, TextWriter) UrlEncode(String, TextWriter)

Кодирует в URL строку и отправляет конечные выходные данные в поток выходных данных TextWriter.URL-encodes a string and sends the resulting output to a TextWriter output stream.

UrlPathEncode(String) UrlPathEncode(String) UrlPathEncode(String) UrlPathEncode(String)

Не использовать; предназначено исключительно для совместимости браузеров.Do not use; intended only for browser compatibility. Используйте ключевое слово UrlEncode(String).Use UrlEncode(String).

UrlTokenDecode(String) UrlTokenDecode(String) UrlTokenDecode(String) UrlTokenDecode(String)

Расшифровывает лексему строки в кодировке URL в эквивалентный массив байтов, используя базовые 64 цифры.Decodes a URL string token to its equivalent byte array using base 64 digits.

UrlTokenEncode(Byte[]) UrlTokenEncode(Byte[]) UrlTokenEncode(Byte[]) UrlTokenEncode(Byte[])

Кодирует массив байтов в эквивалентное представление строки при помощи 64 знаков, используемых для передачи в кодировке URL.Encodes a byte array into its equivalent string representation using base 64 digits, which is usable for transmission on the URL.

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

Дополнительно