HyperLinkColumn.Target プロパティ
列内のハイパーリンクがクリックされたときのリンク先 Web ページの内容を表示する、表示先のウィンドウまたはフレームを取得または設定します。
名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
プロパティ値
列内のハイパーリンクがクリックされたときのリンク先の Web ページを読み込む、表示先のウィンドウまたはフレーム。既定値は空の文字列 ("") です。フォーカスのあるウィンドウまたはフレームが更新されます。
解説Target プロパティを使用して、列内のハイパーリンクがクリックされたときのリンク先の Web ページを表示するフレームまたはウィンドウを指定します。
このプロパティが設定されていない場合は、列内のハイパーリンクがクリックされたときに、フォーカスのあるブラウザまたはウィンドウが更新されます。
.gif) メモ |
|---|
| Target プロパティは、target 属性としてレンダリングされます。anchor 要素の target 属性は、XHTML 1.1 の文書型定義では許可されません。HyperLinkColumn の表示出力を XHTML 1.1 に準拠させる必要がある場合は、Target プロパティを設定しないでください。詳細については、「ASP.NET と XHTML」のトピックを参照してください。 ユーザー補助対応の Web ページを作成する場合は、別のウィンドウを対象とする Target プロパティの使用は避けることを強くお勧めします。詳細については、「ASP.NET のユーザー補助」を参照してください。 |
Target 値は、次に示すアンダースコア (_) から始まる特殊な値を除き、大文字と小文字を区別しない A から Z の範囲の文字で始まる必要があります。
| _blank | |
| _parent | |
| _search | |
| _self | |
| _top |
使用例Target プロパティを使用して、列内のハイパーリンクがクリックされたときのリンク先 Web ページの内容を表示するウィンドウを指定する方法の例を次に示します。この例では、新しいウィンドウにリンク先の Web ページを表示します。
| メモ |
|---|
| 次のコード サンプルはシングルファイル コード モデルを使用しており、分離コード ファイルに直接コピーされた場合は正常に動作しない可能性があります。このコード サンプルは、拡張子が .aspx の空のテキスト ファイルにコピーする必要があります。Web フォームのコード モデルの詳細については、「ASP.NET 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" 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" %> <%@ 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>
前述の例で選択された項目を表示する対応する例を次に示します。
<%@ 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>
<%@ 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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照Weblioに収録されているすべての辞書からHyperLinkColumn.Target プロパティを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からHyperLinkColumn.Target プロパティ
を検索
- HyperLinkColumn.Target プロパティのページへのリンク
