TreeView.MaxDataBindDepth Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví maximální počet úrovní stromu, které se mají svázat s ovládacím prvkem TreeView .

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

Hodnota vlastnosti

Int32

Maximální počet úrovní stromu, které se mají svázat s ovládacím prvkem TreeView . Výchozí hodnota je -1, která sváže všechny úrovně stromu ve zdroji dat s ovládacím prvkem.

Výjimky

ArgumentOutOfRangeException

Vybraná hodnota je menší než -1.

Příklady

Tato část obsahuje dva příklady kódu. První příklad kódu ukazuje, jak použít MaxDataBindDepth vlastnost k vytvoření vazby pouze prvních dvou úrovní uzlů (hloubky 0 a 1) na TreeView ovládací prvek. Druhý příklad kódu poskytuje ukázková data XML pro první příklad kódu.

Následující příklad kódu ukazuje, jak použít MaxDataBindDepth vlastnost k vytvoření vazby pouze prvních dvou úrovní uzlů (hloubky 0 a 1) na TreeView ovládací prvek. Všechny úrovně uzlů ve zdroji dat se ignorují. Aby tento příklad fungoval správně, musíte zkopírovat ukázková data XML za tímto příkladem kódu do souboru s názvem 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>

Následující příklad kódu poskytuje ukázková data XML pro předchozí příklad kódu.

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

Poznámky

Při vazbě TreeView ovládacího prvku ke zdroji dat použijte MaxDataBindDepth vlastnost k omezení počtu úrovní stromu, které se mají svázat s ovládacím prvkem. Například nastavením této vlastnosti navážete 2 pouze kořenový uzel a všechny uzly, které jsou okamžitě pod kořenovým uzlem k ovládacímu TreeView prvku. Všechny zbývající uzly ve zdroji dat se ignorují.

Důležité

Uživatel se zlými úmysly TreeView může vytvořit žádost o zpětné volání a získat data pro uzly ovládacího prvku, který vývojář stránky nezobrazuje. Zabezpečení dat proto musí být implementováno zdrojem dat. MaxDataBindDepth Nepoužívejte vlastnost ke skrytí dat.

Hodnota této vlastnosti je uložena ve stavu zobrazení.

Platí pro

Viz také

ExpandDepth

Sdílet prostřednictvím