HyperLinkField.Target Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft das Zielfenster oder den Zielframe ab, in dem die verknüpfte Webseite beim Klicken auf einen Link in einem HyperLinkField-Objekt angezeigt werden soll, oder legt dieses Fenster bzw. diesen Frame 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 der Zielframe, in dem die verknüpfte Webseite dargestellt werden soll, wenn auf einen Link in einer HyperLinkField geklickt wird. Der Standardwert ist eine leere Zeichenfolge ("") und gibt an, dass diese Eigenschaft nicht festgelegt ist.

Attribute: TypeConverterAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe der Target -Eigenschaft ein Zielfenster angegeben wird, in dem der Inhalt der Webseite angezeigt werden soll, die einem Link 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 Frame anzugeben, in dem der mit einem Link verknüpfte Webinhalt angezeigt werden soll, wenn auf diesen Link geklickt wird.

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

Wert	BESCHREIBUNG
`_blank`	Stellt den Inhalt in einem neuen Fenster ohne Frames dar.
`_parent`	Stellt den Inhalt im unmittelbar übergeordneten Frameset dar.
`_search`	Gibt den Inhalt im Suchbereich wieder.
`_self`	Stellt den Inhalt in dem Frame dar, der den Fokus besitzt.
`_top`	Stellt den Inhalt im gesamten Fenster ohne Frames dar.

Hinweis

Lesen Sie in der Browserdokumentation nach, 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-konform sein muss. Weitere Informationen finden Sie im Thema XHTML-Standards in Visual Studio und ASP.NET.

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

Gilt für:

Freigeben über