HyperLinkColumn.Target Eigenschap

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee wordt het doelvenster of het doelframe opgehaald of ingesteld om de inhoud van de webpagina weer te geven waaraan is gekoppeld wanneer op de hyperlink in de kolom wordt geklikt.

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

Waarde van eigenschap

String

Het doelvenster of frame waaraan de webpagina moet worden gekoppeld wanneer op een hyperlink in de kolom wordt geklikt. De standaardwaarde is een lege tekenreeks (""), waarmee het venster of frame met focus wordt vernieuwd.

Kenmerken: TypeConverterAttribute

Voorbeelden

In het volgende voorbeeld ziet u hoe u de Target eigenschap gebruikt om het venster op te geven waarop de inhoud van de webpagina wordt weergegeven die is gekoppeld wanneer op de hyperlink in de kolom wordt geklikt. In dit voorbeeld wordt de gekoppelde webpagina in een nieuw venster weergegeven.

Note

Het volgende codevoorbeeld maakt gebruik van het codemodel met één bestand en werkt mogelijk niet correct als deze rechtstreeks naar een codeachterstaand bestand wordt gekopieerd. Dit codevoorbeeld moet worden gekopieerd naar een leeg tekstbestand met een .aspx-extensie. Zie ASP.NET Web Forms Page Code Model voor meer informatie over het webformuliercodemodel.

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

In het volgende overeenkomstige voorbeeld wordt het item weergegeven dat in het vorige voorbeeld is geselecteerd.

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

Opmerkingen

Gebruik de Target eigenschap om het frame of venster op te geven waaraan de webpagina wordt gekoppeld wanneer op een hyperlink in de kolom wordt geklikt.

Als deze eigenschap niet is ingesteld, wordt de browser of het venster met focus vernieuwd wanneer op een hyperlink in de kolom wordt geklikt.

Note

De Target eigenschap wordt weergegeven als een target kenmerk. Het target kenmerk voor anchor elementen is niet toegestaan in de definitie van het XHTML 1.1-documenttype. Stel de Target eigenschap niet in als de weergegeven uitvoer voor de HyperLinkColumn XHTML 1.1 compatibel moet zijn. Raadpleeg het onderwerp XHTML Standards in Visual Studio en ASP.NET voor meer informatie.

Wanneer u toegankelijke webpagina's maakt, wordt het ten zeerste aangeraden de Target eigenschap te gebruiken om een ander venster te bereiken. Zie ASP.NET Accessibility voor meer informatie.

De Target waarde moet beginnen met een letter in het bereik van A tot Z (hoofdlettergevoelig), met uitzondering van de volgende speciale waarden, die beginnen met een onderstrepingsteken.

Doelwaarde	Description
`_blank`	Geeft de inhoud weer in een nieuw venster zonder frames.
`_parent`	Geeft de inhoud weer in de bovenliggende frameset.
`_search`	Geeft de inhoud weer in het zoekvenster.
`_self`	Geeft de inhoud in het frame weer met de focus.
`_top`	Geeft de inhoud weer in het volledige venster zonder frames.

Note

Raadpleeg de documentatie van uw browser om te bepalen of de _search waarde wordt ondersteund. Internet Explorer 5,0 en hoger ondersteunen bijvoorbeeld de _search doelwaarde.

Van toepassing op

Zie ook

ASP.NET webserverbesturingselementen en browsermogelijkheden

Feedback

Is deze pagina nuttig?