TreeView.AutoGenerateDataBindings 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定值，指出 TreeView 控制項是否自動產生樹狀節點繫結。
public:
property bool AutoGenerateDataBindings { bool get(); void set(bool value); };public bool AutoGenerateDataBindings { get; set; }member this.AutoGenerateDataBindings : bool with get, setPublic Property AutoGenerateDataBindings As Boolean屬性值
true 表示讓 TreeView 控制項自動產生樹狀節點繫結，否則為 false。 預設為 true。
範例
本節包含兩個程式碼範例。 第一個程式碼範例示範如何藉由將 屬性設定 AutoGenerateDataBindings 為 false 來停用自動樹狀節點系結產生。 第二個程式碼範例會提供第一個程式碼範例的範例網站地圖資料。
下列程式碼範例示範如何將 屬性設定 AutoGenerateDataBindings 為 false 來停用自動樹狀節點系結產生。 DataBindings接著會定義集合，以建立 控制項中的資料 SiteMapDataSource 項與 控制項節點 TreeView 之間的關聯性。 若要讓此範例正常運作，您必須將此程式碼範例之後提供的範例網站地圖資料複製到名為 Web.sitemap 的檔案。
<%@ 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>
下列程式碼範例提供上述範例的範例網站地圖資料。
<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>
備註
樹狀節點系結會定義資料項目與其所系結之節點之間的關聯性。 系結至資料來源時，每個資料項目都包含多個屬性 (例如具有數個屬性的 XML 元素) ， TreeView 控制項必須知道要系結至哪個 TreeNode 屬性的資料項目屬性。 AutoGenerateDataBindings如果 屬性設定 true 為 ，則 TreeView 控制項會自動產生預設樹狀節點系結，該系結會設定 Text 與系結相關聯的物件屬性 TreeNode 至資料項目方法所 ToString 傳回的值。
注意
自動產生的樹狀節點系結不會新增至 DataBindings 集合。
在 XML 元素的情況下，方法所 ToString 傳回的值是專案名稱，這會顯示 XML 檔案的基礎結構，但不是非常實用。 若要建立更實用的樹狀結構，您必須填入 DataBindings 集合來定義自己的樹狀節點系結。
注意
如果您定義 DataBindings 集合，控制項 TreeView 會使用這些值，而不是自動產生的樹狀節點系結。
此屬性的值會儲存在檢視狀態中。