TreeView.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 einem Knoten zugeordneten Webseiteninhalte angezeigt werden sollen, oder legt dieses Zielfenster bzw. den Zielframe fest.

public:
 property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };

public string Target { get; set; }

member this.Target : string with get, set

Public Property Target As String

Eigenschaftswert

String

Das Zielfenster oder der Zielframe, in dem der verknüpfte Webseiteninhalt angezeigt werden soll. Werte müssen mit einem Buchstaben von A bis Z (ohne Berücksichtigung der Groß- und Kleinschreibung) beginnen, mit Ausnahme der in folgender Tabelle aufgeführten speziellen Werte, die mit einem Unterstrich beginnen:

Zielwert	Rendern des Inhalts in
`_blank`	Einem neuen Fenster ohne Frames.
`_parent`	Dem unmittelbar übergeordneten Frameset.
`_search`	Dem Suchbereich.
`_self`	Dem Frame mit dem Fokus.
`_top`	Dem gesamten Fenster ohne Frames.

Hinweis: Überprüfen Sie ihre Browserdokumentation, um festzustellen, ob der _search Wert unterstützt wird. Beispielsweise unterstützt Microsoft Internet Explorer 5.0 und höher den _search-Zielwert.

Der Standardwert ist eine leere Zeichenfolge (""), die das Fenster oder den Frame mit dem Fokus aktualisiert.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der Target -Eigenschaft den Webinhalt anzeigen, der mit einem Knoten in einem neuen Fenster verknüpft ist, wenn auf diesen Knoten 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>TreeView Target Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView Target Example</h3>
      
      <asp:TreeView id="LinksTreeView"
         Target="_blank" 
         runat="server">
         
        <Nodes>
        
          <asp:TreeNode Value="Home" 
            NavigateUrl="Home.aspx" 
            Text="Home"
            Expanded="True">
             
            <asp:TreeNode Value="Page 1" 
              NavigateUrl="Page1.aspx" 
              Text="Page1">
               
              <asp:TreeNode Value="Section 1" 
                NavigateUrl="Section1.aspx" 
                Text="Section 1"/>
                 
            </asp:TreeNode>              
            
            <asp:TreeNode Value="Page 2" 
              NavigateUrl="Page2.aspx"
              Text="Page 2">
               
            </asp:TreeNode> 
            
          </asp:TreeNode>
        
        </Nodes>
        
      </asp:TreeView>

    </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>TreeView Target Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView Target Example</h3>
      
      <asp:TreeView id="LinksTreeView"
         Target="_blank" 
         runat="server">
         
        <Nodes>
        
          <asp:TreeNode Value="Home" 
            NavigateUrl="Home.aspx" 
            Text="Home"
            Expanded="True">
             
            <asp:TreeNode Value="Page 1" 
              NavigateUrl="Page1.aspx" 
              Text="Page1">
               
              <asp:TreeNode Value="Section 1" 
                NavigateUrl="Section1.aspx" 
                Text="Section 1"/>
                 
            </asp:TreeNode>              
            
            <asp:TreeNode Value="Page 2" 
              NavigateUrl="Page2.aspx"
              Text="Page 2">
               
            </asp:TreeNode> 
            
          </asp:TreeNode>
        
        </Nodes>
        
      </asp:TreeView>

    </form>
  </body>
</html>

Hinweise

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

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 XHTML TreeView 1.1-konform sein muss. Weitere Informationen finden Sie unter XHTML-Standards in Visual Studio und ASP.NET.

Beim Erstellen barrierefreier Webseiten sollten Sie vermeiden, die Target -Eigenschaft als Ziel für ein anderes Fenster zu verwenden. Weitere Informationen finden Sie unter ASP.NET-Steuerelemente und Barrierefreiheit.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Gilt für:

Weitere Informationen

Target