Freigeben über

HyperLinkField.Target Eigenschaft

Definition

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

Ruft das Zielfenster oder den Zielrahmen ab, in dem die Webseite angezeigt werden soll, die verknüpft ist, wenn auf einen Link in einem HyperLinkField Objekt geklickt wird, oder legt diesen fest.

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

Eigenschaftswert

String

Das Zielfenster oder -frame, in dem die Webseite geladen werden soll, die verknüpft ist, wenn auf einen Link in einem HyperLinkField Link geklickt wird. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass diese Eigenschaft nicht festgelegt ist.

Attribute
TypeConverterAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Target Eigenschaft verwendet wird, um ein Zielfenster anzugeben, in dem der Inhalt der Webseite angezeigt wird, die einem Hyperlink in einem HyperLinkField Objekt zugeordnet ist. Die verknüpfte Webseite wird in einem neuen Fenster angezeigt, wenn auf den Link geklickt wird.


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

Hinweise

Verwenden Sie die Target Eigenschaft, um das Fenster oder den Rahmen anzugeben, in dem der Webinhalt angezeigt werden soll, der mit einem Link verknüpft ist, wenn auf diesen Link geklickt wird.

Werte müssen mit einem Buchstaben im Bereich von A bis Z beginnen (Groß-/Kleinschreibung wird nicht beachtet), mit Ausnahme der in der folgenden Tabelle aufgeführten speziellen Werte, die jeweils mit einem Unterstrich beginnen.

Wert Beschreibung
_blank Rendert den Inhalt in einem neuen Fenster ohne Frames.
_parent Rendert den Inhalt im übergeordneten Direktframeet.
_search Rendert den Inhalt im Suchbereich.
_self Rendert den Inhalt im Frame mit Fokus.
_top Rendert den Inhalt im vollständigen Fenster ohne Frames.

Hinweis

Überprüfen Sie ihre Browserdokumentation, um zu ermitteln, ob der _search Wert unterstützt wird. Beispielsweise unterstützen Microsoft Internet Explorer 5.0 und höhere Versionen den _search Zielwert.

Hinweis

Die Target Eigenschaft wird als target Attribut gerendert. Das target Attribut für anchor Elemente ist in der XHTML 1.1-Dokumenttypdefinition nicht zulässig. Legen Sie die Target Eigenschaft nicht fest, wenn die gerenderte Ausgabe für das HyperLinkField Objekt XHTML 1.1-kompatibel sein muss. Weitere Informationen finden Sie im Thema XHTML Standards in Visual Studio und ASP.NET.

Beim Erstellen barrierefreier Webseiten wird dringend empfohlen, die Verwendung der Target Eigenschaft für ein anderes Fenster zu vermeiden. Weitere Informationen finden Sie unter ASP.NET Barrierefreiheit.

Gilt für:

Weitere Informationen