Aracılığıyla paylaş

TreeNode.ShowCheckBox Özellik

  • Başvuru

Tanım

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

Düğümün yanında onay kutusunun görüntülenip görüntülenmeyeceğini belirten bir değer alır veya ayarlar.

public:
 property Nullable<bool> ShowCheckBox { Nullable<bool> get(); void set(Nullable<bool> value); };
public bool? ShowCheckBox { get; set; }
member this.ShowCheckBox : Nullable<bool> with get, set
Public Property ShowCheckBox As Nullable(Of Boolean)

Özellik Değeri

Nullable<Boolean>

true onay kutusunu görüntülemek için; aksi takdirde , false.

Örnekler

Aşağıdaki kod örneği, denetimdeki bir düğümün ShowCheckBox TreeView onay kutusunu program aracılığıyla göstermek ve gizlemek için özelliğinin nasıl kullanılacağını gösterir. Bu örneğin doğru çalışması için aşağıdaki örnek XML verilerini Book.xml 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">
<script runat="server">

  void Data_Bound(Object sender, TreeNodeEventArgs e)
  {

    // Determine the depth of a node as it is bound to data.
    // If the depth is 1, show a check box.
    if(e.Node.Depth == 1)
    {

      e.Node.ShowCheckBox = true;

    }
    else
    {

      e.Node.ShowCheckBox = false;

    }

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeNode ShowCheckBox Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNode ShowCheckBox Example</h3>
    
      <asp:TreeView id="BookTreeView" 
         DataSourceID="BookXmlDataSource"
         OnTreeNodeDataBound="Data_Bound"
         ShowCheckBoxes="None"
         ExpandDepth="2"  
         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">
<script runat="server">

  Sub Data_Bound(ByVal sender As Object, ByVal e As TreeNodeEventArgs)

    ' Determine the depth of a node as it is bound to data.
    ' If the depth is 1, show a check box.
    If e.Node.Depth = 1 Then

      e.Node.ShowCheckBox = True

    Else

      e.Node.ShowCheckBox = False

    End If

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeNode ShowCheckBox Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNode ShowCheckBox Example</h3>
    
      <asp:TreeView id="BookTreeView" 
         DataSourceID="BookXmlDataSource"
         OnTreeNodeDataBound="Data_Bound"
         ShowCheckBoxes="None"
         ExpandDepth="2"  
         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>

Aşağıdaki kod, önceki örnekteki örnek XML verileridir.

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

Açıklamalar

Denetim, TreeView bir düğümün görüntüsünün yanında bir onay kutusu görüntülemenizi sağlar. Geçerli düğümün ShowCheckBox onay kutusunu göstermek veya gizlemek için özelliğini kullanın.

Özellik onay kutularını görüntülemek için kullanılabilse ShowCheckBox de, denetimin TreeView.ShowCheckBoxes özelliğini TreeView kullanmak daha yaygındır. TreeView.ShowCheckBoxes Ancak özelliği, özelliği tarafından belirtilen her düğüm türünü etkiler; bu nedenle özellik TreeNode.ShowCheckBox genellikle tek bir düğüm için bu ayarı geçersiz kılmak için kullanılır.

TreeView.ShowCheckBoxes özelliği bir üç durumlu özellik olduğundan, aşağıdaki C# kod parçacığı derleme hatasına neden olur:

protected void TreeView1_SelectedNodeChanged(object sender, EventArgs e)  
{  
if (TreeView1.Nodes[0].Expanded)  
{  
// some work here   
}  
}

VB.Net örtük olarak değerini bir NullableBooleanöğesine yayınlasa Boolean da C# yazmaz. Bu nedenle, özelliğin durumunu açıkça denetlemek en iyi uygulamadır. Örneğin, Visual Basic ve C# içindeki aşağıdaki kod örnekleri özelliğin değerini açıkça test ederExpanded.

Aşağıdaki Visual Basic kod örneği, özelliğinin değerini açıkça test ederExpanded. Bu örnek, özelliğinin olarak Trueayarlanıp ayarlanmadığını Expanded test eder; bu nedenle Nothing deyiminden False If geçer.

If TreeView1.Nodes(0).Expanded = True Then 'some work hereEnd IF

Bu C# kod örneği, özelliğinin değerini açıkça test eder Expanded . Bu örnek, özelliğinin olarak Trueayarlanıp ayarlanmadığını Expanded test eder; bu nedenle Null deyiminden False If geçer.

if( TreeView1.Nodes[0].Expanded == true ) { //some work here}

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

Şunlara uygulanır

Ayrıca bkz.