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.

SiteMapPath الفئة

Visual Studio 2010

إذا كان الرأس هو vهوible؛ otherwهوe،.

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

public class SiteMapPath : CompositeControl
<asp:SiteMapPath />

في هذا الموضوع:

مقدمة

عند ترتيب هو خاصية هو تعيين إلى SiteMapPath، النمط هو تطبيقها على خلايا في العمود عند بيانات هو فرز تصاعدي ترتيب.SiteMap على سبيل المثال، يمكن تمييزها العمود بلون معين عند فرز بكتابة هو تصاعدي. الحصول أو تعيين النمط CSS ليطبقه على رأس عند العمود العمود هو فرز تصاعدي. ترتيب SiteMapDataSource . SiteMapPath إذا كان النمط هو المطبقTreeViewالعنوان عند العمود هو تم فرزها في ترتيب تصاعدي؛ otherwهوe،Menu.

عند ترتيب هو خاصية هو تعيين إلى SiteMapPath، سهم يشير إلى الاتجاه فرز هو dهوplayed في رأس العمود. الحصول أو تعيين الالنمط العمود عند العمود هو فرز تنازلي. ترتيب التنقل في الموقع ASP.NET إذا كان النمط هو المطبقعند العمود هو مفروزة في ترتيب تنازلي؛ otherwهوe،.

عقد

عندما th هو خاصية هو تعيين إلى SiteMapPath، النمط هو تطبيقها على خلايا في العمود عند بيانات هو فرز تنازلي. ترتيب على سبيل المثال، يمكن تمييزها العمود بلون معين عند فرز بكتابة هو تنازلي.SiteMapNodeItem الحصول على أو تعيين النمط لتطبيقه على رأس عند العمود العمود هو فرز تنازلي. ترتيب إذا كان النمط هو المطبقالعنوان عند العمود هو مفروزة في ترتيب تنازلي؛ otherwهوe،. الحصول أو تعيين أسماء حقول المفتاح أساسي للعناصر المعروضة في ربط بيانات عنصر تحكم. ويصف الجدول التالي ثلاثة أنواع مختلفة من العقد :

عقدة نوع

الوصف

جذر

صفيفة يحتوي على أسماء حقول المفتاح الأساسي للعناصر التي يتم عرضها في عنصر تحكم.

أصل

هذه الخاصية وصولاً إلى خاصية عنصر تحكم.

current

هو كشف من خلال واجهة.

الحصول أو تعيين النمط CSS في العمود عند العمود هو فرز تصاعدي. ترتيب

Each node displayed by a SiteMapPath is a HyperLink or Literal control that you can apply a template or style to. الحصول أو تعيين الجدول هو المعروضة في عنصر تحكم مصدر بيانات لحدود عنصر التحكم منضم للبيانات.

  • الجدول الذي يتم عرضه في عنصر تحكم مصدر بيانات ل يحدود إلى عنصر تحكم حدود بيانات.

  • إذا كان مصدر البيانات يحتوي على عدة المصادر بيانات، يتم استخدام هذه خاصية لتعيين جدول بيانات معينة أو التعيين أو بيانات أخرى لعنصر التحكم إلى يربط إلى.

على سبيل المثال، إذا كان مصدر بيانات هو NodeStyleالمثيل الذي يحتوي على جداول متعددة، يمكنك تحديد أي جدول الربط عنصر تحكم إلى باستخدام هذه خاصية.NodeTemplate الحصول أو تعيين بيانات المصدر الكائن الذي يسترد عنصر تحكم حدود بيانات قائمة عناصر بيانات.NodeTemplate

The CurrentNodeTemplate and CurrentNodeStyle properties are applied to nodes that represent the currently displayed page. If a NodeTemplate is defined in addition to the CurrentNodeTemplate, it is ignored. If a NodeStyle is defined in addition to the CurrentNodeStyle, it is merged with the CurrentNodeStyle to create a merged style. This merged style uses all the elements of the CurrentNodeStyle, plus any additional elements of the NodeStyle that do not conflict with the CurrentNodeStyle.

يحصل على مجموعة من الكائنات التي تمثل RootNodeTemplateالقيمة في ربط بيانات عنصر تحكم.RootNodeStyle If a NodeTemplate is defined in addition to the RootNodeTemplate, it is ignored. If a NodeStyle is defined in addition to the RootNodeStyle, it is merged with the RootNodeStyle to create a merged style. This merged style uses all the elements of the RootNodeStyle, plus any additional elements of the NodeStyle that did not conflict with the CurrentNodeStyle. Finally, if the currently displayed page is the root page of the site, the RootNodeTemplate and RootNodeStyle are used instead of the CurrentNodeTemplate or CurrentNodeStyle.

The SiteMapPath control uses the site map provider identified by the SiteMapProvider property as its data source for site navigation information. الحصول أو تعيين فهرس المحدد صف في عنصر تحكم حدود بيانات.SiteMap.Provider فهرس الصف المحدد في عنصر تحكم حدود بيانات.XmlSiteMapProvider If the SiteMapPath control is used within a site but no site map provider is configured, the control throws an HttpException exception.

أحداث

عنصر تحكم التي تلقائياً بإنشاء أعمدة لربط بيانات عنصر تحكم.SiteMapPath يسمح لك هذا إلى تشغيل روتين cusإلىm عند حدوث حدث ما. يسرد الجدول التالي الأحداث التي يعتمدها SiteMapPathعنصر تحكم.

الحدث

الوصف

ItemCreated

Occurs when the SiteMapPath control first creates a SiteMapNodeItem and associates it with a SiteMapNode.

ItemDataBound

إلى منع تسمية تعارضات عندما يتم تقديم عدة مثيلات من عنصر تحكم في صفوف متعددة من SiteMapNodeItemبإنشاء عنصر تحكم ASP.NET فريد SiteMapNodeالقيمة لكل مثيل.

إذا كان النمط هو المطبقالتحكم عند العمود هو تم فرزها في ترتيب تصاعدي؛ otherwهوe،.

إذا قمت بتعيين SiteMapPathخاصية إلى InitializeItem، سيتم إصدار ASP.NET SiteMapNodeItemبإلحاق لاحقة التي هو مشتقة من بيانات الحقل أو حقول المحددة في . For complete control over the way SiteMapNodeItem objects are created and added to the SiteMapPath, derived classes override the CreateControlHierarchy method.

‏إمكانية وصول ذوي الاحتياجات الخاصة

للحصول على المعلومات حول كيفية تكوين هذا عنصر تحكم حيث أنه يقوم بإنشاء ترميز التي تتوافق مع معايير إمكانية الوصول، راجع دعم الوصول في ASP.NETو عناصر تحكم ASP.NET و إمكانية التشغيل.

بناء جملة مصرحة

<asp:SiteMapPath
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnItemCreated="ItemCreated event handler"
    OnItemDataBound="ItemDataBound event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    ParentLevelsDisplayed="integer"
    PathDirection="RootToCurrent|CurrentToRoot"
    PathSeparator="string"
    RenderCurrentNodeAsLink="True|False"
    runat="server"
    ShowToolTips="True|False"
    SiteMapProvider="string"
    SkinID="string"
    SkipLinkText="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    Visible="True|False"
    Width="size"
>
        <CurrentNodeStyle />
        <CurrentNodeTemplate>
            <!-- child controls -->
        </CurrentNodeTemplate>
        <NodeStyle />
        <NodeTemplate>
            <!-- child controls -->
        </NodeTemplate>
        <PathSeparatorStyle />
        <PathSeparatorTemplate>
            <!-- child controls -->
        </PathSeparatorTemplate>
        <RootNodeStyle />
        <RootNodeTemplate>
            <!-- child controls -->
        </RootNodeTemplate>
</asp:SiteMapPath>

قم بالوضع أحد صفوف في الوضع التحرير في SiteMapPathعنصر تحكم باستخدام فهرس الصف المحدد. يعين رقم الصفحة SiteMapPathعنصر تحكم باستخدام فهرس الصف.


<%@ 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">
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">

            <!-- The following example demonstrates some of the orders
                 of precedence when applying styles and templates to
                 functional nodes of a SiteMapPath.

                 The NodeStyle and RootNodeStyle define the same attributes,
                 but are different and conflict with each other: the
                 RootNodeStyle supersedes NodeStyle, and is the style
                 rendered. Notice, however, that the underline style
                 defined by NodeStyle is still applied.

                 Both a CurrentNodeStyle and a CurrentNodeTemplate are
                 defined. A template supersedes a style for a node
                 type, so CurrentNodeTemplate is displayed and CurrentNodeStyle
                 is ignored. -->

            <asp:SiteMapPath ID="SiteMapPath1" runat="server"
                RenderCurrentNodeAsLink="true"
                NodeStyle-Font-Names="Franklin Gothic Medium"
                NodeStyle-Font-Underline="true"
                NodeStyle-Font-Bold="true"
                RootNodeStyle-Font-Names="Symbol"
                RootNodeStyle-Font-Bold="false"
                CurrentNodeStyle-Font-Names="Verdana"
                CurrentNodeStyle-Font-Size="10pt"
                CurrentNodeStyle-Font-Bold="true"
                CurrentNodeStyle-ForeColor="red"
                CurrentNodeStyle-Font-Underline="false">
                <CURRENTNODETEMPLATE>
                        <asp:Image id="Image1" runat="server" ImageUrl="WebForm2.jpg" AlternateText="WebForm2"/>
                </CURRENTNODETEMPLATE>
            </asp:SiteMapPath>


        </form>
    </body>
</html>


فهرس الصف الموجود في الصفحة إلى تحريرها.

<siteMap>
  <siteMapNode title="WebForm1" description="WebForm1" url="WebForm1.aspx" >
    <siteMapNode title="WebForm2" description="WebForm2" url="WebForm2.aspx"/>
  </siteMapNode>
</siteMap>

The following code example demonstrates extends the SiteMapPath control and adds new functionality to it by overriding the InitializeItem method. The DropDownSiteMapPath control adds a DropDownList after the current node, to enable easy navigation to pages that are child nodes of the current page. This example demonstrates how to work with SiteMapNodeItem objects, including checking their SiteMapNodeItemType and calling the OnItemCreated method after the items are created.


using System;
using System.Collections;
using System.ComponentModel;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;


// The DropDownNavigationPath is a class that extends the SiteMapPath
// control and renders a DropDownList after the CurrentNode. The
// DropDownList displays a list of pages found further down the site map
// hierarchy from the current one. Selecting an item in the DropDownList
// redirects to that page.
//
// For simplicity, the DropDownNavigationPath assumes the
// RootToCurrent PathDirection, and does not apply styles
// or templates the current node.
//
[AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
public class DropDownNavigationPath : SiteMapPath {
    // Override the InitializeItem method to add a PathSeparator
    // and DropDownList to the current node.
    protected override void InitializeItem(SiteMapNodeItem item) {

        // The only node that must be handled is the CurrentNode.
        if (item.ItemType == SiteMapNodeItemType.Current)
        {
            HyperLink hLink = new HyperLink();

            // No Theming for the HyperLink.
            hLink.EnableTheming = false;
            // Enable the link of the SiteMapPath is enabled.
            hLink.Enabled = this.Enabled;

            // Set the properties of the HyperLink to
            // match those of the corresponding SiteMapNode.
            hLink.NavigateUrl = item.SiteMapNode.Url;
            hLink.Text        = item.SiteMapNode.Title;
            if (ShowToolTips) {
                hLink.ToolTip = item.SiteMapNode.Description;
            }

            // Apply styles or templates to the HyperLink here.
            // ...
            // ...

            // Add the item to the Controls collection.
            item.Controls.Add(hLink);

            AddDropDownListAfterCurrentNode(item);
        }
        else {
            base.InitializeItem(item);
        }
    }
    private void AddDropDownListAfterCurrentNode(SiteMapNodeItem item) {

        SiteMapNodeCollection childNodes = item.SiteMapNode.ChildNodes;

        // Only do this work if there are child nodes.
        if (childNodes != null) {

            // Add another PathSeparator after the CurrentNode.
            SiteMapNodeItem finalSeparator =
                new SiteMapNodeItem(item.ItemIndex,
                                    SiteMapNodeItemType.PathSeparator);

            SiteMapNodeItemEventArgs eventArgs =
                new SiteMapNodeItemEventArgs(finalSeparator);

            InitializeItem(finalSeparator);
            // Call OnItemCreated every time a SiteMapNodeItem is
            // created and initialized.
            OnItemCreated(eventArgs);

            // The pathSeparator does not bind to any SiteMapNode, so
            // do not call DataBind on the SiteMapNodeItem.
            item.Controls.Add(finalSeparator);

            // Create a DropDownList and populate it with the children of the
            // CurrentNode. There are no styles or templates that are applied
            // to the DropDownList control. If OnSelectedIndexChanged is raised,
            // the event handler redirects to the page selected.
            // The CurrentNode has child nodes.
            DropDownList ddList = new DropDownList();
            ddList.AutoPostBack = true;

            ddList.SelectedIndexChanged += new EventHandler(this.DropDownNavPathEventHandler);

            // Add a ListItem to the DropDownList for every node in the
            // SiteMapNodes collection.
            foreach (SiteMapNode node in childNodes) {
                ddList.Items.Add(new ListItem(node.Title, node.Url));
            }

            item.Controls.Add(ddList);
        }
    }

    // The sender is the DropDownList.
    private void DropDownNavPathEventHandler(object sender,EventArgs e) {
        DropDownList ddL = sender as DropDownList;

        // Redirect to the page the user chose.
        if (Context != null)
            Context.Response.Redirect(ddL.SelectedValue);
    }
}


يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل 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
إظهار: