This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

SiteMap.RootNode الخاصية

Visual Studio 2010

Gets a SiteMapNode كائن that represents the الأعلى-المستوى الصفحة of the التنقل بنية for the موقع.

مساحة الاسم:  System.Web
التجميع:  System.Web (في System.Web.dll)

public static SiteMapNode RootNode { get; }

قيمة الخاصية

النوع: System.Web.SiteMapNode
SiteMapNode الذي يمثل صفحة التنقل للموقع الأعلى مستوى بنية؛ otherwهوe، null، إذا الاقتطاع للأمان هو ممكنة والعقدة التي لا يتم إرجاعها إلى المستخدم الحالي.

استثناء:شرط
InvalidOperationException

The مخطط الموقع ميزة ليس ممكّن.

-أو-

RootNode إلى null، التي تحدث في حالة اقتطاع للأمان ممكناً وعقده الجذر غير مرئية للمستخدم الحالي.

ConfigurationErrorsException

The الافتراضي موفر specified في the تكوين غير موجود.

HttpException

The ميزة هو supported فقط when تشغيل في منخفض الثقة أو higher.

The SiteMap فئة retrieves the RootNode خاصية بواسطة requesting it من the موفر. If there هو a موفر هيكلي, the SiteMap فئة retrieves the جذر عقدة of the جذر موفر في the هيكلي. إلى الوصول the جذر عقدة of the الافتراضي موفر, يتصل the Provider خاصية, which retrieves كلاهما the الافتراضي موفر و its RootNode خاصية.

The XmlSiteMapProvider كائن, which هو the الافتراضي موفر for the SiteMap فئة, supports فقط واحد RootNode.

If you implement your own SiteMapProvider فئة و يمنع the abstract RootNode خاصية, you must provide your own implementation إلى مقطع صوتي the RootNode خاصية of the SiteMapNode مثيل.

The جذر عقدة must be مرئي إلى الجميع users, بواسطة تصميم. If the جذر عقدة ليس مرئي إلى الجميع users when الأمان trimming هو ممكّن, accessing the RootNode خاصية might النتيجة في an InvalidOperationException ‏‏ استثناء.

The following تعليمات برمجية مثال demonstrates how إلى استخدم the RootNode خاصية إلى retrieve the SiteMapNode كائن that represents the جذر عقدة of the الموقع, regardless of the الحالي الموقع في the الصفحة هيكلي.


<script runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
    // Examine the CurrentNode, and navigate the SiteMap relative to it.
    Response.Write(SiteMap.CurrentNode.Title + "<br />");
    Response.Write("<font COLOR='red'>" + SiteMap.CurrentNode.Url + "</font><br />");

    // What nodes are children of the CurrentNode?
    if (SiteMap.CurrentNode.HasChildNodes) {
        IEnumerator childNodesEnumerator = SiteMap.CurrentNode.ChildNodes.GetEnumerator();
        while (childNodesEnumerator.MoveNext()) {
            // Prints the Title of each node.
            Response.Write(childNodesEnumerator.Current.ToString() + "<br />");
        }
    }
    Response.Write("<hr />");

    // Examine the RootNode, and navigate the SiteMap relative to it.
    Response.Write(SiteMap.RootNode.Title + "<br />");
    Response.Write(SiteMap.RootNode.Url + "<br />");

    // What nodes are children of the RootNode?
    if (SiteMap.RootNode.HasChildNodes) {
        IEnumerator rootNodesChildrenEnumerator = SiteMap.RootNode.ChildNodes.GetEnumerator();
        while (rootNodesChildrenEnumerator.MoveNext()) {
            // Prints the Title of each node.
            Response.Write(rootNodesChildrenEnumerator.Current.ToString() + "<br />");
        }
    }
}
</script>


نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0
إظهار: