Sdílet prostřednictvím

HyperLinkField.Target Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví cílové okno nebo rámec, ve kterém se má zobrazit webová stránka odkaz při kliknutí na hypertextový odkaz v objektu HyperLinkField .

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

Hodnota vlastnosti

String

Cílové okno nebo rámec, do kterého se má načíst webová stránka propojená při kliknutí na hypertextový odkaz v objektu HyperLinkField . Výchozí hodnota je prázdný řetězec (""), který označuje, že tato vlastnost není nastavena.

Atributy
TypeConverterAttribute

Příklady

Následující příklad kódu ukazuje, jak použít Target vlastnost k určení cílového okna, ve kterém chcete zobrazit obsah webové stránky přidružené k hypertextovému odkazu v objektu HyperLinkField . Odkazovaná webová stránka se zobrazí v novém okně při kliknutí na hypertextový odkaz.


<%@ 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>

Poznámky

Target Pomocí vlastnosti určete okno nebo rámec, ve kterém se má zobrazit webový obsah propojený s hypertextovým odkazem při kliknutí na tento hypertextový odkaz.

Hodnoty musí začínat písmenem v rozsahu A až Z (nerozlišují se malá a velká písmena), s výjimkou speciálních hodnot uvedených v následující tabulce, z nichž každá začíná podtržítkem.

Hodnota Popis
_blank Vykreslí obsah v novém okně bez rámců.
_parent Vykreslí obsah v bezprostředně nadřazené sadě rámců.
_search Vykreslí obsah v podokně hledání.
_self Vykreslí obsah v rámci s fokusem.
_top Vykreslí obsah v celém okně bez snímků.

Poznámka

Projděte si dokumentaci k prohlížeči a zjistěte, jestli je tato _search hodnota podporovaná. Například Microsoft Internet Explorer 5.0 a novější verze podporují _search cílovou hodnotu.

Poznámka

Vlastnost se Target vykreslí jako target atribut. Atribut target elementů anchor není povolen v definici typu dokumentu XHTML 1.1. Nenastavujte Target vlastnost, pokud vykreslený výstup pro HyperLinkField objekt musí být kompatibilní s XHTML 1.1. Další informace najdete v tématu Standardy XHTML v sadě Visual Studio a ASP.NET.

Při vytváření přístupných webových stránek se důrazně doporučuje vyhnout se použití Target vlastnosti k cílení na jiné okno. Další informace najdete v tématu ASP.NET Usnadnění.

Platí pro

Viz také