Aracılığıyla paylaş

TreeNode.ShowCheckBox Özellik

Tanım

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

Düğümün yanında bir 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 ShowCheckBoxTreeView onay kutusunu program aracılığıyla göstermek ve gizlemek için özelliğinin nasıl kullanılacağını gösterir. Bu örneğin düzgün çalışması için aşağıdaki örnek XML verilerini Book.xmladlı 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 örneğe ilişkin ö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.

özelliği onay kutularını görüntülemek için kullanılabilse ShowCheckBox de, denetimin TreeView.ShowCheckBoxesTreeView özelliğini 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 üç durumlu bir ö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ınlarken Boolean C# yazmaz. Bu nedenle, özelliğin durumunu açıkça denetlemek en iyi yöntemdir. Örneğin, Visual Basic ve C# içindeki aşağıdaki kod örnekleri özelliğin değerini açıkça test eder Expanded .

Aşağıdaki Visual Basic kod örneği, özelliğin değerini açıkça test eder Expanded . Bu örnek, özelliğinin olarak ayarlanıp ayarlanmadığını ExpandedTruetest eder ve False deyiminden IfNothing geçer.

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

Bu C# kod örneği, özelliğin değerini açıkça test eder Expanded . Bu örnek, özelliğinin olarak ayarlanıp ayarlanmadığını ExpandedTruetest eder ve False deyiminden IfNull 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.