HyperLinkColumn.Target Vlastnost

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 pro zobrazení obsahu webové stránky, který je propojen s hypertextovým odkazem ve sloupci je kliknutí.

public:
 virtual property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };

public virtual string Target { get; set; }

[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public virtual string Target { get; set; }

member this.Target : string with 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 pro načtení webové stránky propojené s hypertextovým odkazem ve sloupci. Výchozí hodnota je prázdný řetězec (""), který aktualizuje okno nebo rámeček s fokusem.

Atributy: TypeConverterAttribute

Příklady

Následující příklad ukazuje, jak pomocí Target vlastnosti určit okno pro zobrazení obsahu webové stránky propojené s při kliknutí na hypertextový odkaz ve sloupci. Tento příklad zobrazí propojenou webovou stránku v novém okně.

Poznámka:

Následující ukázka kódu používá model kódu s jedním souborem a při kopírování přímo do souboru s kódem nemusí správně fungovat. Tento vzorový kód musí být zkopírován do prázdného textového souboru, který má příponu .aspx. Další informace o modelu kódu webového formuláře najdete v tématu ASP.NET model kódu stránky webového formuláře.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!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>
    <title>HyperLinkColumn Example</title>
<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 id="form1" 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" %>
<%@ Import Namespace="System.Data" %>

<!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>
    <title>HyperLinkColumn Example</title>
<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 id="form1" 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>

Následující odpovídající příklad zobrazí položku vybranou v předchozím příkladu.

<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>
    <title>Details page for DataGrid</title>
<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>

<%@ Page Language="VB" AutoEventWireup="True" %>
<!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>
    <title>Details page for DataGrid</title>
<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>

Poznámky

Target Vlastnost slouží k určení rámce nebo okna, na kterém je webová stránka propojená, když se klikne na hypertextový odkaz ve sloupci.

Pokud tato vlastnost není nastavená, prohlížeč nebo okno s fokusem se při kliknutí na hypertextový odkaz ve sloupci aktualizuje.

Poznámka:

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

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

Hodnota Target musí začínat písmenem v rozsahu A až Z (nerozlišuje velká a malá písmena), s výjimkou následujících speciálních hodnot, které začínají podtržítkem.

Cílová hodnota	Description
`_blank`	Vykreslí obsah v novém okně bez rámců.
`_parent`	Vykreslí obsah v nadřazené sadě snímků.
`_search`	Vykreslí obsah v podokně hledání.
`_self`	Vykreslí obsah v rámci s fokusem.
`_top`	Vykreslí obsah v úplném okně bez rámců.

Poznámka:

Zkontrolujte dokumentaci k prohlížeči a zjistěte, jestli je hodnota podporovaná _search . Například Internet Explorer 5.0 a vyšší podporují _search cílovou hodnotu.

Platí pro

Viz také

ASP.NET ovládací prvky webového serveru a možnosti prohlížeče

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

HyperLinkColumn.Target Vlastnost

Definice

Hodnota vlastnosti

Příklady

Poznámky

Platí pro

Viz také

Váš názor