Uri.IdnHost Propriedade

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

Uri.cs

Obtém o Nome de Domínio Internacional compatível com RFC 3490 do host, usando Punycode conforme apropriado. Esta cadeia de caracteres, depois de não ser escapada, se necessário, é seguro para ser usado para a resolução de DNS.

public:
 property System::String ^ IdnHost { System::String ^ get(); };

public string IdnHost { get; }

member this.IdnHost : string

Public ReadOnly Property IdnHost As String

Valor da propriedade

String

O nome do host, formatado com Punycode de acordo com o padrão IDN.

Exceções

InvalidOperationException

Esta instância representa uma URL relativa, e esta propriedade só é válida para URIs absolutos.

Comentários

Essa propriedade é fornecida para o uso de protocolos de rede de nível inferior que exigem o nome de domínio no formulário Punycode. Se o código não exigir esse formato específico, use Host para o nome do host.

A propriedade preterida DnsSafeHost depende app.config configurações, que não podem ser alteradas por aplicativos da Windows Store. O IdnHost é fornecido como a alternativa preferencial ao uso DnsSafeHostde , pois IdnHost é garantido que sempre seja seguro para DNS, não importa quais sejam as configurações de app.config atuais.

Se você usou uma cadeia de caracteres de escape para construir essa instância (por exemplo, "http://[fe80::200:39ff:fe36:1a2d%254]/temp/example.htm"), IdnHost retornará uma cadeia de caracteres de escape. Você deve ignorar o escape de qualquer cadeia de caracteres de escape retornada de IdnHost antes de usar essa cadeia de caracteres para resolução DNS. Lembre-se de que, se você usou uma cadeia de caracteres sem escape inválida para construir essa instância (por exemplo, "http://[fe80::200:39ff:fe36:1a2d%4]/temp/example.htm"), IdnHost retornará uma cadeia de caracteres sem escape.