TreeNodeBinding.DataMember Proprietà

Definizione

Ottiene o imposta il valore da confrontare con una proprietà Type di un elemento dati per determinare se applicare l'associazione di nodi della struttura ad albero.Gets or sets the value to match against a Type property for a data item to determine whether to apply the tree node binding.

public:
 property System::String ^ DataMember { System::String ^ get(); void set(System::String ^ value); };
public string DataMember { get; set; }
member this.DataMember : string with get, set
Public Property DataMember As String

Valore della proprietà

String

Valore da confrontare con la proprietà Type di un elemento di dati per determinare se applicare l'associazione di nodi della struttura ad albero.The value to match against a data item's Type property to determine whether to apply the tree node binding. Il valore predefinito è una stringa vuota (""), che indica che la proprietà DataMember non è impostata.The default is an empty string (""), which indicates that the DataMember property is not set.

Esempio

In questa sezione sono riportati due esempi di codice.This section contains two code examples. Nel primo esempio di codice viene illustrato come utilizzare la DataMember proprietà per specificare l'elemento XML da associare a un nodo.The first code example demonstrates how to use the DataMember property to specify which XML element to bind to a node. Il secondo esempio di codice fornisce dati XML di esempio per il primo esempio di codice.The second code example provides sample XML data for the first code example.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la DataMember proprietà per specificare l'elemento XML da associare a un nodo.The following code example demonstrates how to use the DataMember property to specify which XML element to bind to a node. Per il corretto funzionamento di questo esempio di codice, è necessario copiare i dati XML di esempio, forniti dopo questo esempio di codice, in un file denominato Book.xml.For this code example to work correctly, you must copy the sample XML data, provided after this code example, to a file named 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>TreeViewBinding DataMember and Depth Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeViewBinding DataMember and Depth Example</h3>
    
      <!-- Set the DataMember and Depth properties of a -->
      <!-- TreeNodeBinding object declaratively. You  -->
      <!-- can render items at the same node level    -->
      <!-- by setting each item's Depth property to   -->
      <!-- the same value.                -->
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" Depth="0" TextField="Title"/>
          <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>TreeViewBinding DataMember and Depth Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeViewBinding DataMember and Depth Example</h3>
    
      <!-- Set the DataMember and Depth properties of a -->
      <!-- TreeNodeBinding object declaratively. You  -->
      <!-- can render items at the same node level    -->
      <!-- by setting each item's Depth property to   -->
      <!-- the same value.                -->
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" Depth="0" TextField="Title"/>
          <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 riportato di seguito vengono forniti dati XML di esempio per l'esempio di codice precedente.The following code example provides sample XML data for the preceding code example.

<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

Un membro dati specifica il tipo dell'elemento di dati nell'origine dati sottostante, ma può rappresentare informazioni diverse a seconda dell'origine dati.A data member specifies the type of the data item in the underlying data source, but can represent different information depending on the data source. Ogni elemento di dati in un'origine dati gerarchica (rappresentata da un System.Web.UI.IHierarchyData oggetto) espone una IHierarchyData.Type proprietà che specifica il tipo dell'elemento di dati.Each data item in a hierarchical data source (represented by a System.Web.UI.IHierarchyData object) exposes a IHierarchyData.Type property, which specifies the type of the data item. Ad esempio, il membro dati per un elemento XML specifica il nome dell'elemento.For example, the data member for an XML element specifies the name of the element. Quando un'origine dati contiene più tipi di elemento di dati, il membro dati specifica il tipo di elemento dati da utilizzare.When a data source contains multiple data item types, the data member specifies which data item type to use. La TreeNodeBinding dichiarazione seguente associa gli <Book> elementi di un XmlDataSource controllo a tutti i nodi dell'albero, indipendentemente dalla posizione nella gerarchia:The following TreeNodeBinding declaration binds the <Book> elements of an XmlDataSource control to all the nodes in the tree, regardless of the location in the hierarchy:

<asp:TreeNodeBinding DataMember="Book" TextField="Title" ValueField= "ISBN">  

Quando si crea un TreeNodeBinding oggetto, è necessario specificare i criteri per l'associazione.When creating a TreeNodeBinding object, you must specify the criteria for binding. Il criterio indica quando un elemento di dati deve essere associato a un nodo.The criteria indicates when a data item should be bound to a node. È possibile specificare la Depth proprietà o oppure DataMember entrambe le proprietà.You can specify the Depth or DataMember property, or both properties. È possibile ottenere un lieve miglioramento delle prestazioni specificando entrambi.There is a slight performance gain by specifying both.

Una volta stabiliti i criteri di associazione, è possibile associare una proprietà di un TreeNode oggetto che può essere associato a un valore.Once the binding criteria is established, you can then bind a property of a TreeNode object that can be bound to a value. È possibile eseguire l'associazione a un campo di un elemento di dati o a un valore statico.You can bind to a field of a data item or to a static value. Quando è associato a un valore statico, tutti TreeNode gli oggetti a cui TreeNodeBinding è applicato l'oggetto condividono lo stesso valore.When bound to a static value, all TreeNode objects to which the TreeNodeBinding object is applied share the same value.

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

Si applica a

Vedi anche