TreeView.AutoGenerateDataBindings Özellik

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Denetimin TreeView otomatik olarak ağaç düğümü bağlamaları oluşturup oluşturmadığını belirten bir değer alır veya ayarlar.

public:
 property bool AutoGenerateDataBindings { bool get(); void set(bool value); };
public bool AutoGenerateDataBindings { get; set; }
member this.AutoGenerateDataBindings : bool with get, set
Public Property AutoGenerateDataBindings As Boolean

Özellik Değeri

Boolean

true denetimin otomatik olarak ağaç düğümü bağlamaları oluşturmasını TreeView sağlamak için; aksi takdirde , false. Varsayılan değer: true.

Örnekler

Bu bölüm iki kod örneği içerir. İlk kod örneğinde, özelliğini falseolarak ayarlayarak otomatik ağaç düğümü bağlama oluşturma işleminin nasıl devre dışı bırakılası gösterilmektedirAutoGenerateDataBindings. İkinci kod örneği, ilk kod örneği için örnek site haritası verileri sağlar.

Aşağıdaki kod örneği, özelliğini falseolarak ayarlayarak otomatik ağaç düğümü bağlama oluşturmayı devre dışı bırakma işlemini AutoGenerateDataBindings gösterir. Daha DataBindings sonra bir denetimdeki veri öğeleriyle denetimin düğümleri TreeView arasındaki ilişkiyi kurmak için bir SiteMapDataSource koleksiyon tanımlanır. Bu örneğin doğru çalışması için, bu kod örneğinden sonra sağlanan örnek site haritası verilerini Web.sitemap adlı bir dosyaya kopyalamanız gerekir.


<%@ 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 AutoGenerateBindings Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView AutoGenerateBindings Example</h3>
    
      <!-- Set the AutoGenerateBindings property -->
      <!-- to false declaratively to allow for   -->
      <!-- the user-defined Bindings collection. -->
      <asp:TreeView id="SiteTreeView" 
        DataSourceID="SiteMapSource"
        AutoGenerateDataBindings="False"
        runat="server">
        
        <DataBindings>
        
          <asp:TreeNodeBinding TextField="title" NavigateUrlField="url"/>
        
        </DataBindings>
            
      </asp:TreeView>
      
      <asp:SiteMapDataSource ID="SiteMapSource" runat="server"/>
         
    </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 AutoGenerateBindings Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView AutoGenerateBindings Example</h3>
    
      <!-- Set the AutoGenerateBindings property -->
      <!-- to false declaratively to allow for   -->
      <!-- the user-defined Bindings collection. -->
      <asp:TreeView id="SiteTreeView" 
        DataSourceID="SiteMapSource"
        AutoGenerateDataBindings="False"
        runat="server">
        
        <DataBindings>
        
          <asp:TreeNodeBinding TextField="title" NavigateUrlField="url"/>
        
        </DataBindings>
            
      </asp:TreeView>
      
      <asp:SiteMapDataSource ID="SiteMapSource" runat="server"/>
         
    </form>
  </body>
</html>

Aşağıdaki kod örneği, önceki örnek için örnek site haritası verileri sağlar.

<siteMap>
    <siteMapNode title="Home" description="Home" url="default.aspx">
        <siteMapNode title="Products" description="Products" url="Products.aspx">
            <siteMapNode title="Computers" url="Computers.aspx"/>
            <siteMapNode title="Accessories" url="Accessories.aspx"/>
        </siteMapNode>
    </siteMapNode>
</siteMap>

Açıklamalar

Ağaç düğümü bağlamaları, bir veri öğesi ile bağlandığınız düğüm arasındaki ilişkiyi tanımlar. Her veri öğesinin birden çok özellik (çeşitli özniteliklere sahip bir XML öğesi gibi) içerdiği bir veri kaynağına bağlanırken, denetimin TreeView hangi veri öğesi özelliğinin hangi TreeNode özelliğe bağlanacağını bilmesi gerekir. AutoGenerateDataBindings özelliği olarak trueTreeView ayarlanırsa, denetim, bağlamayla ilişkili nesnenin özelliğini veri öğesinin TreeNode yöntemi tarafından ToString döndürülen değere ayarlayan Text varsayılan ağaç düğümü bağlamalarını otomatik olarak oluşturur.

Uyarı

Otomatik olarak oluşturulan ağaç düğümü bağlamaları koleksiyona DataBindings eklenmez.

XML öğesi söz konusu olduğunda, yöntemi tarafından ToString döndürülen değer, XML dosyasının temel yapısını gösteren öğe adıdır, ancak aksi takdirde çok kullanışlı değildir. Daha kullanışlı bir ağaç oluşturmak için, koleksiyonu doldurarak DataBindings kendi ağaç düğümü bağlamalarınızı tanımlamanız gerekir.

Uyarı

Bir DataBindings koleksiyon tanımlarsanız, TreeView denetim otomatik olarak oluşturulan ağaç düğümü bağlamaları yerine bu değerleri kullanır.

Bu özelliğin değeri görünüm durumunda depolanır.

Şunlara uygulanır

Ayrıca bkz.