HyperLinkField.Target Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Hiermee haalt u het doelvenster of het doelframe op waarin de webpagina moet worden weergegeven die is gekoppeld wanneer op een hyperlink in een HyperLinkField object wordt geklikt.

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

Waarde van eigenschap

String

Het doelvenster of frame waarin de webpagina moet worden geladen die is gekoppeld wanneer op een hyperlink in een HyperLinkField hyperlink wordt geklikt. De standaardwaarde is een lege tekenreeks (""), die aangeeft dat deze eigenschap niet is ingesteld.

Kenmerken
TypeConverterAttribute

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de Target eigenschap gebruikt om een doelvenster op te geven waarin de inhoud van de webpagina wordt weergegeven die is gekoppeld aan een hyperlink in een HyperLinkField object. De gekoppelde webpagina wordt weergegeven in een nieuw venster wanneer op de hyperlink wordt geklikt.


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

Opmerkingen

Gebruik de Target eigenschap om het venster of frame op te geven waarin de webinhoud wordt weergegeven die is gekoppeld aan een hyperlink wanneer erop wordt geklikt.

Waarden moeten beginnen met een letter in het bereik van A tot en met Z (hoofdlettergevoelig), met uitzondering van de speciale waarden in de volgende tabel, die elk beginnen met een onderstrepingsteken.

Waarde Beschrijving
_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 browserdocumentatie om te bepalen of de _search waarde wordt ondersteund. Microsoft Internet Explorer 5.0 en latere versies ondersteunen bijvoorbeeld de doelwaarde _search.

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 het HyperLinkField object 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.

Van toepassing op

Zie ook