HyperLinkColumn.Target プロパティ
列内のハイパーリンクがクリックされたときのリンク先 Web ページの内容を表示する、表示先のウィンドウまたはフレームを取得または設定します。
Public Overridable Property Target As String
[C#]
public virtual string Target {get; set;}
[C++]
public: __property virtual String* get_Target();public: __property virtual void set_Target(String*);
[JScript]
public function get Target() : String;public function set Target(String);
プロパティ値
列内のハイパーリンクがクリックされたときのリンク先の Web ページを読み込む、表示先のウィンドウまたはフレーム。値は、大文字と小文字を区別しない a から z の範囲の文字で始める必要があります。ただし、次に示すアンダースコア (_) で始まる特殊な値を除きます。
_blank | フレームなしの新しいウィンドウに内容を表示します。 |
_parent | 直前のフレームセットの親に内容を表示します。 |
_self | フォーカスのあるフレームに内容を表示します。 |
_top | 最大化されたフレームなしのウィンドウに内容を表示します。 |
既定値は String.Empty です。
解説
Target プロパティを使用して、列内のハイパーリンクがクリックされたときのリンク先の Web ページを表示するフレームまたはウィンドウを指定します。
このプロパティが設定されていない場合は、列内のハイパーリンクがクリックされたときに、フォーカスのあるブラウザまたはウィンドウが更新されます。
使用例
[Visual Basic, C#] Target プロパティを使用して、列内のハイパーリンクがクリックされたときのリンク先 Web ページの内容を表示するウィンドウを指定する方法の例を次に示します。この例では、新しいウィンドウにリンク先の Web ページを表示します。
<%@ 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"
DatahrefField="IntegerValue"
DatahrefFormatString="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"
DatahrefField="IntegerValue"
DatahrefFormatString="detailspage.aspx?id={0}"
DataTextField="PriceValue"
DataTextFormatString="{0:c}"
Target="_blank"/>
</Columns>
</asp:DataGrid>
</form>
</body>
</html>
[Visual Basic, C#] 前述の例で選択された項目を表示する対応する例を次に示します。
<%@ 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>
[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ
参照
HyperLinkColumn クラス | HyperLinkColumn メンバ | System.Web.UI.WebControls 名前空間