Uri.DnsSafeHost プロパティ

.NET Framework クラス ライブラリ リファレンス

Uri.DnsSafeHost プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

DNS の解決に安全に使用できるエスケープ解除されたホスト名を取得します。

名前空間: System
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 DnsSafeHost As String

Visual Basic (使用法)

Dim instance As Uri
Dim value As String

value = instance.DnsSafeHost

C#

public string DnsSafeHost { get;
 }

C++

public:
property String^ DnsSafeHost {
    String^ get ();
}

J#

/** @property */
public String get_DnsSafeHost ()

JScript

public function get DnsSafeHost
 () : String

プロパティ値
DNS の解決に適した URI のエスケープ解除されたホスト部分を格納している String。または、エスケープ解除された元のホスト文字列が解決に適している場合はその文字列。

例外

例外の種類	条件
InvalidOperationException	このインスタンスは相対 URI を表します。このプロパティは、絶対 URI でのみ有効です。

解説

IPv6 アドレスについては、角かっこ ([]) が削除されます。さらに、このインスタンスの作成時に ScopeId プロパティを指定した場合は、そのプロパティが設定されます。

使用例

文字列から Uri インスタンスを作成する例を次に示します。この例では、Host から返された値 (URI で指定したホスト名またはアドレスを返す ) と、DnsSafeHost から返された値 (DNS の解決に安全に使用できるアドレスを返す) の相違を表しています。

Visual Basic

    ' Create new Uri using a string address.         
    Dim address As New Uri("http://[fe80::200:39ff:fe36:1a2d%4]/temp/example.htm")
    
    ' Make the address DNS safe. 
    ' The following outputs "[fe80::200:39ff:fe36:1a2d]".
    Console.WriteLine(address.Host)
    
    ' The following outputs "fe80::200:39ff:fe36:1a2d%4".
    Console.WriteLine(address.DnsSafeHost)

End Sub 'SampleDNSSafeHost

C#

// Create new Uri using a string address.         
Uri address = new Uri("http://[fe80::200:39ff:fe36:1a2d%4]/temp/example.htm");

// Make the address DNS safe. 

// The following outputs "[fe80::200:39ff:fe36:1a2d]".
Console.WriteLine(address.Host);

// The following outputs "fe80::200:39ff:fe36:1a2d%4".
Console.WriteLine(address.DnsSafeHost);

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Uri クラス
Uri メンバ
System 名前空間