IHierarchyData.Item Właściwość

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.dll

Pobiera hierarchiczny węzeł danych reprezentowany przez IHierarchyData obiekt.

public:
 property System::Object ^ Item { System::Object ^ get(); };

public object Item { get; }

member this.Item : obj

Public ReadOnly Property Item As Object

Wartość właściwości

Object

Obiekt Object węzła danych hierarchicznych.

Przykłady

W poniższym przykładzie kodu pokazano, jak uzyskać dostęp do IHierarchyData właściwości, sprawdzić typ IHierarchyData obiektu przy użyciu Type właściwości i rzutować obiekt w celu wykonania bardziej specyficznych dla typu operacji. Ten przykład kodu jest częścią większego przykładu udostępnionego dla interfejsu IHierarchyData .

// Print out the current data node, then iterate through its
// children and do the same.
private void PrintFullChildNodeInfo(IHierarchyData node)
{
    string whitespace = "     ";
    string br = "<BR>";

    Response.Write(node.ToString() + br);
    Response.Write(whitespace + node.Path + br);

    // Check for specific types and perform extended functions.
    if (node.Type == "SiteMapNode")
    {
        // Because SiteMapNode implements the IHierarchyData interface,
        // the IHierarchyData object can be cast directly as a SiteMapNode,
        // rather than accessing the Item property for the object that
        // the Type property identifies.
        SiteMapNode siteNode = node.Item as SiteMapNode;
        Response.Write(whitespace + siteNode.Url + br);
        Response.Write(whitespace + siteNode.Description + br);
    }
    else if (node.Type == "SomeBusinessObject")
    {
        // If the IHierarchyData instance is a wrapper class on a business
        // object of some kind, you can retrieve the business object by using
        // the IHierarchyData.Item property.
        //          SomeBusinessObject busObj = node.Item as SomeBusinessObject;
    }

    if (node.HasChildren)
    {
        IEnumerator children = ((IHierarchicalEnumerable)node.GetChildren()).GetEnumerator();

        while (children.MoveNext())
        {
            // Print out SiteMapNode Titles recursively.
            IHierarchyData hierarchicalNode = node.GetChildren().GetHierarchyData(children.Current);
            PrintFullChildNodeInfo(hierarchicalNode);
        }
    }
}

' Print out the current data node, then iterate through its
' children and do the same.

Private Sub PrintFullChildNodeInfo(ByVal node As IHierarchyData)
    Dim whitespace As String = "     "
    Dim br As String = "<BR>"

    Response.Write(Convert.ToString(node) & br)
    Response.Write(whitespace & node.Path & br)

    ' Check for specific types and perform extended functions.
    If node.Type = "SiteMapNode" Then
        ' Because SiteMapNode implements the IHierarchyData interface,
        ' the IHierarchyData object can be cast directly as a SiteMapNode,
        ' rather than accessing the Item property for the object that
        ' the Type property identifies.
        Dim siteNode As SiteMapNode = CType(node.Item, SiteMapNode)
        Response.Write(whitespace & siteNode.Url & br)
        Response.Write(whitespace & siteNode.Description & br)

    ElseIf node.Type = "SomeBusinessObject Then" Then
        ' If the IHierarchyData instance is a wrapper class on a business
        ' object of some kind, you can retrieve the business object by using
        ' the IHierarchyData.Item property.
        '          SomeBusinessObject busObj = node.Item as SomeBusinessObject;
    End If

    If node.HasChildren Then
        Dim children As IEnumerator = CType(node.GetChildren().GetEnumerator(), IHierarchicalEnumerable)
        While children.MoveNext()
            ' Print out SiteMapNode Titles recursively.
            Dim hierarchicalNode As IHierarchyData = node.GetChildren().GetHierarchyData(children.Current)
            PrintFullChildNodeInfo(hierarchicalNode)
        End While
    End If
End Sub

Uwagi

Chociaż wiele klas reprezentujących hierarchiczne węzły danych, takich jak SiteMapNode klasa, implementuje IHierarchyData interfejs bezpośrednio, inne klasy działają tylko jako otoka dla klasy, która nie implementuje interfejsu. Właściwość Item jest udostępniana w takich sytuacjach projektowych, gdy obiekty biznesowe są funkcjonalnie równoważne obiektowi IHierarchyData , ale nie można go łatwo przeprojektować.

Zobacz też

• Type