AntiXssEncoder.UrlEncode Método

Definição

Espaço de Nomes:: System.Web.Security.AntiXss

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Codifica strings e arrays de bytes para uso numa URL.

Sobrecargas

Name	Description
UrlEncode(String)	Codifica a string especificada para uso numa URL.
UrlEncode(String, Int32)	Codifica a cadeia especificada para uso numa URL usando a página de códigos especificada.
UrlEncode(String, Encoding)	Codifica a cadeia especificada para uso numa URL usando o tipo de codificação de caracteres especificado.
UrlEncode(Byte[], Int32, Int32)	Codifica o array de bytes especificado para uso numa URL, começando no deslocamento especificado no array de bytes e codificando o número de bytes especificado.

UrlEncode(String)

Codifica a string especificada para uso numa URL.

public:
 static System::String ^ UrlEncode(System::String ^ input);

public static string UrlEncode(string input);

static member UrlEncode : string -> string

Public Shared Function UrlEncode (input As String) As String

Parâmetros

input: String

A cadeia a codificar.

Devoluções

String

A cadeia codificada.

Observações

Este método codifica todos os caracteres, exceto aqueles que estão na lista de seguros. Os caracteres são codificados usando %SINGLE_BYTE_HEX notação.

A tabela seguinte lista as personagens seguras por defeito. Todos os caracteres pertencem aos Controlos Unicode C0 e à gama de caracteres Basic Latin.

Personagem(s)	Descrição
De A a Z	Caracteres alfabéticos maiúsculos
a-z	Caracteres alfabéticos minúsculos
0-9	Números
-	Hífen, menos
.	Ponto final, ponto final
_	Caráter de sublinhado
~	Til

A tabela seguinte lista exemplos de entradas e as correspondentes saídas codificadas.

Entrada	Produção
`alert('XSS Attack!');`	`alert(%27XSS%20Attack%21%27)%3b`
`<script>alert('XSS Attack!');</script>`	`%3cscript%3ealert(%27XSS%20Attack%21%27)%3b%3c%2fscript%3e`
`alert('XSSあAttack!');`	`alert(%27XSS%e3%81%82Attack%21%27)%3b`
`user@contoso.com`	`user@contoso.com`
`"Anti-Cross Site Scripting Namespace"`	`%22Anti-Cross%20Site%20Scripting%20Namespace%22`

Aplica-se a

UrlEncode(String, Int32)

Codifica a cadeia especificada para uso numa URL usando a página de códigos especificada.

public:
 static System::String ^ UrlEncode(System::String ^ input, int codePage);

public static string UrlEncode(string input, int codePage);

static member UrlEncode : string * int -> string

Public Shared Function UrlEncode (input As String, codePage As Integer) As String

Parâmetros

input: String

A cadeia a codificar.

codePage: Int32

A página de código para usar para codificar a input cadeia.

Devoluções

String

A cadeia codificada.

Observações

Este método codifica todos os caracteres, exceto aqueles que estão na lista de seguros. Os caracteres são codificados usando %SINGLE_BYTE_HEX notação.

A tabela seguinte lista as personagens seguras por defeito. Todos os caracteres pertencem aos Controlos Unicode C0 e à gama de caracteres Basic Latin.

Tabela de códigos Unicode	Personagem(s)	Descrição
De A a Z	Caracteres alfabéticos maiúsculos
a-z	Caracteres alfabéticos minúsculos
0-9	Números
-	Hífen, menos
.	Ponto final, ponto final
_	Caráter de sublinhado
~	Til

A tabela seguinte lista exemplos de entradas e as correspondentes saídas codificadas.

Entrada	Produção
`alert('XSS Attack!');`	`alert(%27XSS%20Attack%21%27)%3b`
`<script>alert('XSS Attack!');</script>`	`%3cscript%3ealert(%27XSS%20Attack%21%27)%3b%3c%2fscript%3e`
`alert('XSSあAttack!');`	`alert(%27XSS%e3%81%82Attack%21%27)%3b`
`user@contoso.com`	`user@contoso.com`
`"Anti-Cross Site Scripting Namespace"`	`%22Anti-Cross%20Site%20Scripting%20Namespace%22`

Aplica-se a

UrlEncode(String, Encoding)

Codifica a cadeia especificada para uso numa URL usando o tipo de codificação de caracteres especificado.

public:
 static System::String ^ UrlEncode(System::String ^ input, System::Text::Encoding ^ inputEncoding);

public static string UrlEncode(string input, System.Text.Encoding inputEncoding);

static member UrlEncode : string * System.Text.Encoding -> string

Public Shared Function UrlEncode (input As String, inputEncoding As Encoding) As String

Parâmetros

input: String

A cadeia a codificar.

inputEncoding: Encoding

O tipo de codificação de entrada.

Devoluções

String

A cadeia codificada.

Observações

Este método codifica todos os caracteres, exceto aqueles que estão na lista de seguros. Os caracteres são codificados usando %SINGLE_BYTE_HEX notação.

A tabela seguinte lista as personagens seguras por defeito. Todos os caracteres pertencem aos Controlos Unicode C0 e à gama de caracteres Basic Latin.

Personagem(s)	Descrição
De A a Z	Caracteres alfabéticos maiúsculos
a-z	Caracteres alfabéticos minúsculos
0-9	Números
-	Hífen, menos
.	Ponto final, ponto final
_	Caráter de sublinhado
~	Til

A tabela seguinte lista exemplos de entradas e as correspondentes saídas codificadas.

Entrada	Produção
`alert('XSS Attack!');`	`alert(%27XSS%20Attack%21%27)%3b`
`<script>alert('XSS Attack!');</script>`	`%3cscript%3ealert(%27XSS%20Attack%21%27)%3b%3c%2fscript%3e`
`alert('XSSあAttack!');`	`alert(%27XSS%e3%81%82Attack%21%27)%3b`
`user@contoso.com`	`user@contoso.com`
`"Anti-Cross Site Scripting Namespace"`	`%22Anti-Cross%20Site%20Scripting%20Namespace%22`

Aplica-se a

UrlEncode(Byte[], Int32, Int32)

Codifica o array de bytes especificado para uso numa URL, começando no deslocamento especificado no array de bytes e codificando o número de bytes especificado.

protected public:
 override cli::array <System::Byte> ^ UrlEncode(cli::array <System::Byte> ^ bytes, int offset, int count);

protected internal override byte[] UrlEncode(byte[] bytes, int offset, int count);

override this.UrlEncode : byte[] * int * int -> byte[]

Protected Friend Overrides Function UrlEncode (bytes As Byte(), offset As Integer, count As Integer) As Byte()

Parâmetros

bytes: Byte[]

O array de bytes a codificar.

offset: Int32

O índice do primeiro byte a codificar.

count: Int32

O número de bytes a codificar.

Devoluções

Byte[]

O array de bytes codificado.

Observações

Este método codifica todos os caracteres, exceto aqueles que estão na lista de seguros. Os caracteres são codificados usando %SINGLE_BYTE_HEX notação.

A tabela seguinte lista as personagens seguras por defeito. Todos os caracteres pertencem aos Controlos Unicode C0 e à gama de caracteres Basic Latin.

Personagem(s)	Descrição
De A a Z	Caracteres alfabéticos maiúsculos
a-z	Caracteres alfabéticos minúsculos
0-9	Números
-	Hífen, menos
.	Ponto final, ponto final
_	Caráter de sublinhado
~	Til

A tabela seguinte lista exemplos de entradas e as correspondentes saídas codificadas.

Entrada	Produção
`alert('XSS Attack!');`	`alert(%27XSS%20Attack%21%27)%3b`
`<script>alert('XSS Attack!');</script>`	`%3cscript%3ealert(%27XSS%20Attack%21%27)%3b%3c%2fscript%3e`
`alert('XSSあAttack!');`	`alert(%27XSS%e3%81%82Attack%21%27)%3b`
`user@contoso.com`	`user@contoso.com`
`"Anti-Cross Site Scripting Namespace"`	`%22Anti-Cross%20Site%20Scripting%20Namespace%22`

Aplica-se a

Comentários

Esta página foi útil?