HyperLinkColumn クラス

定義

名前空間:: System.Web.UI.WebControls

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

列内の各項目のハイパーリンクを含む DataGrid コントロールの列の種類。

public ref class HyperLinkColumn : System::Web::UI::WebControls::DataGridColumn

public class HyperLinkColumn : System.Web.UI.WebControls.DataGridColumn

type HyperLinkColumn = class
    inherit DataGridColumn

Public Class HyperLinkColumn
Inherits DataGridColumn

継承: Object

DataGridColumn
HyperLinkColumn

例

次の例では、別のページにリンクする HyperLinkColumn を作成する方法を示します。

Note

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

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >

<head>
    <title>HyperLinkColumn Example</title>
<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 id="form1" 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="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >

<head>
    <title>HyperLinkColumn Example</title>
<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 id="form1" 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" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Details page for DataGrid</title>
<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>

<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Details page for DataGrid</title>
<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>

注釈

HyperLinkColumnの各行のハイパーリンクを作成するには、DataGrid コントロールのDataGrid列の種類を使用します。ハイパーリンクのキャプションテキストを指定するには、 Text プロパティを設定します。ハイパーリンクがクリックされたときにリンクする URL を指定するには、 NavigateUrl プロパティを設定します。

Note

TextプロパティとNavigateUrlプロパティを設定すると、列内のすべてのハイパーリンクが同じキャプションと URL を共有します。

HyperLinkColumnプロパティとTextプロパティを設定する代わりに、NavigateUrl内のハイパーリンクのテキストキャプションと URL をデータソースのフィールドにバインドすることもできます。これにより、異なるキャプションを表示し、列のハイパーリンクごとに異なる URL を指定できます。

DataTextField プロパティを使用して、列内のハイパーリンクのテキストキャプションにバインドするデータソース内のフィールドを指定します。

Note

DataTextFieldプロパティとText プロパティの両方を同時に設定することはできません。両方のプロパティが設定されている場合は、 DataTextField プロパティが優先されます。

DataNavigateUrlField プロパティを設定して、ハイパーリンクの URL にバインドするフィールドを指定します。

Note

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

Target プロパティを使用すると、ハイパーリンクがクリックされたときにリンクされた Web ページコンテンツを表示するウィンドウまたはフレームを指定できます。

データバインディングを使用する場合は、 DataTextFormatString プロパティと DataNavigateUrlFormatString プロパティをそれぞれ設定することで、ハイパーリンクのテキストキャプションと URL を書式設定できます。

Caution

このコントロールを使用すると、悪意のあるクライアントスクリプトを含む可能性があるユーザー入力を表示できます。実行可能スクリプト、SQL ステートメント、またはその他のコードについてクライアントから送信された情報を、アプリケーションに表示する前に確認します。コントロールに入力テキストを表示する前に、検証コントロールを使用してユーザー入力を確認できます。 ASP.NET は、ユーザー入力のスクリプトと HTML をブロックする入力要求検証機能を提供します。詳細については、「標準コントロールのセキュリティ保護」、「方法: 文字列に HTML エンコードを適用して Web アプリケーションのスクリプトの悪用から保護する」および「ASP.NET Web ページでのユーザー入力の検証」を参照してください。

コンストラクター

名前	説明
HyperLinkColumn()	HyperLinkColumn クラスの新しいインスタンスを初期化します。

プロパティ

名前	説明
DataNavigateUrlField	データソースから、 HyperLinkColumn内のハイパーリンクの URL にバインドするフィールドを取得または設定します。
DataNavigateUrlFormatString	URL がデータソース内のフィールドにデータバインドされている場合に、 HyperLinkColumn 内のハイパーリンクの URL の表示形式を取得または設定します。
DataTextField	HyperLinkColumn内のハイパーリンクのテキストキャプションにバインドするデータソースのフィールドを取得または設定します。
DataTextFormatString	HyperLinkColumn列のハイパーリンクのテキストキャプションの表示形式を取得または設定します。
DesignMode	列がデザインモードであるかどうかを示す値を取得します。 (継承元 DataGridColumn)
FooterStyle	列のフッターセクションのスタイルプロパティを取得します。 (継承元 DataGridColumn)
FooterText	列のフッターセクションに表示されるテキストを取得または設定します。 (継承元 DataGridColumn)
HeaderImageUrl	列のヘッダーセクションに表示するイメージの場所を取得または設定します。 (継承元 DataGridColumn)
HeaderStyle	列のヘッダーセクションのスタイルプロパティを取得します。 (継承元 DataGridColumn)
HeaderText	列のヘッダーセクションに表示されるテキストを取得または設定します。 (継承元 DataGridColumn)
IsTrackingViewState	DataGridColumn オブジェクトが状態を保存するようにマークされているかどうかを示す値を取得します。 (継承元 DataGridColumn)
ItemStyle	列の項目セルのスタイルプロパティを取得します。 (継承元 DataGridColumn)
NavigateUrl	列内のハイパーリンクがクリックされたときにリンクする URL を取得または設定します。
Owner	列がメンバーである DataGrid コントロールを取得します。 (継承元 DataGridColumn)
SortExpression	列が並べ替えに選択されたときに OnSortCommand(DataGridSortCommandEventArgs) メソッドに渡すフィールドまたは式の名前を取得または設定します。 (継承元 DataGridColumn)
Target	列内のハイパーリンクがクリックされたときにリンクされる Web ページコンテンツを表示するターゲットウィンドウまたはフレームを取得または設定します。
Text	列のハイパーリンクに表示するテキストキャプションを取得または設定します。
ViewState	StateBag クラスから派生した列がそのプロパティを格納できるようにするDataGridColumn オブジェクトを取得します。 (継承元 DataGridColumn)
Visible	DataGrid コントロールに列が表示されるかどうかを示す値を取得または設定します。 (継承元 DataGridColumn)

メソッド

名前	説明
Equals(Object)	指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
FormatDataNavigateUrlValue(Object)	DataNavigateUrlFormatString プロパティで指定された形式を使用して、データバインド URL を書式設定します。
FormatDataTextValue(Object)	DataTextFormatString プロパティで指定された形式を使用して、データバインドテキストキャプションを書式設定します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
Initialize()	DataGridColumn クラスから派生した列を初期状態にリセットするための基本実装を提供します。
InitializeCell(TableCell, Int32, ListItemType)	含まれているハイパーリンクを使用して、この列を表すセルを初期化します。
LoadViewState(Object)	DataGridColumn オブジェクトの状態を読み込みます。 (継承元 DataGridColumn)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
OnColumnChanged()	OnColumnsChanged() メソッドを呼び出します。 (継承元 DataGridColumn)
SaveViewState()	DataGridColumn オブジェクトの現在の状態を保存します。 (継承元 DataGridColumn)
ToString()	列の文字列形式を返します。 (継承元 DataGridColumn)
TrackViewState()	ビューステートの変更をサーバーコントロールに追跡して、サーバーコントロールの StateBag オブジェクトに格納できるようにします。 (継承元 DataGridColumn)

明示的なインターフェイスの実装

名前	説明
IStateManager.IsTrackingViewState	列がビューステートの変更を追跡しているかどうかを示す値を取得します。 (継承元 DataGridColumn)
IStateManager.LoadViewState(Object)	以前に保存した状態を読み込みます。 (継承元 DataGridColumn)
IStateManager.SaveViewState()	状態の変更を含むオブジェクトを返します。 (継承元 DataGridColumn)
IStateManager.TrackViewState()	状態の変更の追跡を開始します。 (継承元 DataGridColumn)

適用対象

こちらもご覧ください

フィードバック

このページはお役に立ちましたか?