HttpEncoder.HtmlEncode(String, TextWriter) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Converte uma cadeia de caracteres em uma cadeia de caracteres codificada em HTML.
protected public:
virtual void HtmlEncode(System::String ^ value, System::IO::TextWriter ^ output);
protected internal virtual void HtmlEncode (string value, System.IO.TextWriter output);
abstract member HtmlEncode : string * System.IO.TextWriter -> unit
override this.HtmlEncode : string * System.IO.TextWriter -> unit
Protected Friend Overridable Sub HtmlEncode (value As String, output As TextWriter)
Parâmetros
- value
- String
A cadeia de caracteres a ser codificada.
- output
- TextWriter
O gravador de texto no qual gravar o valor codificado.
Exceções
output
é null
.
Comentários
A tabela a seguir lista as sequências de caracteres que a lógica de codificação ASP.NET pode decodificar.
Caractere | Codificado como |
---|---|
< (colchete angular esquerdo) |
< |
> (colchete angular direito) |
> |
" (aspas duplas) |
" |
& (e comercial) |
& |
\ barra invertida |
\ |
Caracteres ASCII de 160 a 255 | &#NNN; , onde NNN é o código de caractere decimal de três dígitos |
Se você substituir o HtmlEncode método, deverá produzir uma saída que também seja segura em atributos HTML com aspas duplas ou com aspas simples. Isso acomoda a análise pelo mecanismo Razor, onde a marcação e o código podem ser combinados, como <tag attr="@value"> . Além disso, o operador @ não reconhece contexto quando processado pelo mecanismo Razor, portanto, ele chama HtmlEncode em vez de HtmlAttributeEncode .