IHierarchyData.HasChildren Właściwość

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.dll

Wskazuje, czy węzeł danych hierarchicznych reprezentowany IHierarchyData przez obiekt ma jakiekolwiek węzły podrzędne.

public:
 property bool HasChildren { bool get(); };

public bool HasChildren { get; }

member this.HasChildren : bool

Public ReadOnly Property HasChildren As Boolean

Wartość właściwości

Boolean

true jeśli bieżący węzeł ma węzły podrzędne; w przeciwnym razie , false.

Przykłady

Poniższy przykład kodu pokazuje, jak ASP.NET hierarchiczna kontrolka powiązana z danymi używa IHierarchyData obiektu w cyklicznej metodzie powiązania danych. Elementy w IHierarchicalEnumerable kolekcji są wyliczane, a dla każdego IHierarchyData obiektu jest pobierany przy użyciu GetHierarchyData metody . Na koniec właściwość jest sprawdzana, aby określić, HasChildren czy cyklicznie się powtarzać. Ten przykład kodu jest częścią większego przykładu podanego HierarchicalDataBoundControl dla klasy.

private void RecurseDataBindInternal(TreeNode node, 
    IHierarchicalEnumerable enumerable, int depth) {                                    
                
    foreach(object item in enumerable) {
        IHierarchyData data = enumerable.GetHierarchyData(item);

        if (null != data) {
            // Create an object that represents the bound data
            // to the control.
            TreeNode newNode = new TreeNode();
            RootViewNode rvnode = new RootViewNode();
            
            rvnode.Node = newNode;
            rvnode.Depth = depth;

            // The dataItem is not just a string, but potentially
            // an XML node or some other container. 
            // If DataTextField is set, use it to determine which 
            // field to render. Otherwise, use the first field.                    
            if (DataTextField.Length > 0) {
                newNode.Text = DataBinder.GetPropertyValue
                    (data, DataTextField, null);
            }
            else {
                PropertyDescriptorCollection props = 
                    TypeDescriptor.GetProperties(data);

                // Set the "default" value of the node.
                newNode.Text = String.Empty;                        

                // Set the true data-bound value of the TextBox,
                // if possible.
                if (props.Count >= 1) {                        
                    if (null != props[0].GetValue(data)) {
                        newNode.Text = 
                            props[0].GetValue(data).ToString();
                    } 
                }
            }

            Nodes.Add(rvnode);                    
            
            if (data.HasChildren) {
                IHierarchicalEnumerable newEnumerable = 
                    data.GetChildren();
                if (newEnumerable != null) {                            
                    RecurseDataBindInternal(newNode, 
                        newEnumerable, depth+1 );
                }
            }
            
            if ( _maxDepth < depth) _maxDepth = depth;
        }
    }
}

Private Sub RecurseDataBindInternal(ByVal node As TreeNode, _
    ByVal enumerable As IHierarchicalEnumerable, _
    ByVal depth As Integer)

    Dim item As Object
    For Each item In enumerable

        Dim data As IHierarchyData = enumerable.GetHierarchyData(item)

        If Not data Is Nothing Then

            ' Create an object that represents the bound data
            ' to the control.
            Dim newNode As New TreeNode()
            Dim rvnode As New RootViewNode()

            rvnode.Node = newNode
            rvnode.Depth = depth

            ' The dataItem is not just a string, but potentially
            ' an XML node or some other container. 
            ' If DataTextField is set, use it to determine which 
            ' field to render. Otherwise, use the first field.                    
            If DataTextField.Length > 0 Then
                newNode.Text = DataBinder.GetPropertyValue _
                (data, DataTextField, Nothing)
            Else
                Dim props As PropertyDescriptorCollection = _
                TypeDescriptor.GetProperties(data)

                ' Set the "default" value of the node.
                newNode.Text = String.Empty

                ' Set the true data-bound value of the TextBox,
                ' if possible.
                If props.Count >= 1 Then
                    If Not props(0).GetValue(data) Is Nothing Then
                        newNode.Text = props(0).GetValue(data).ToString()
                    End If
                End If
            End If

            Nodes.Add(rvnode)

            If data.HasChildren Then
                Dim newEnumerable As IHierarchicalEnumerable = _
                    data.GetChildren()
                If Not (newEnumerable Is Nothing) Then
                    RecurseDataBindInternal(newNode, _
                    newEnumerable, depth + 1)
                End If
            End If

            If MaxDepth < depth Then
                MaxDepth = depth
            End If
        End If
    Next item

End Sub

Uwagi

Właściwość HasChildren jest właściwością wygodną, która umożliwia obiektom wywołującym unikanie sprawdzania wartości zwracanej GetChildren metody dla nullelementu . HasChildren Jeśli właściwość zwróci truewartość , wywołaj metodę GetChildren IHierarchicalEnumerable , aby pobrać kolekcję węzłów podrzędnych.

Zobacz też

• GetChildren()