Partilhar via

Manager.CanonizeURL(String, Manager+URL_CANONFLAGS) Método

  • Referência

Definição

Namespace:
Microsoft.IE
Assembly:
IEHost.dll

Converte uma cadeia de caracteres de URL em forma canônica.

Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código.

public:
 static System::String ^ CanonizeURL(System::String ^ pURL, Microsoft::IE::Manager::URL_CANONFLAGS flags);
public static string CanonizeURL (string pURL, Microsoft.IE.Manager.URL_CANONFLAGS flags);
static member CanonizeURL : string * Microsoft.IE.Manager.URL_CANONFLAGS -> string
Public Shared Function CanonizeURL (pURL As String, flags As Manager.URL_CANONFLAGS) As String

Parâmetros

pURL
String

Uma cadeia de caracteres terminada em nulo de comprimento máximo (INTERNET_MAX_URL_LENGTH) que contém uma cadeia de caracteres de URL. Se a cadeia de caracteres não fizer referência a um arquivo, ela deverá incluir um esquema válido, como "http://".

flags
Manager.URL_CANONFLAGS

Os sinalizadores que especificam como a URL será convertida em forma canônica. Os sinalizadores a seguir podem ser combinados:

  • Manager.URL_CANONFLAGS: trate "/. /" e "/... / "em uma cadeia de caracteres de URL como caracteres literais, não como um atalho para navegação.

  • Manager.URL_CANONFLAGS: converta qualquer ocorrência de "%" em sua sequência de escape.

  • Manager.URL_CANONFLAGS: substitua apenas espaços por sequências de escape. Esse sinalizador tem precedência sobre Manager.URL_CANONFLAGS, mas não se aplica a URLs opacas.

  • Manager.URL_CANONFLAGS: substitua caracteres não seguros pelas suas sequências de escape. Caracteres não seguros são caracteres que podem ser alterados durante o transporte pela Internet. Eles incluem os <caracteres , >, ", #, {, }, |, \, ^, [, ], e '. Esse sinalizador se aplica a todas as URLs, incluindo URLs opacas.

  • Manager.URL_CANONFLAGS: definido para ser o mesmo que Manager.URL_CANONFLAGS.

  • Manager.URL_CANONFLAGS: combine as URLs com protocolos conectáveis definidos pelo cliente de acordo com a especificação do W3C (World Wide Web Consortium). Esse sinalizador não se aplica a protocolos padrão, como FTP, HTTP e Gopher. Se esse sinalizador estiver definido, não será necessário definir também Manager.URL_CANONFLAGS.

  • Manager.URL_CANONFLAGS: cancele o escape de quaisquer sequências de escape que as URLs contenham, com duas exceções. Sequências de escape para "?" e "#" não são ficam sem escape. Se um dos sinalizadores URL_ESCAPE também estiver definido, as duas URLs serão primeiro sem escape, então combinadas e, por fim terão escape.

Retornos

String

A URL canônica.

Aplica-se a