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) |
Создает экземпляр сервера com-объекта, определяемого программным идентификатором объекта (ProgID). |
CreateObject(Type) |
Создает экземпляр сервера com-объекта, определяемого типом объекта. |
CreateObjectFromClsid(String) |
Создает экземпляр сервера com-объекта, определяемого идентификатором класса объекта (CLSID). |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
Execute(IHttpHandler, TextWriter, Boolean) |
Выполняет обработчик для указанного виртуального пути в контексте текущего запроса. TextWriter записывает выходные данные из исполняемого обработчика и логический параметр указывает, следует ли очистить коллекции QueryString и Form. |
Execute(String, Boolean) |
Выполняет обработчик для указанного виртуального пути в контексте текущего запроса и указывает, следует ли очистить коллекции QueryString и Form. |
Execute(String, TextWriter, Boolean) |
Выполняет обработчик для указанного виртуального пути в контексте текущего запроса. TextWriter записывает выходные данные со страницы и логический параметр указывает, следует ли очищать коллекции QueryString и Form. |
Execute(String, TextWriter) |
Выполняет обработчик для указанного виртуального пути в контексте текущего запроса. TextWriter записывает выходные данные из исполняемого обработчика. |
Execute(String) |
Выполняет обработчик для указанного виртуального пути в контексте текущего запроса. |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetLastError() |
Возвращает предыдущее исключение. |
GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
HtmlDecode(String, TextWriter) |
Декодирует строку в кодировке HTML и отправляет полученные выходные данные в поток вывода TextWriter. |
HtmlDecode(String) |
Декодирует строку в кодировке HTML и возвращает декодированную строку. |
HtmlEncode(String, TextWriter) |
HTML-кодирует строку и отправляет полученные выходные данные в поток вывода TextWriter. |
HtmlEncode(String) |
HTML-кодирует строку и возвращает закодированную строку. |
MapPath(String) |
Возвращает путь к физическому файлу, соответствующий указанному виртуальному пути. |
MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
Transfer(IHttpHandler, Boolean) |
Завершает выполнение текущей страницы и запускает выполнение нового запроса с помощью пользовательского обработчика HTTP, реализующего интерфейс IHttpHandler, и указывает, следует ли очистить QueryString и Form коллекции. |
Transfer(String, Boolean) |
Завершает выполнение текущей страницы и запускает выполнение новой страницы с помощью указанного URL-пути страницы. Указывает, следует ли очистить коллекции QueryString и Form. |
Transfer(String) |
Для текущего запроса завершает выполнение текущей страницы и запускает выполнение новой страницы с помощью указанного URL-пути страницы. |
TransferRequest(String, Boolean, String, NameValueCollection, Boolean) |
Выполняет асинхронное выполнение указанного URL-адреса с помощью указанного метода HTTP, заголовков и пути, а также при необходимости сохраняет значения форм и удостоверение пользователя. |
TransferRequest(String, Boolean, String, NameValueCollection) |
Выполняет асинхронное выполнение указанного URL-адреса с помощью указанного метода HTTP и заголовков. |
TransferRequest(String, Boolean) |
Выполняет асинхронное выполнение указанного URL-адреса и сохраняет параметры строки запроса. |
TransferRequest(String) |
Выполняет асинхронное выполнение указанного URL-адреса. |
UrlDecode(String, TextWriter) |
Декодирует HTML-строку, полученную в URL-адресе, и отправляет полученные выходные данные в поток вывода TextWriter. |
UrlDecode(String) |
URL-декодирует строку и возвращает декодированную строку. |
UrlEncode(String, TextWriter) |
URL-адрес кодирует строку и отправляет полученные выходные данные в поток вывода TextWriter. |
UrlEncode(String) |
URL-кодирует строку и возвращает закодированную строку. |
UrlPathEncode(String) |
Не используйте; Предназначен только для совместимости браузера. Используйте UrlEncode(String). |
UrlTokenDecode(String) |
Декодирует маркер строки URL-адреса в эквивалентный массив байтов с помощью базовых 64 цифр. |
UrlTokenEncode(Byte[]) |
Кодирует массив байтов в эквивалентное строковое представление с помощью базовых 64 цифр, которые можно использовать для передачи по URL-адресу. |