TreeNodeBinding.Target Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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 a cui è applicato l'oggetto TreeNodeBinding.

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à

String

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	Descrizione
`_blank`	Visualizza il contenuto in una nuova finestra senza frame.
`_parent`	Visualizza il contenuto nell'elemento padre immediato del set di frame.
`_search`	Visualizza il contenuto nel riquadro di ricerca.
`_self`	Consente di visualizzare il contenuto nel frame attivo.
`_top`	Visualizza il contenuto in tutta la finestra 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

In questa sezione sono riportati due esempi di codice. Nel primo esempio di codice viene illustrato come utilizzare la Target proprietà per specificare che la pagina Web associata al nodo radice deve essere visualizzata in una nuova finestra. Nel secondo esempio di codice vengono forniti dati XML di esempio per il primo esempio di codice.

Nell'esempio seguente viene illustrato come utilizzare la Target proprietà per specificare che la pagina Web associata al nodo radice deve essere visualizzata in una nuova finestra. Per il corretto funzionamento di questo esempio, è necessario copiare i dati XML di esempio, forniti dopo questo esempio di codice, in un file denominato Book.xml.


<%@ 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>TreeNodeBinding Target Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeBinding Target Example</h3>
    
      <!-- Clicking the root node will navigate  -->
      <!-- the user to another page. Because the -->
      <!-- Target property is set to "_blank",   -->
      <!-- the linked page is displayed in a new -->
      <!-- window.                               -->
      <asp:TreeView id="BookTreeView" 
         DataSourceID="BookXmlDataSource"
         runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="0" 
            TextField="Title"
            NavigateUrl="~\Page1.aspx"
            Target="_blank"/>
          <asp:TreeNodeBinding DataMember="Chapter" 
            Depth="1" 
            TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Appendix" 
            Depth="1" 
            TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
         DataFile="Book.xml"
         runat="server">
      </asp:XmlDataSource>
    
    </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>TreeNodeBinding Target Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeBinding Target Example</h3>
    
      <!-- Clicking the root node will navigate  -->
      <!-- the user to another page. Because the -->
      <!-- Target property is set to "_blank",   -->
      <!-- the linked page is displayed in a new -->
      <!-- window.                               -->
      <asp:TreeView id="BookTreeView" 
         DataSourceID="BookXmlDataSource"
         runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="0" 
            TextField="Title"
            NavigateUrl="~\Page1.aspx"
            Target="_blank"/>
          <asp:TreeNodeBinding DataMember="Chapter" 
            Depth="1" 
            TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Appendix" 
            Depth="1" 
            TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
         DataFile="Book.xml"
         runat="server">
      </asp:XmlDataSource>
    
    </form>
  </body>
</html>

Nell'esempio di codice seguente vengono forniti dati XML di esempio per l'esempio di codice precedente.

<Book Title="Book Title">  
    <Chapter Heading="Chapter 1">  
        <Section Heading="Section 1">  
        </Section>  
        <Section Heading="Section 2">  
        </Section>  
    </Chapter>  
    <Chapter Heading="Chapter 2">  
        <Section Heading="Section 1">  
        </Section>  
    </Chapter>  
    <Appendix Heading="Appendix A">  
    </Appendix>  
</Book>

Commenti

Quando il TreeView controllo è associato a un'origine dati, utilizzare la Target proprietà per specificare il valore da associare alla Target proprietà di un TreeNode oggetto . Questa relazione di associazione influisce su tutti gli TreeNode oggetti a cui viene applicato l'oggetto TreeNodeBinding . La Target proprietà viene utilizzata 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

L'impostazione della proprietà esegue l'override Target Target della proprietà del TreeView controllo per i nodi a cui viene applicato l'oggetto TreeNodeBinding . È possibile eseguire l'override selettiva della Target proprietà impostando direttamente la Target proprietà di ogni 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 il TreeNodeBinding controllo deve 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 Accessibilità.

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.

Si applica a