HyperLinkColumn.Text プロパティ
列内のハイパーリンク用に表示するテキスト キャプションを取得または設定します。
Public Overridable Property Text As String
[C#]
public virtual string Text {get; set;}
[C++]
public: __property virtual String* get_Text();public: __property virtual void set_Text(String*);
[JScript]
public function get Text() : String;public function set Text(String);
プロパティ値
列内のハイパーリンクのテキスト キャプション。既定値は String.Empty です。
解説
Text プロパティを使用して、列内のハイパーリンク用に表示するテキスト キャプションを指定します。
メモ このプロパティを設定すると、列内のすべてのハイパーリンクが同じテキスト キャプションを共有します。
列内の各ハイパーリンクに個別のテキスト キャプションを指定するには、 DataTextField プロパティを使用します。
メモ DataTextField プロパティと Text プロパティの両方を同時には設定できません。両方のプロパティが設定されている場合は、 DataTextField プロパティが優先されます。
注意 テキストは、 HyperLinkColumn に表示されるまで HTML エンコードされません。そのため、テキストの HTML タグ内にスクリプトを埋め込むことが可能となっています。この列の値がユーザー入力による値の場合は、セキュリティ上の危険性を低減するために、必ず値を検証するようにしてください。
使用例
[Visual Basic, C#] Text プロパティを使用して HyperLinkColumn 内のハイパーリンクのテキスト キャプションを指定する方法の例を次に示します。列内のすべてのハイパーリンクのテキスト キャプションは同じになります。
<%@ 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"
href="detailspage.aspx"
Text="Click Me"
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"
href="detailspage.aspx"
Text="Click Me"
Target="_blank"/>
</Columns>
</asp:DataGrid>
</form>
</body>
</html>
[Visual Basic, C#] 前述の例のハイパーリンクがクリックされたときのリンク先となるサンプルの Web フォーム ページを次の対応する例に示します。
<%@ Page Language="VB" %>
<html>
<head>
</head>
<body>
<h3>Details page for DataGrid</h3>
Welcome to the new page.
</body>
</html>
[C#]
<%@ Page Language="C#" %>
<html>
<head>
</head>
<body>
<h3>Details page for DataGrid</h3>
Welcome to the new page.
</body>
</html>
[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。
必要条件
プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ
参照
HyperLinkColumn クラス | HyperLinkColumn メンバ | System.Web.UI.WebControls 名前空間 | href | DataTextField