HyperLinkField.Target プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文HyperLinkField のハイパーリンクがクリックされたときに、リンク先の Web ページを読み込むウィンドウまたはフレーム。既定値は空の文字列 ("") です。この値は、このプロパティが設定されていないことを示します。
解説ハイパーリンクがクリックされたときに、そのハイパーリンクにリンクされている Web ページの内容を表示するウィンドウまたはフレームを指定するには、Target プロパティを使用します。
値は、次の表に記載されているアンダースコア (_) から始まる特殊な値を除き、大文字小文字を区別しない A から Z の範囲の文字で始まる必要があります。
| 値 | |
|---|---|
| _blank | |
| _parent | |
| _search | |
| _self | |
| _top |
.gif) メモ |
|---|
| ブラウザのドキュメントを参照して、_search 値がサポートされているかどうか確認してください。たとえば、Microsoft Internet Explorer 5.0 以降のバージョンでは _search ターゲット値がサポートされています。 |
| メモ |
|---|
| Target プロパティは、target 属性としてレンダリングされます。anchor 要素の target 属性は、XHTML 1.1 の文書型定義では許可されません。HyperLinkField オブジェクトの表示出力を XHTML 1.1 に準拠させる必要がある場合は、Target プロパティを設定しないでください。詳細については、「ASP.NET と XHTML」のトピックを参照してください。 ユーザー補助対応の Web ページを作成する場合は、別のウィンドウを対象とする Target プロパティの使用は避けることを強くお勧めします。詳細については、「ASP.NET のユーザー補助」を参照してください。 |
使用例Target プロパティを使用し、HyperLinkField オブジェクトのハイパーリンクに関連付けられた Web ページの内容が表示されるウィンドウを指定する方法を次のコード例に示します。ハイパーリンクがクリックされると、リンク先の Web ページが新しいウィンドウに表示されます。
<%@ Page language="VB" %> <html> <body> <form runat="server"> <h3>HyperLinkField Example</h3> <!-- Populate the Columns collection declaratively. --> <!-- Set the HyperLinkField field column to a static --> <!-- caption and URL. --> <asp:gridview id="OrdersGridView" datasourceid="OrdersSqlDataSource" autogeneratecolumns="false" runat="server"> <columns> <asp:boundfield datafield="OrderID" headertext="OrderID"/> <asp:boundfield datafield="CustomerID" headertext="Customer ID"/> <asp:boundfield datafield="OrderDate" headertext="Order Date" dataformatstring="{0:d}" /> <asp:hyperlinkfield text="Details..." navigateurl="~\details.aspx" headertext="Order Details" target="_blank" /> </columns> </asp:gridview> <!-- This example uses Microsoft SQL Server and connects --> <!-- to the Northwind sample database. --> <asp:sqldatasource id="OrdersSqlDataSource" selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]" connectionstring="server=localhost;database=northwind;integrated security=SSPI" runat="server"> </asp:sqldatasource> </form> </body> </html>
<%@ Page language="C#" %> <html> <body> <form runat="server"> <h3>HyperLinkField Example</h3> <!-- Populate the Columns collection declaratively. --> <!-- Set the HyperLinkField field column to a static --> <!-- caption and URL. --> <asp:gridview id="OrdersGridView" datasourceid="OrdersSqlDataSource" autogeneratecolumns="false" runat="server"> <columns> <asp:boundfield datafield="OrderID" headertext="OrderID"/> <asp:boundfield datafield="CustomerID" headertext="Customer ID"/> <asp:boundfield datafield="OrderDate" headertext="Order Date" dataformatstring="{0:d}" /> <asp:hyperlinkfield text="Details..." navigateurl="~\details.aspx" headertext="Order Details" target="_blank" /> </columns> </asp:gridview> <!-- This example uses Microsoft SQL Server and connects --> <!-- to the Northwind sample database. --> <asp:sqldatasource id="OrdersSqlDataSource" selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]" connectionstring="server=localhost;database=northwind;integrated security=SSPI" runat="server"> </asp:sqldatasource> </form> </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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- HyperLinkField.Target プロパティのページへのリンク
