HyperLinkField.Target プロパティ

定義

HyperLinkField オブジェクトのハイパーリンクがクリックされたときに、リンク先の Web ページを表示するウィンドウまたはフレームを取得または設定します。

public:
 virtual property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public virtual string Target { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set
Public Overridable Property Target As String

プロパティ値

HyperLinkField のハイパーリンクがクリックされたときに、リンク先の Web ページを読み込むウィンドウまたはフレーム。 既定値は空の文字列 ("") です。このプロパティが設定されていないことを示します。

属性

次のコード例では、 プロパティを Target 使用して、オブジェクト内のハイパーリンクに関連付けられている Web ページの内容を表示するターゲット ウィンドウを指定する方法を HyperLinkField 示します。 リンクされた Web ページは、ハイパーリンクをクリックすると新しいウィンドウに表示されます。


<%@ Page language="C#" %>

<!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 runat="server">
    <title>HyperLinkField Example</title>
</head>
<body>
    <form id="form1" 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="VB" %>

<!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 runat="server">
    <title>HyperLinkField Example</title>
</head>
<body>
    <form id="form1" 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>

注釈

プロパティを Target 使用して、ハイパーリンクがクリックされたときにハイパーリンクにリンクされた Web コンテンツを表示するウィンドウまたはフレームを指定します。

値は、次の表に示す特殊な値を除き、A ~ Z の範囲の文字で始まる必要があります (大文字と小文字は区別されません)。各値はアンダースコアで始まります。

説明
_blank フレームなしの新しいウィンドウに内容を表示します。
_parent 直前のフレームセットの親に内容を表示します。
_search 検索ペインに内容を表示します。
_self フォーカスのあるフレームに内容を表示します。
_top 最大化されたフレームなしのウィンドウに内容を表示します。

注意

ブラウザーのドキュメントを参照して、_search 値がサポートされているかどうか確認してください。 たとえば、Microsoft Internet Explorer 5.0 以降のバージョンでは、ターゲット値が _search サポートされています。

注意

プロパティは Target 属性として target レンダリングされます。 要素の anchor 属性はtarget、XHTML 1.1 ドキュメント型定義では使用できません。 オブジェクトの Target レンダリングされた出力 HyperLinkField が XHTML 1.1 に準拠している必要がある場合は、 プロパティを設定しないでください。 詳細については、「 Visual Studio の XHTML 標準」および「ASP.NET」を参照してください。

アクセス可能な Web ページを作成する場合は、 プロパティを使用して別のウィンドウを Target ターゲットにしないようにすることを強くお勧めします。 詳細については、「 アクセシビリティの ASP.NET」を参照してください。

適用対象

こちらもご覧ください