HyperLinkField.Target Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Sdílet prostřednictvím