HyperLinkField.Target Eigenschaft

Definition

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.Gets or sets the target window or frame in which to display the Web page linked to when a hyperlink in a HyperLinkField object is clicked.

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.The target window or frame in which to load the Web page linked to when a hyperlink in a HyperLinkField is clicked. Der Standardwert ist eine leere Zeichenfolge ("") und gibt an, dass diese Eigenschaft nicht festgelegt ist.The default is an empty string (""), which indicates that this property is not set.

Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die-Eigenschaft verwendet wird Target , um ein Zielfenster anzugeben, in dem der Inhalt der Webseite angezeigt wird, die einem Link in einem-Objekt zugeordnet ist HyperLinkField .The following code example demonstrates how to use the Target property to specify a target window in which to display the contents of the Web page associated with a hyperlink in a HyperLinkField object. Die verknüpfte Webseite wird in einem neuen Fenster angezeigt, wenn auf den Link geklickt wird.The linked Web page is displayed in a new window when the hyperlink is clicked.


<%@ 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 Hyperlink verknüpfte Webinhalt angezeigt werden soll, wenn auf diesen Link geklickt wird.Use the Target property to specify the window or frame in which to display the Web content linked to a hyperlink when that hyperlink is clicked.

Werte müssen mit einem Buchstaben im Bereich von a bis Z (ohne Beachtung der Groß-/Kleinschreibung) beginnen, mit Ausnahme der in der folgenden Tabelle aufgeführten besonderen Werte, von denen jeder mit einem Unterstrich beginnt.Values must begin with a letter in the range of A through Z (case-insensitive), except for the special values listed in the following table, each of which begins with an underscore.

WertValue BESCHREIBUNGDescription
_blank Stellt den Inhalt in einem neuen Fenster ohne Frames dar.Renders the content in a new window without frames.
_parent Stellt den Inhalt im unmittelbar übergeordneten Frameset dar.Renders the content in the immediate frameset parent.
_search Gibt den Inhalt im Suchbereich wieder.Renders the content in the search pane.
_self Stellt den Inhalt in dem Frame dar, der den Fokus besitzt.Renders the content in the frame with focus.
_top Stellt den Inhalt im gesamten Fenster ohne Frames dar.Renders the content in the full window without frames.

Hinweis

Lesen Sie in der Browserdokumentation nach, ob der _search-Wert unterstützt wird.Check your browser documentation to determine whether the _search value is supported. Beispielsweise unterstützen Microsoft Internet Explorer 5,0 und höhere Versionen den _search Zielwert.For example, Microsoft Internet Explorer 5.0 and later versions support the _search target value.

Hinweis

Die- Target Eigenschaft wird als-Attribut gerendert target .The Target property is rendered as a target attribute. Das- target Attribut für- anchor Elemente ist in der XHTML 1,1-Dokumenttyp Definition nicht zulässig.The target attribute on anchor elements is not allowed in the XHTML 1.1 document type definition. Legen Sie die-Eigenschaft nicht fest, Target Wenn die gerenderte Ausgabe für das HyperLinkField -Objekt XHTML 1,1-kompatibel sein muss.Do not set the Target property if the rendered output for the HyperLinkField object must be XHTML 1.1-compliant. Weitere Informationen finden Sie im Thema XHTML Standards in Visual Studio und ASP.net.For more information, refer to the topic XHTML Standards in Visual Studio and ASP.NET.

Wenn Sie barrierefreie Webseiten erstellen, wird dringend empfohlen, die Verwendung der- Target Eigenschaft für ein anderes Fenster zu vermeiden.When creating accessible Web pages, it is strongly recommended you avoid using the Target property to target another window. Weitere Informationen finden Sie unter ASP.net Accessibility.For more information, see ASP.NET Accessibility.

Gilt für:

Siehe auch