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. |