Uri Classe

Uma URI é uma representação de compactação de um recurso disponível para o aplicativo na intranet ou na Internet.A classe Uri define as propriedades e métodos para manipular URIs, incluindo análise, comparação e combinação.The Uri class properties are read-only; to create a modifiable object, use the UriBuilder class.

URIs relativas (por exemplo, "/novo/index.htm") devem ser expandidas com relação a uma base URI para que elas fiquem absolutas.The MakeRelative method is provided to convert absolute URIs to relative URIs when necessary.

Os construtores Uri não escape uma cadeia de caracteres URI se a seqüência for uma URI bem-formada incluindo um identificador de esquema.

As propriedades da Uri retornam uma representação canônica de dados na codificação "escapada", com todos os caracteres com valores Unicode maiores que 127 substituídos por seus equivalentes em hexadecimal.Para colocar a URI em forma canônica, o construtor Uri executa as seguintes etapas:

• Converte o esquema de URI para minúsculas.

• Converte o nome de host em minúsculas.

• Se o nome de host for um endereço IPv6, o endereço IPv6 canônico é usado.ScopeId e outros dados IPv6 opcionais são removidos.

• Removes usar como padrão and Vazio Numbers porta.

• Padroniza o caminho para URIs hierárquicas através da compactação de seqüências tais como /. /, /../, //, incluindo representações escapadas.

• Para URIs hierárquicas, se o host não está finalizado com uma barra (/), uma é adicionada.

• Quaisquer caracteres reservados na URI são "escapados" de acordo com a RFC 2396.

You can transform the contents of the Uri class from an escape encoded URI reference to a readable URI reference by using the ToString method.Observe que alguns caracteres reservados pode ainda ser "escapados" na saída do método ToString.Isso é para suportar a reconstrução não ambígua de uma URI a partir do valor retornado por ToString.

Algumas URIs incluem um identificador de fragmento ou uma consulta ou ambos.A fragment identifier is any text that follows a number sign (#), not including the number sign; the fragment text is stored in the Fragment property.Informações de consulta são qualquer texto que segue um ponto de interrogação (?) na URI; o texto de consulta é armazenado na propriedade Query.

No .NET Framework versão 1.1, se a seqüência de caracteres especificada para um construtor contiver um esquema desconhecido e "c:\", a classe URI insere "//" após o ponto-e-vírgula.Por exemplo, a URI xyz:c:\abc é convertida em xyz://c:/abc.No .NET Framework versão 2.0, esse comportamento foi removido, e o exemplo de seqüência é convertido em xyz:c:/abc.

Observação:
A classe URI oferece suporte ao uso de endereços IP em ambos notação quádrupla para protocolo IPv4 e dois pontos-hexadecimal para o protocolo IPv6.Lembre-se de confinar o endereço IPv6 em colchetes, como em http://[::1].

Considerações sobre desempenho

Because of security concerns, your application should use caution when accepting Uri instances from untrusted sources and with dontEscape set to true.You can check a URI string for validity by calling the IsWellFormedOriginalString method.

Windows Mobile para Pocket PC, Windows Mobile para Smartphone, O Windows CE Platform Note:

O .NET Compact Framework não diferencia entre os caminhos relativos e absolutos.Also, the .NET Compact Framework Processes URI Cadeia de caracteres prefixed by the esquema file:// differently from the .NET Framework Full.Uma especificação realtiva file://myFile resolve como \\myfile.Usando file:///myFile (três barras) resolve como \myfile no diretório raiz.Para garantir êxito nas operações, especifique informações sobre o caminho absoluto.

The following example creates an instance of the Uri class and uses it to create a WebRequest instance.

Uri siteUri = new Uri("http://www.contoso.com/");

WebRequest wr = WebRequest.Create(siteUri);

Uri siteUri = new Uri("http://www.contoso.com/");
WebRequest wr = WebRequest.Create(siteUri);

var siteUri : Uri = new Uri("http://www.contoso.com/");
var wr : WebRequest = WebRequest.Create(siteUri);

Referência