HttpServerUtility.HtmlEncode Метод

Определение

Кодирует строку, отображаемую в браузере.Encodes a string to be displayed in a browser.

Чтобы закодировать или декодировать значения вне веб-приложения, используйте класс WebUtility.To encode or decode values outside of a web application, use the WebUtility class.

Перегрузки

HtmlEncode(String)

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

HtmlEncode(String, TextWriter)

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

HtmlEncode(String)

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

public:
 System::String ^ HtmlEncode(System::String ^ s);
public string HtmlEncode (string s);
member this.HtmlEncode : string -> string
Public Function HtmlEncode (s As String) As String

Параметры

s
String

Кодируемая текстовая строка.The text string to encode.

Возвраты

Текст в формате HTML.The HTML-encoded text.

Примеры

В следующем примере показано, как HTML-кодировать значение, которое потенциально кодирует ненадежный код.The following example shows how to HTML-encode a value that potentially codes unsafe code. Код находится в файле кода программной части для веб-страницы.The code resides in the code-behind file for a web page. Значение для кодирования жестко закодировано в этом примере только для упрощения примера и отображения типа значения, которое можно кодировать в формате HTML.The value to encode is hard-coded in this example only to simplify the example and show the type of value you might HTML-encode. Как правило, HTML-кодирование имеет значение, полученное от пользователя или запроса.Typically, you would HTML-encode a value that you received from the user or the request. Resultссылается на Literal элемент управления.Result refers to a Literal control.

public partial class _Default : Page
{        
    protected void Page_Load(object sender, EventArgs e)
    {
        Result.Text = Server.HtmlEncode("<script>unsafe</script>");      
    } 
}
Public Class _Default
    Inherits Page

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
        Result.Text = Server.HtmlEncode("<script>unsafe</script>")
    End Sub
End Class

Следующий пример аналогичен предыдущему, за исключением того, что он показывает, как HTML-кодировать значение из класса, не находящийся в файле кода программной части.The next example is similar to the previous example except it shows how to HTML-encode a value from within a class that is not in the code-behind file.

public class SampleClass
{
    public string GetEncodedText()
    {
        return HttpContext.Current.Server.HtmlEncode("<script>unsafe</script>");
    }
}
Public Class SampleClass
    Public Function GetEncodedText() As String
        Return HttpContext.Current.Server.HtmlEncode("<script>unsafe</script>")
    End Function
End Class

Комментарии

Кодировка HTML гарантирует, что текст отображается правильно в браузере и не интерпретируется браузером как HTML.HTML encoding makes sure that text is displayed correctly in the browser and not interpreted by the browser as HTML. Например, если текстовая строка содержит знак "меньше" (<) или знак "больше" (>), браузер интерпретирует эти символы как открывающую или закрывающую скобку HTML-тега.For example, if a text string contains a less than sign (<) or greater than sign (>), the browser would interpret these characters as the opening or closing bracket of an HTML tag. Если символы кодируются в формате HTML, они преобразуются в строки &lt; и &gt;, что приводит к тому, что браузер отображает правильный знак "меньше" и "больше".When the characters are HTML encoded, they are converted to the strings &lt; and &gt;, which causes the browser to display the less than sign and greater than sign correctly.

Этот метод является удобным способом доступа HttpUtility.HtmlEncode к методу во время выполнения из приложения ASP.NET.This method is a convenient way to access the HttpUtility.HtmlEncode method at run time from an ASP.NET application. На внутреннем уровне этот метод HttpUtility.HtmlEncode использует для кодирования строк.Internally, this method uses HttpUtility.HtmlEncode to encode strings.

В файле кода программной части для веб-страницы ASP.NET необходимо получить доступ к экземпляру HttpServerUtility класса Server через свойство.In the code-behind file for an ASP.NET web page, access an instance of the HttpServerUtility class through the Server property. В классе, который не находится в файле кода программной части, используйте HttpContext.Current.Server для доступа к экземпляру HttpServerUtility класса.In a class that is not in a code-behind file, use HttpContext.Current.Server to access an instance of the HttpServerUtility class.

За пределами веб-приложения используйте WebUtility класс для кодирования или декодирования значений.Outside of a web application, use the WebUtility class to encode or decode values.

HtmlEncode(String, TextWriter)

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

public:
 void HtmlEncode(System::String ^ s, System::IO::TextWriter ^ output);
public void HtmlEncode (string s, System.IO.TextWriter output);
member this.HtmlEncode : string * System.IO.TextWriter -> unit
Public Sub HtmlEncode (s As String, output As TextWriter)

Параметры

s
String

Кодируемая строка.The string to encode.

output
TextWriter

Поток выходных данных TextWriter, содержащий зашифрованную строку.The TextWriter output stream that contains the encoded string.

Примеры

Следующий пример кодирует строку для передачи по протоколу HTTP.The following example encodes a string for transmission by HTTP. Он кодирует строку TestStringс именем, которая содержит текст "это <тестовая строка >", и копирует его в строку с именем EncodedString "это <тестовая строка>".It encodes the string named TestString, which contains the text "This is a <Test String>.", and copies it into the string named EncodedString as "This is a <Test String>.".

String TestString = "This is a <Test String>.";
StringWriter writer = new StringWriter();
Server.HtmlEncode(TestString, writer);
String EncodedString = writer.ToString();
   
Dim TestString As String = "This is a <Test String>."
Dim writer As New StringWriter
Server.HtmlEncode(TestString, writer)
Dim EncodedString As String = writer.ToString()
   

Комментарии

Кодировка HTML гарантирует, что текст будет правильно отображаться в браузере, не интерпретируемым браузером как HTML.HTML encoding ensures that text will be correctly displayed in the browser, not interpreted by the browser as HTML. Например, если текстовая строка содержит знак "меньше" (<) или знак "больше" (>), браузер интерпретирует эти символы как открывающую или закрывающую скобку HTML-тега.For example, if a text string contains a less than sign (<) or greater than sign (>), the browser would interpret these characters as an opening or closing bracket of an HTML tag. Кодировка HTML этих двух символов — &lt; и &gt;, соответственно, что приводит к тому, что браузер будет отображать знак «меньше» и «больше».The HTML encoding of these two characters is &lt; and &gt;, respectively, which causes the browser to display the less than sign and greater than sign correctly.

HtmlEncode— Это удобный способ доступа к HttpUtility.HtmlEncode методу во время выполнения из приложения ASP.NET.HtmlEncode is a convenient way to access the HttpUtility.HtmlEncode method at run time from an ASP.NET application. Внутренне HttpUtility.HtmlEncode использует для кодирования строк. HtmlEncodeInternally, HtmlEncode uses HttpUtility.HtmlEncode to encode strings.

Чтобы закодировать или декодировать значения вне веб-приложения, используйте класс WebUtility.To encode or decode values outside of a web application, use the WebUtility class.

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