TreeView.MaxDataBindDepth Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger det maximala antalet trädnivåer som ska bindas TreeView till kontrollen.

public:
 property int MaxDataBindDepth { int get(); void set(int value); };
public int MaxDataBindDepth { get; set; }
member this.MaxDataBindDepth : int with get, set
Public Property MaxDataBindDepth As Integer

Egenskapsvärde

Int32

Det maximala antalet trädnivåer som ska bindas TreeView till kontrollen. Standardvärdet är -1, som binder alla trädnivåer i datakällan till kontrollen.

Undantag

ArgumentOutOfRangeException

Det valda värdet är mindre än -1.

Exempel

Det här avsnittet innehåller två kodexempel. Det första kodexemplet visar hur du använder MaxDataBindDepth egenskapen för att binda endast de två första nodnivåerna (djup 0 och 1) till TreeView kontrollen. Det andra kodexemplet innehåller XML-exempeldata för det första kodexemplet.

Följande kodexempel visar hur du använder MaxDataBindDepth egenskapen för att binda endast de två första nodnivåerna (djup 0 och 1) till TreeView kontrollen. Alla nodnivåer i datakällan ignoreras. För att det här exemplet ska fungera korrekt måste du kopiera XML-exempeldata, som tillhandahålls efter det här kodexemplet, till en fil med namnet 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>TreeView MaxDataBindDepth Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView MaxDataBindDepth Example</h3>
    
      <asp:TreeView id="BookTreeView"
        MaxDataBindDepth="1"  
        DataSourceID="BookXmlDataSource"
        runat="server">
         
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" 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>TreeView MaxDataBindDepth Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView MaxDataBindDepth Example</h3>
    
      <asp:TreeView id="BookTreeView"
        MaxDataBindDepth="1"  
        DataSourceID="BookXmlDataSource"
        runat="server">
         
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>

      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>
      

    </form>
  </body>
</html>

Följande kodexempel innehåller XML-exempeldata för föregående kodexempel.

<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>
</Book>

Kommentarer

När du binder TreeView kontrollen till en datakälla använder du MaxDataBindDepth egenskapen för att begränsa antalet trädnivåer som ska bindas till kontrollen. Om du till exempel anger den här egenskapen till 2 binds endast rotnoden och alla noder som omedelbart finns under rotnoden TreeView till kontrollen. Alla återstående noder i datakällan ignoreras.

Important

En obehörig användare kan skapa en begäran om motringning och hämta data för noderna i kontrollen TreeView som sidutvecklaren inte visar. Därför måste datasäkerheten implementeras av datakällan. Använd inte egenskapen MaxDataBindDepth för att dölja data.

Värdet för den här egenskapen lagras i visningstillstånd.

Gäller för

Se även