HyperLinkColumn.DataNavigateUrlField プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

HyperLinkColumn.DataNavigateUrlField プロパティ

HyperLinkColumn 内のハイパーリンクの URL にバインドするデータソースのフィールドを取得または設定します。

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

Visual Basic (宣言)

Public Overridable Property
 DataNavigateUrlField As String

Visual Basic (使用法)

Dim instance As HyperLinkColumn
Dim value As String

value = instance.DataNavigateUrlField

instance.DataNavigateUrlField = value

public virtual string DataNavigateUrlField
 { get; set; }

C++

public:
virtual property String^ DataNavigateUrlField {
    String^ get ();
    void set (String^ value);
}

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

/** @property */
public void set_DataNavigateUrlField (String
 value)

JScript

public function get DataNavigateUrlField
 () : String

public function set DataNavigateUrlField
 (value : String)

プロパティ値
HyperLinkColumn 内のハイパーリンクの URL にバインドするデータソースのフィールド。

解説

DataNavigateUrlField プロパティを使用して、HyperLinkColumn 内のハイパーリンクの URL にバインドするデータソースのフィールドを指定します。URL がフィールドにデータバインドされると、列内の各ハイパーリンクの URL は、指定したフィールドの対応する値に設定されます。この方法を使用すると、列内のハイパーリンクごとに異なる URL を設定できます。列内の各行に同じ URL を指定する場合は、このプロパティではなく NavigateUrl プロパティを設定します。

メモ
DataNavigateUrlField プロパティと NavigateUrl プロパティの両方を同時には設定できません。両方のプロパティを設定した場合は、DataNavigateUrlField プロパティが優先されます。

データバインディングを使用している場合は、DataNavigateUrlFormatString プロパティを設定して、ハイパーリンクの URL にカスタムの表示形式を指定できます。

使用例

DataNavigateUrlField プロパティを使用して HyperLinkColumn 内のハイパーリンクの URL にバインドするデータソースのフィールドを指定する方法の例を次に示します。

メモ
次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルは、拡張子が .aspx の空のテキストファイルにコピーする必要があります。Web フォームのコードモデルの詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

メモ

次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルは、拡張子が .aspx の空のテキストファイルにコピーする必要があります。Web フォームのコードモデルの詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

Visual Basic

<%@ Page Language="VB" AutoEventWireup="True"
 %>
<%@ Import Namespace="System.Data"
 %>

<html>

<head>

   <script runat="server">

      Function CreateDataSource() As ICollection
 
      
         Dim dt As DataTable = New
 DataTable()
         Dim dr As DataRow
         Dim i As Integer

         dt.Columns.Add(New DataColumn("IntegerValue",
 GetType(Int32)))
         dt.Columns.Add(New DataColumn("PriceValue",
 GetType(Double)))
       
         For i = 0 to 2 
         
            dr = dt.NewRow()

            dr(0) = i
            dr(1) = CDbl(i) * 1.23

            dt.Rows.Add(dr)

         Next i

         Dim dv As DataView = New
 DataView(dt)
         Return dv

      End Function

      Sub Page_Load(sender As Object,
 e As EventArgs) 
    
         MyDataGrid.DataSource = CreateDataSource()
         MyDataGrid.DataBind()

      End Sub

   </script>

</head>

<body>

   <form runat="server">

      <h3>HyperLinkColumn Example<h3>

      <asp:DataGrid id="MyDataGrid" 
           BorderColor="black"
           BorderWidth="1"
           GridLines="Both"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#aaaadd"/>

         <Columns>

            <asp:HyperLinkColumn
                 HeaderText="Select an Item"
                 DataNavigateUrlField="IntegerValue"
                 DataNavigateUrlFormatString="detailspage.aspx?id={0}"
                 DataTextField="PriceValue"
                 DataTextFormatString="{0:c}"
                 Target="_blank"/>
           
         </Columns>

      </asp:DataGrid>

   </form>

</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<html>

<head>

   <script runat="server">

      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;

         dt.Columns.Add(new DataColumn("IntegerValue",
 typeof(Int32)));
         dt.Columns.Add(new DataColumn("PriceValue",
 typeof(Double)));
       
         for (int i = 0; i < 3; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = (Double)i * 1.23;

            dt.Rows.Add(dr);
         }

         DataView dv = new DataView(dt);
         return dv;
      }

      void Page_Load(Object sender, EventArgs e) 
      {
         MyDataGrid.DataSource = CreateDataSource();
         MyDataGrid.DataBind();
      }

   </script>

</head>

<body>

   <form runat="server">

      <h3>HyperLinkColumn Example<h3>

      <asp:DataGrid id="MyDataGrid" 
           BorderColor="black"
           BorderWidth="1"
           GridLines="Both"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#aaaadd"/>

         <Columns>

            <asp:HyperLinkColumn
                 HeaderText="Select an Item"
                 DataNavigateUrlField="IntegerValue"
                 DataNavigateUrlFormatString="detailspage.aspx?id={0}"
                 DataTextField="PriceValue"
                 DataTextFormatString="{0:c}"
                 Target="_blank"/>
           
         </Columns>

      </asp:DataGrid>

   </form>

</body>
</html>

前述の例で選択された項目を表示する対応する例を次に示します。

Visual Basic

<%@ Page Language="VB" AutoEventWireup="True"
 %>
<html>
<head>
 
   <script runat="server">
 
      Sub Page_Load(sender As Object,
 e As EventArgs) 
      
         Label1.Text = "You selected item: " &
 Request.QueryString("id")
      
      End Sub
 
   </script>
 
</head>
<body>
 
   <h3>Details page for DataGrid</h3>
 
   <asp:Label id="Label1"
        runat="server"/>
 
</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
 
   <script runat="server">
 
      void Page_Load(Object sender, EventArgs e) 
      {
         Label1.Text = "You selected item: " + Request.QueryString["id"];
      }
 
   </script>
 
</head>
<body>
 
   <h3>Details page for DataGrid</h3>
 
   <asp:Label id="Label1"
        runat="server"/>
 
</body>
</html>