HyperLinkColumn HyperLinkColumn HyperLinkColumn HyperLinkColumn Class

定義

列内の各項目のハイパーリンクを格納する DataGrid コントロールの列型。A column type for the DataGrid control that contains a hyperlink for each item in the column.

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
継承
HyperLinkColumnHyperLinkColumnHyperLinkColumnHyperLinkColumn

次の例は、別のページHyperLinkColumnにリンクするを作成する方法を示しています。The following example demonstrates how to create a HyperLinkColumn that links to a separate page.

注意

次のコードサンプルでは、単一ファイルのコードモデルを使用して、分離コードファイルに直接コピーした場合、正しく機能しない可能性があります。The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. このコードサンプルは、.aspx 拡張子を持つ空のテキストファイルにコピーする必要があります。This code sample must be copied into an empty text file that has an .aspx extension. Web フォームコードモデルの詳細については、「 ASP.NET Web Forms Page Code model」を参照してください。For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

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

次の対応する例では、前の例で選択した項目が表示されます。The following corresponding example displays the item selected in the previous example.

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

注釈

コントロールで列の型を使用して、のDataGrid各行のハイパーリンクを作成します。 HyperLinkColumn DataGridUse the HyperLinkColumn column type in a DataGrid control to create a hyperlink for each row in the DataGrid. ハイパーリンクのTextキャプションテキストを指定するには、プロパティを設定します。Set the Text property to specify the caption text for the hyperlink. ハイパーリンクをクリックしたときにリンクする URL を指定するにはNavigateUrl 、プロパティを設定します。To specify the URL to link to when the hyperlink is clicked, set the NavigateUrl property.

注意

プロパティTextNavigateUrlプロパティを設定した場合、列内のすべてのハイパーリンクが同じキャプションと URL を共有します。If you set the Text and NavigateUrl properties, all hyperlinks in the column will share the same caption and URL.

また、プロパティHyperLinkColumn TextNavigateUrlプロパティを設定する代わりに、内のハイパーリンクのテキストキャプションと URL を、データソース内のフィールドにバインドすることもできます。You can also bind the text caption and URL of the hyperlinks in the HyperLinkColumn to a field in a data source instead of setting the Text and NavigateUrl properties. これにより、別のキャプションを表示したり、列内の各ハイパーリンクに別の URL を指定したりすることができます。This allows you to display a different caption and to specify a different URL for each hyperlink in the column.

DataTextFieldプロパティを使用して、列内のハイパーリンクのテキストキャプションにバインドするデータソースのフィールドを指定します。Use the DataTextField property to specify a field in a data source to bind to the text caption of the hyperlinks in the column.

注意

プロパティDataTextFieldTextプロパティの両方を同時に設定することはできません。The DataTextField and Text properties cannot both be set at the same time. 両方のプロパティが設定されDataTextFieldている場合は、プロパティが優先されます。If both properties are set, the DataTextField property takes precedence.

DataNavigateUrlFieldプロパティを設定して、ハイパーリンクの URL にバインドするフィールドを指定します。Specify the field to bind to the URL of the hyperlink by setting the DataNavigateUrlField property.

注意

プロパティDataNavigateUrlFieldNavigateUrlプロパティの両方を同時に設定することはできません。The DataNavigateUrlField and NavigateUrl properties cannot both be set at the same time. 両方のプロパティが設定されDataNavigateUrlFieldている場合は、プロパティが優先されます。If both properties are set, the DataNavigateUrlField property takes precedence.

Targetプロパティを使用すると、ハイパーリンクをクリックしたときにリンクされている Web ページの内容を表示するウィンドウまたはフレームを指定できます。The Target property allows you to specify the window or frame to display the Web page content linked to when the hyperlink is clicked.

データバインディングを使用する場合は、プロパティDataTextFormatStringDataNavigateUrlFormatStringプロパティをそれぞれ設定することにより、ハイパーリンクのテキストキャプションと URL を書式設定できます。When using data binding, you can format the text caption and URL of the hyperlink by setting the DataTextFormatString and DataNavigateUrlFormatString properties, respectively.

注意事項

このコントロールを使用して、悪意のあるクライアントスクリプトを含む可能性のあるユーザー入力を表示できます。This control can be used to display user input, which might include malicious client script. アプリケーションに表示する前に、実行可能スクリプト、SQL ステートメント、またはその他のコードに対してクライアントから送信された情報を確認してください。Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. コントロールに入力テキストを表示する前に、検証コントロールを使用してユーザー入力を検証することができます。You can use validation controls to verify user input before displaying the input text in a control. ASP.NET には、ユーザー入力でスクリプトと HTML をブロックする入力要求の検証機能が用意されています。ASP.NET provides an input request validation feature to block script and HTML in user input. 詳細については、「標準コントロールのセキュリティ保護」を参照してください。文字列に HTML エンコーディングを適用し、 ASP.NET Web ページでユーザー入力を検証することにより、Web アプリケーションのスクリプト攻略を防止します。For more information, see Securing Standard Controls, How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings, and Validating User Input in ASP.NET Web Pages.

コンストラクター

HyperLinkColumn() HyperLinkColumn() HyperLinkColumn() HyperLinkColumn()

HyperLinkColumn クラスの新しいインスタンスを初期化します。Initializes a new instance of the HyperLinkColumn class.

プロパティ

DataNavigateUrlField DataNavigateUrlField DataNavigateUrlField DataNavigateUrlField

HyperLinkColumn 内のハイパーリンクの URL にバインドするデータ ソースのフィールドを取得または設定します。Gets or sets the field from a data source to bind to the URL of the hyperlinks in the HyperLinkColumn.

DataNavigateUrlFormatString DataNavigateUrlFormatString DataNavigateUrlFormatString DataNavigateUrlFormatString

URL がデータ ソースのフィールドにデータ バインドされる場合の、HyperLinkColumn 内のハイパーリンクの URL の表示形式を取得または設定します。Gets or sets the display format for the URL of the hyperlinks in the HyperLinkColumn when the URL is data-bound to a field in a data source.

DataTextField DataTextField DataTextField DataTextField

HyperLinkColumn 内のハイパーリンクのテキスト キャプションにバインドするデータ ソースのフィールドを取得または設定します。Gets or sets the field from a data source to bind to the text caption of the hyperlinks in the HyperLinkColumn.

DataTextFormatString DataTextFormatString DataTextFormatString DataTextFormatString

HyperLinkColumn 列内のハイパーリンクのテキスト キャプションの表示形式を取得または設定します。Gets or sets the display format for the text caption of the hyperlinks in the HyperLinkColumn column.

DesignMode DesignMode DesignMode DesignMode

列がデザイン モードかどうかを示す値を取得します。Gets a value that indicates whether the column is in design mode.

(Inherited from DataGridColumn)
FooterStyle FooterStyle FooterStyle FooterStyle

列のフッター セクションのスタイル プロパティを取得します。Gets the style properties for the footer section of the column.

(Inherited from DataGridColumn)
FooterText FooterText FooterText FooterText

列のフッター セクションに表示されるテキストを取得または設定します。Gets or sets the text displayed in the footer section of the column.

(Inherited from DataGridColumn)
HeaderImageUrl HeaderImageUrl HeaderImageUrl HeaderImageUrl

列のヘッダー セクションに表示するイメージの位置を取得または設定します。Gets or sets the location of an image to display in the header section of the column.

(Inherited from DataGridColumn)
HeaderStyle HeaderStyle HeaderStyle HeaderStyle

列のヘッダー セクションのスタイル プロパティを取得します。Gets the style properties for the header section of the column.

(Inherited from DataGridColumn)
HeaderText HeaderText HeaderText HeaderText

列のヘッダー セクションに表示されるテキストを取得または設定します。Gets or sets the text displayed in the header section of the column.

(Inherited from DataGridColumn)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

列がビューステートの変化を追跡しているかどうかを示す値を取得します。Gets a value that indicates whether the column is tracking view state changes.

(Inherited from DataGridColumn)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

DataGridColumn オブジェクトが状態を保存するようにマークされているかどうかを判断する値を取得します。Gets a value that determines whether the DataGridColumn object is marked to save its state.

(Inherited from DataGridColumn)
ItemStyle ItemStyle ItemStyle ItemStyle

列の項目セルのスタイル プロパティを取得します。Gets the style properties for the item cells of the column.

(Inherited from DataGridColumn)
NavigateUrl NavigateUrl NavigateUrl NavigateUrl

列内のハイパーリンクがクリックされたときのリンク先の URL を取得または設定します。Gets or sets the URL to link to when a hyperlink in the column is clicked.

Owner Owner Owner Owner

列がメンバーとして含まれている DataGrid コントロールを取得します。Gets the DataGrid control that the column is a member of.

(Inherited from DataGridColumn)
SortExpression SortExpression SortExpression SortExpression

並べ替えのために列が選択された場合に、OnSortCommand(DataGridSortCommandEventArgs) メソッドに渡されるフィールドの名前または式を、取得または設定します。Gets or sets the name of the field or expression to pass to the OnSortCommand(DataGridSortCommandEventArgs) method when a column is selected for sorting.

(Inherited from DataGridColumn)
Target Target Target Target

列内のハイパーリンクがクリックされたときのリンク先 Web ページの内容を表示する、表示先のウィンドウまたはフレームを取得または設定します。Gets or sets the target window or frame to display the Web page content that is linked to when the hyperlink in the column is clicked.

Text Text Text Text

列内のハイパーリンク用に表示するテキスト キャプションを取得または設定します。Gets or sets the text caption to display for the hyperlinks in the column.

ViewState ViewState ViewState ViewState

StateBag クラスから派生した列がそのプロパティを格納できるようにする DataGridColumn オブジェクトを取得します。Gets the StateBag object that allows a column derived from the DataGridColumn class to store its properties.

(Inherited from DataGridColumn)
Visible Visible Visible Visible

DataGrid コントロールに列を表示するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the column is visible in the DataGrid control.

(Inherited from DataGridColumn)

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
FormatDataNavigateUrlValue(Object) FormatDataNavigateUrlValue(Object) FormatDataNavigateUrlValue(Object) FormatDataNavigateUrlValue(Object)

DataNavigateUrlFormatString プロパティで指定された書式を使用して、データ バインドされた URL を書式設定します。Formats a data-bound URL using the format specified by the DataNavigateUrlFormatString property.

FormatDataTextValue(Object) FormatDataTextValue(Object) FormatDataTextValue(Object) FormatDataTextValue(Object)

DataTextFormatString プロパティで指定された書式を使用して、データ バインドされたテキスト キャプションを書式設定します。Formats a data-bound text caption using the format specified by the DataTextFormatString property.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
Initialize() Initialize() Initialize() Initialize()

DataGridColumn クラスから派生した列を初期状態にリセットする基本実装を提供します。Provides the base implementation to reset a column derived from the DataGridColumn class to its initial state.

InitializeCell(TableCell, Int32, ListItemType) InitializeCell(TableCell, Int32, ListItemType) InitializeCell(TableCell, Int32, ListItemType) InitializeCell(TableCell, Int32, ListItemType)

ハイパーリンクが格納された列を表すセルを初期化します。Initializes the cell representing this column with the contained hyperlink.

LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

DataGridColumn オブジェクトの状態を読み込みます。Loads the state of the DataGridColumn object.

(Inherited from DataGridColumn)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
OnColumnChanged() OnColumnChanged() OnColumnChanged() OnColumnChanged()

OnColumnsChanged() メソッドを呼び出します。Calls the OnColumnsChanged() method.

(Inherited from DataGridColumn)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

DataGridColumn オブジェクトの現在の状態を保存します。Saves the current state of the DataGridColumn object.

(Inherited from DataGridColumn)
ToString() ToString() ToString() ToString()

列の文字列形式を返します。Returns the string representation of the column.

(Inherited from DataGridColumn)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

サーバー コントロールにビューステートの変更を追跡させ、サーバー コントロールの StateBag オブジェクトに変更を格納できるようにします。Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object.

(Inherited from DataGridColumn)

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

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

以前に保存した状態を読み込みます。Loads previously saved state.

(Inherited from DataGridColumn)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

状態の変化を示すオブジェクトを返します。Returns an object containing state changes.

(Inherited from DataGridColumn)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

状態変化の追跡を開始します。Starts tracking state changes.

(Inherited from DataGridColumn)

適用対象

こちらもご覧ください