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.

SiteMapDataSource.StartingNodeOffset الخاصية

Visual Studio 2010

الحصول أو تعيين إزاحة عدد صحيح موجب أو سالب من البداية العقدة التي تحدد هيكلي للجذر الذي هو المعروضة في عنصر تحكم مصدر بيانات.

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

public virtual int StartingNodeOffset { get; set; }
<asp:SiteMapDataSource StartingNodeOffset="Int32" />

قيمة الخاصية

النوع: System.Int32
القيمة الافتراضية هي 0، والذي يشير إلى أن كشف هيكلي للجذر ب SiteMapDataSourceهو نفسه كـ عقدة البدء.

إذا StartingNodeOffsetالخاصية هو تعيين إلى قيمة غير ذلك غير 0، فإنه يؤثر على عقدة البدء ومعه تعيين الموقع التسلسل الهرمي للبيانات التي هو كشف SiteMapDataSourceعنصر التحكم. قيمة عدد صحيح موجب أو سالب StartingNodeOffsetتعرف عدد مستويات أعلى أو أسفل التسلسل الهرمي لخريطة الموقع من البداية العقدة التي هو المعرف من قبل StartFromCurrentNodeو StartingNodeUrlالخصائص إزاحة عقدة بداية من شجرة فرعية التي هو كشف عن طريق عنصر تحكم مصدر البيانات.

إذا كانت عقدة البداية المعرفة هو العقدة التي تمثل الصفحة المطلوبة حاليا، StartingNodeOffsetهو تجاهل.

إذا كانت StartingNodeOffsetتعيين خاصية إلى عدد سالب- n أو عقدة بداية من شجرة فرعية التي يتم عرضها من قبل مصدر بيانات عنصر تحكم هو n عقدة عنصر أصل هيكلية مستويات أعلى العقدة البداية المعرفة. إذا كان n قيمة هو أكبر من عدد مستويات عنصر أصل في التسلسل الهرمي شجرة بعقدة البدء من شجرة فرعية هو العقدة الجذر للتسلسل الهرمي لمخطط الموقع.

إذا StartingNodeOffsetتعيين الخاصية إلى رقم موجب + هو n ، عقده بداية من شجرة فرعية التي يتم عرضها على $ $ $ $ عقدة تابعة مستويات n تحت عقده البداية المعرفة. Because المزيد واحد فرع of child nodes might exist في the هيكلي, the SiteMapDataSource attempts إلى حل a child عقدة directly تشغيل the مسار between the identified البدء عقدة و the عقدة that represents the currently requested الصفحة, if possible. If the عقدة that represents the currently requested الصفحة ليس في the شجرة فرعية of the identified البدء عقدة, the القيمة of the StartingNodeOffset خاصية هو ignored. If the عقدة that represents the currently requested الصفحة هو أصغر من n levels below the identified البدء عقدة, the currently requested الصفحة عقدة هو used كـ the البدء عقدة.

الالقيمة StartingNodeOffsetالخاصية هو تخزين في العرض الالولاية.

يوضح مثال التعليمة البرمجية التالية للتأثير في StartingNodeUrlو StartingNodeOffsetالخصائص. المثال يتكون من عدة الصفحات ASP.NET والصفحة الرئيسية ومقطع الصفحة الرئيسية، و ملف ويب.sitemap. ويب.sitemap ملف يقوم بتعريف بنية التسلسل الهرمي للموقع. هذا المثال تعليمات برمجية، فإنه يحدد عدد من الصفحات المعرف بواسطة محددات مواقع المعلومات الفريدة، مثل 1. ASPX، 2. ASPX، A. ASPX، وب. ASPX، كما يلي:



<siteMap>
    <siteMapNode url="Default.aspx" title="Root"  description="" roles="">
        <siteMapNode url="A.aspx" title="A"  description="" roles="">
            <siteMapNode url="1.aspx" title="1"  description="" roles="" />
            <siteMapNode url="2.aspx" title="2"  description="" roles="" />
        </siteMapNode>
        <siteMapNode url="B.aspx" title="B"  description="" roles="">
            <siteMapNode url="3.aspx" title="3"  description="" roles="" />
            <siteMapNode url="4.aspx" title="4"  description="" roles="" />
        </siteMapNode>
        <siteMapNode url="C.aspx" title="C"  description="" roles="">
            <siteMapNode url="5.aspx" title="5"  description="" roles="" />
            <siteMapNode url="6.aspx" title="6"  description="" roles="" />
        </siteMapNode>      
    </siteMapNode>
</siteMap>


الصفحة موقع.شكل رئيسي تحتوي على SiteMapDataSourceو TreeViewعنصر تحكم s داخل ContentPlaceHolderعنصر تحكم. التعرف على عقدة بداية من هيكلي المكشوفة كافتراضي. ASPX، استخدام StartingNodeUrlخاصية. الملف موقع.شكل رئيسي هو المستخدمة من قبل صفحة الافتراضي.aspx فقط.


<%@ Master Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<script runat="server">

</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ContentPlaceHolder ID="SiteMap" Runat="server">
                Pick a node:<br /><br />
                <asp:TreeView ID="TreeView1" Runat="server" ShowExpandCollapse="false" DataSourceID="SiteMapDataSource1" MaxDataBindDepth="1" />
                <asp:SiteMapDataSource ID="SiteMapDataSource1" Runat="server" StartingNodeUrl="~/Default.aspx" ShowStartingNode="false" />
            </asp:ContentPlaceHolder>
            <asp:ContentPlaceHolder ID="MainBody" Runat="server"/>
        </div>
    </form>
</body>
</html>


الجميع غير ذلك الصفحات، مثل 1.aspx 2.aspx، A.aspx وهكذا، باستخدام صفحة رئيسية مقطع.شكل رئيسي. Th هو صفحة رئيسية هو جداً تشبه موقع.شكل رئيسي، ولكن كان يحتوي على عدة SiteMapDataSourceعناصر التحكم التي يمكن قم بتجربة. TreeView التحكم في البيانات خريطة الموقع dهوplays هو مبدئياً المنضم إلى SiteMapDataSource1، الذي يحدد StartingNodeOffset1. Th هو يشير إلى أن عقدة أصل للصفحة المطلوبة حاليا هو dهوplayed. إذا كنت عرض 1.aspx الصفحة، في هيكلي لعرضها بواسطة TreeViewهو أ، 1، 2. ومع ذلك، إذا قمت بعرض الصفحة 4.aspx، هو هيكلي B، 3، 4.

إذا قمت بتغيير DataSourceIDTreeViewإلى SiteMapDataSource2، TreeViewيعرض عنصر التحكم موقع مخطط بيانات مختلف. عندما تقوم باستخدام SiteMapDataSource2، StartFromCurrentNodeتعيين خاصية إلى true، مما يعني أنه يتم عرض بيانات مخطط الموقع نسبة إلى الصفحة المطلوبة حاليا و StartingNodeOffsetخاصية معينة إلى 1، تشير إلى أن المستوى واحد من فرع العقد معروضا، عندما ممكنة. عندما تقوم بعرض الصفحة A.كـpx، هو هيكلي الذي يتم عرض هيكلي للمستوى الحالي، بما في ذلك الجميع بين العناصر المشابهة، مثل كـ B و C. عندما تقوم بعرض 1.aspx، لم يعد يتم عرض العقد الأصلي.


<%@ Master Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<script runat="server">

    Sub DropDownList1_DataBound(ByVal sender As Object, ByVal e As System.EventArgs)
        If Not Page.IsPostBack Then
            Dim currentNode As DropDownList = sender
            currentNode.SelectedValue = System.Web.SiteMap.CurrentNode.Url
        End If
    End Sub

    Sub DropDownList1_SelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs)
        Dim currentNode As DropDownList = sender
        Response.Redirect(currentNode.SelectedValue)
    End Sub

</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ContentPlaceHolder ID="SiteMap" Runat="server">
                <b>Current Location:</b>
                <asp:SiteMapPath ID="SiteMapPath1" Runat="Server">
                    <CurrentNodeTemplate>
                        <asp:DropDownList ID="DropDownList1" DataTextField="Title" DataValueField="Url" AutoPostBack="true"
                            OnDataBound="DropDownList1_DataBound" DataSourceID="SiteMapDataSource2" Runat="server"
                            OnSelectedIndexChanged="DropDownList1_SelectedIndexChanged" />
                    </CurrentNodeTemplate>
                </asp:SiteMapPath>
                <br />
                <br />
                <a href='<%= System.Web.SiteMap.RootNode.Url %>'>Back to Top</a>
                <br />
                <br />
                <asp:TreeView ID="TreeView1" ShowExpandCollapse="false" Runat="server" DataSourceID="SiteMapDataSource1" />
                <asp:SiteMapDataSource ID="SiteMapDataSource2" Runat="server" StartingNodeOffset="-1"
                    ShowStartingNode="false" StartFromCurrentNode="true" />
                <asp:SiteMapDataSource ID="SiteMapDataSource1" Runat="server" StartingNodeOffset="1" />
            </asp:ContentPlaceHolder>
            <asp:ContentPlaceHolder ID="MainBody" Runat="server" />
        </div>
    </form>
</body>
</html>


يوضح مثال التعليمة البرمجية التالية إحدى الصفحات ASP.NET التي يمكنك استخدامها مع المكونات الأخرى من هذا المثال تعليمات برمجية.

<%@ Page MasterPageFile="~/Section.master" Title="Untitled Page" %>

<asp:Content ID="Content1" ContentPlaceHolderID=MainBody Runat=Server>
  <h2>1.aspx</h2>
</asp:Content>

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