HyperLinkColumn.DataNavigateUrlFormatString プロパティ

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

HyperLinkColumn.DataNavigateUrlFormatString プロパティ

URL がデータ ソースのフィールドにデータ バインドされる場合の、HyperLinkColumn 内のハイパーリンクの URL の表示形式を取得または設定します。

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

Visual Basic (宣言)

Public Overridable Property
 DataNavigateUrlFormatString As String

Visual Basic (使用法)

Dim instance As HyperLinkColumn
Dim value As String

value = instance.DataNavigateUrlFormatString

instance.DataNavigateUrlFormatString = value

C#

public virtual string DataNavigateUrlFormatString
 { get; set; }

C++

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

J#

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

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

JScript

public function get DataNavigateUrlFormatString
 () : String

public function set DataNavigateUrlFormatString
 (value : String)

プロパティ値
URL がデータ ソースのフィールドにデータ バインドされる場合の、HyperLinkColumn 内のハイパーリンクの URL の表示形式を指定する文字列。既定値は String.Empty で、このプロパティが設定されていないことを示します。

解説

DataNavigateUrlFormatString プロパティを使用して、HyperLinkColumn 内のハイパーリンクの URL にカスタムの表示形式を指定します。指定した形式は、データ ソースのフィールドにデータ バインドされた場合の URL にだけ適用されます。列内のハイパーリンクの URL にバインドするフィールドを指定するには、DataNavigateUrlField プロパティを設定します。

書式指定文字列の構文については、String.Format のトピックを参照してください。

使用例

DataNavigateUrlFormatString プロパティを使用して HyperLinkColumn 内のデータ バインドされたハイパーリンクを書式設定する方法の例を次に示します。

メモ
次のコード サンプルはシングルファイル コード モデルを使用しており、分離コード ファイルに直接コピーされた場合は正常に動作しない可能性があります。このコード サンプルは、拡張子が .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>

C#

<%@ 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>

C#

<%@ 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>

プラットフォーム

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、1.1、1.0

参照

関連項目
HyperLinkColumn クラス
HyperLinkColumn メンバ
System.Web.UI.WebControls 名前空間
HyperLinkColumn.DataNavigateUrlField プロパティ
String.Format
その他の技術情報
書式設定の概要