HyperLinkField.DataNavigateUrlFields プロパティ

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

HyperLinkField.DataNavigateUrlFields プロパティ

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

HyperLinkField オブジェクトに表示されるハイパーリンクの URL を構築するために使用する、データ ソース内のフィールド名を取得または設定します。

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

Visual Basic (宣言)

Public Overridable Property
 DataNavigateUrlFields As String()

Visual Basic (使用法)

Dim instance As HyperLinkField
Dim value As String()

value = instance.DataNavigateUrlFields

instance.DataNavigateUrlFields = value

C#

public virtual string[] DataNavigateUrlFields
 { get; set; }

C++

public:
virtual property array<String^>^ DataNavigateUrlFields {
    array<String^>^ get ();
    void set (array<String^>^ value);
}

J#

/** @property */
public String[] get_DataNavigateUrlFields ()

/** @property */
public void set_DataNavigateUrlFields (String[]
 value)

JScript

public function get DataNavigateUrlFields
 () : String[]

public function set DataNavigateUrlFields
 (value : String[])

プロパティ値
HyperLinkField オブジェクトに表示されるハイパーリンクの URL を構築するために使用する、データ ソース内のフィールド名を格納している配列。既定値は、DataNavigateUrlFields が設定されていないことを示す空の配列です。

解説

HyperLinkField オブジェクトのハイパーリンク作成時に、データ ソース内の複数のフィールドを組み合わせて使用する場合は、DataNavigateUrlFields プロパティを使用します。DataNavigateUrlFields プロパティに指定されたフィールドが DataNavigateUrlFormatString プロパティの書式指定文字列を使って結合され、HyperLinkField オブジェクトのハイパーリンクが構築されます。

メモ
DataNavigateUrlFields プロパティを .aspx ファイル内の宣言コードで設定する場合は、各フィールド名をコンマ区切りで指定します。

このプロパティを使ってハイパーリンクの URL をフィールドにバインドする代わりに、NavigateUrl プロパティを使用して、ハイパーリンクの URL を静的な値に設定することもできます。この方法を使用した場合、すべてのハイパーリンクで同じ URL が共有されます。

メモ
DataNavigateUrlFields プロパティと NavigateUrl プロパティの両方が設定されている場合は、DataNavigateUrlFields プロパティが優先されます。

プラットフォーム

Windows 98, Windows 2000 SP4, 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

参照

関連項目
HyperLinkField クラス
HyperLinkField メンバ
System.Web.UI.WebControls 名前空間