TreeNode.Checked Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Düğümün onay kutusunun seçili olup olmadığını gösteren bir değer alır veya ayarlar.
public:
property bool Checked { bool get(); void set(bool value); };
public bool Checked { get; set; }
member this.Checked : bool with get, set
Public Property Checked As Boolean
Özellik Değeri
true
düğümün onay kutusu seçiliyse; aksi takdirde , false
. Varsayılan değer: false
.
Örnekler
Aşağıdaki kod örneği, bir düğümün Checked onay kutusunun seçili olup olmadığını belirtmek için özelliğinin nasıl kullanılacağını gösterir. Bir derinliği seçili duruma olan düğümlerin onay kutularını başlatır. Bu örneğin düzgün çalışması için aşağıdaki örnek XML verilerini Newsgroup.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)
{
// Check the depth of a node as it is being bound to data.
// Initialize the Checked property to true if the depth is 1.
if(e.Node.Depth == 1)
{
e.Node.Checked = true;
}
else
{
e.Node.Checked = false;
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeNode Checked Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNode Checked Example</h3>
<asp:TreeView id="NewsgroupTreeView"
DataSourceID="NewsgroupXmlDataSource"
OnTreeNodeDataBound="Data_Bound"
ShowCheckBoxes="All"
ExpandDepth="2"
runat="server">
<DataBindings>
<asp:TreeNodeBinding DataMember="category" TextField="Name"/>
<asp:TreeNodeBinding DataMember="group" TextField="Name"/>
</DataBindings>
</asp:TreeView>
<asp:XmlDataSource id="NewsgroupXmlDataSource"
DataFile="Newsgroup.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)
' Check the depth of a node as it is being bound to data.
' Initialize the Checked property to true if the depth is 1.
If e.Node.Depth = 1 Then
e.Node.Checked = True
Else
e.Node.Checked = False
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeNode Checked Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNode Checked Example</h3>
<asp:TreeView id="NewsgroupTreeView"
DataSourceID="NewsgroupXmlDataSource"
OnTreeNodeDataBound="Data_Bound"
ShowCheckBoxes="All"
ExpandDepth="2"
runat="server">
<DataBindings>
<asp:TreeNodeBinding DataMember="category" TextField="Name"/>
<asp:TreeNodeBinding DataMember="group" TextField="Name"/>
</DataBindings>
</asp:TreeView>
<asp:XmlDataSource id="NewsgroupXmlDataSource"
DataFile="Newsgroup.xml"
runat="server">
</asp:XmlDataSource>
</form>
</body>
</html>
Aşağıdaki kod, önceki örnek için örnek XML verileridir.
<category name="news.microsoft.com">
<group name="microsoft.public.dotnet.framework.aspnet"/>
<group name="microsoft.public.dotnet.framework.aspnet.mobile"/>
<group name="microsoft.public.dotnet.framework.aspnet.webservices"/>
</category>
Açıklamalar
Düğümde onay kutusu görüntülendiğinde, Checked bu özellik genellikle onay kutusunun seçilip seçilmediğini belirtmek için kullanılır. Bir düğümle ilişkilendirilmiş onay kutusu seçildiğinde, düğüm otomatik olarak denetimin CheckedNodes koleksiyonuna TreeView eklenir. Özellik Checked , onay kutusunun seçili olup olmadığını belirlemek için de kullanılabilir.
Not
Denetimdeki hangi düğümlerin onay kutularının TreeView koleksiyonda CheckedNodes yinelenerek seçildiğini belirlemek daha yaygındır.
Bu özelliğin değeri görünüm durumunda depolanır.