TreeView.Target Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta la finestra o il frame di destinazione in cui visualizzare il contenuto della pagina Web associato a un nodo.
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
Valore della proprietà
Finestra o frame di destinazione in cui visualizzare il contenuto della pagina Web collegata. I valori devono iniziare con una lettera compresa tra A e Z, senza distinzione tra maiuscole e minuscole, ad eccezione di determinati valori speciali che iniziano con un carattere di sottolineatura, come illustrato nella tabella riportata di seguito.
Valore di destinazione | Esegue il rendering del contenuto in |
---|---|
_blank | Nuova finestra senza frame. |
_parent | Elemento padre immediato del set di frame. |
_search | Riquadro di ricerca. |
_self | Frame attivo. |
_top | Finestra completa senza frame. |
Nota: controllare la documentazione del browser per determinare se il _search
valore è supportato. Ad esempio, Microsoft Internet Explorer 5.0 e versioni successive supportano il valore di destinazione _search
.
Il valore predefinito è una stringa vuota ("") che aggiorna la finestra o il frame attivi.
Esempio
Nell'esempio di codice seguente viene illustrato come utilizzare la Target proprietà per visualizzare il contenuto Web collegato a un nodo in una nuova finestra quando si fa clic su tale nodo.
<%@ 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>
Commenti
Utilizzare la Target proprietà per specificare la finestra o il frame in cui visualizzare il contenuto Web collegato a un nodo quando si fa clic su tale nodo.
Nota
Il rendering della Target proprietà viene eseguito come target
attributo. L'attributo target
sugli anchor
elementi non è consentito nella definizione del tipo di documento XHTML 1.1. Non impostare la Target proprietà , se l'output di cui è stato eseguito il rendering per deve TreeView essere conforme a XHTML 1.1. Per altre informazioni, vedere Standard XHTML in Visual Studio e ASP.NET.
Quando si creano pagine Web accessibili, è consigliabile evitare di usare la proprietà per impostare come Target destinazione un'altra finestra. Per altre informazioni, vedere ASP.NET Controlli e accessibilità.
Il valore di questa proprietà viene archiviato nello stato di visualizzazione.