TreeView.Target Property

Definition

Ottiene o imposta la finestra o il frame di destinazione in cui visualizzare il contenuto della pagina Web associato a un nodo.Gets or sets the target window or frame in which to display the Web page content that is associated with a node.

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

Property Value

String

Finestra o frame di destinazione in cui visualizzare il contenuto della pagina Web collegata.The target window or frame in which to display the linked Web page content. 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.Values must begin with a letter in the range of A through Z (case insensitive), except for certain special values that begin with an underscore, as shown in the following table.

Valore di destinazioneTarget value Esegue il rendering del contenuto inRenders the content in
_blank Nuova finestra senza frame.A new window without frames.
_parent Elemento padre immediato del set di frame.The immediate frameset parent.
_search Riquadro di ricerca.The search pane.
_self Frame attivo.The frame with focus.
_top Finestra completa senza frame.The full window without frames.

Controllare nella documentazione relativa al browser se è supportato il valore _search.Check your browser documentation to determine if the _search value is supported. Ad esempio, Microsoft Internet Explorer 5.0 e versioni successive supportano il valore di destinazione _search.For example, Microsoft Internet Explorer 5.0 and later supports the _search target value.

Il valore predefinito è una stringa vuota ("") che aggiorna la finestra o il frame attivi.The default is an empty string (""), which refreshes the window or frame with focus.

Examples

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la proprietà Target per visualizzare il contenuto Web collegato a un nodo in una nuova finestra quando si fa clic su tale nodo.The following code example demonstrates how to use the Target property to display the Web content that is linked to a node in a new window when that node 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>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>

Remarks

Utilizzare la proprietà Target per specificare la finestra o il frame in cui visualizzare il contenuto Web collegato a un nodo quando si fa clic su tale nodo.Use the Target property to specify the window or frame in which to display the Web content that is linked to a node when that node is clicked.

Note

Il rendering della proprietà Target viene eseguito come attributo target.The Target property renders as a target attribute. L'attributo target negli elementi anchor non è consentito nel Document Type Definition XHTML 1,1.The target attribute on anchor elements is not allowed in the XHTML 1.1 document type definition. Non impostare la proprietà Target, se l'output di cui è stato eseguito il rendering per il TreeView deve essere conforme a XHTML 1,1.Do not set the Target property, if the rendered output for the TreeView must be XHTML 1.1 compliant. Per altre informazioni, vedere standard XHTML in Visual Studio e ASP.NET.For more information, see XHTML Standards in Visual Studio and ASP.NET.

Quando si creano pagine Web accessibili, è consigliabile evitare di usare la proprietà Target per fare riferimento a un'altra finestra.When creating accessible Web pages, you should avoid using the Target property to target another window. Per altre informazioni, vedere controlli e accessibilità di ASP.NET.For more information, see ASP.NET Controls and Accessibility.

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.The value of this property is stored in view state.

Applies to

See also