SiteMapDataSource.StartingNodeOffset 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
데이터 소스 컨트롤에 의해 노출되는 루트 계층 구조를 결정하는 시작점에서 양의 정수 또는 음의 정수 오프셋을 가져오거나 설정합니다.
public:
virtual property int StartingNodeOffset { int get(); void set(int value); };public virtual int StartingNodeOffset { get; set; }member this.StartingNodeOffset : int with get, setPublic Overridable Property StartingNodeOffset As Integer속성 값
기본값은 0이며 SiteMapDataSource에 의해 노출되는 루트 계층 구조가 시작 노드와 같음을 나타냅니다.
예제
다음 코드 예제에서는의 효과 보여 줍니다.는 StartingNodeUrl 고 StartingNodeOffset 속성입니다. 이 예제에서는 몇 가지 ASP.NET 페이지, 마스터 페이지, 마스터 페이지 섹션 및 Web.sitemap 파일 구성 됩니다. Web.sitemap 파일 사이트의 계층 구조를 정의합니다. 이 코드 예를 들어 많은 1.aspx 2.aspx, A.aspx와 B.aspx, 고유한 Url을 다음과 같이 구분 페이지를 정의 합니다.
Site.master이 페이지에는 SiteMapDataSource 및 TreeView 내부의 컨트롤을 ContentPlaceHolder 제어 합니다. Default.aspx로 노출 된 계층의 시작 노드를 식별 하 고 사용 하 여는 StartingNodeUrl 속성입니다. Site.master 파일만 Default.aspx 페이지에서 사용 됩니다.
1.aspx, 2.aspx, A.aspx, 등과 같은 다른 모든 페이지 Section.master 마스터 페이지를 사용 합니다. 이 마스터 페이지는 몇 가지 포함 되어 있지만 site.master 매우 유사한 SiteMapDataSource 시험해 볼 수 있는 컨트롤입니다. TreeView 처음에 사이트 맵 데이터를 표시 하는 컨트롤에 바인딩된 SiteMapDataSource1를 지정 하는 StartingNodeOffset 1. 이 현재 요청 된 페이지의 부모 노드가 표시 되는 것을 나타냅니다. 계층이 표시 하 여 페이지 1.aspx에 보면는 TreeView a, 1, 2입니다. 그러나 페이지 4.aspx를 볼 경우 계층은 B, 3, 4.
변경 하는 경우는 DataSourceID 에 대 한는 TreeView 하 SiteMapDataSource2, TreeView 컨트롤이 다르게 사이트 맵 데이터를 표시 합니다. 사용 하는 경우 SiteMapDataSource2는 StartFromCurrentNode 속성이 true, 즉, 사이트 맵 데이터를 현재 요청 된 페이지를 기준으로 표시 되도록 및 StartingNodeOffset 속성은 자식 노드의 한 수준 인지를 나타내는-1로 설정 가능한 경우 표시 됩니다. 표시 되는 계층 구조, B 및 C와 같은 모든 형제를 포함 하는 현재 수준의의 계층 구조는 A.aspx 페이지를 볼 때 1.aspx를 볼 때 부모 노드가 더 이상 표시 됩니다.
다음 코드 예제에서는이 코드 예제에 다른 구성 요소를 사용 하 여 사용할 수는 ASP.NET 페이지 중 하나를 보여 줍니다.
<%@ Page MasterPageFile="~/Section.master" Title="Untitled Page" %>
<asp:Content ID="Content1" ContentPlaceHolderID=MainBody Runat=Server>
<h2>1.aspx</h2>
</asp:Content>
설명
경우는 StartingNodeOffset 속성은 0이 아닌 값으로 설정, 시작 노드에 영향을 주므로 및 된 사이트에서 노출 되는 데이터 계층 구조에 매핑하는 SiteMapDataSource 컨트롤. 음수 이거나 양의 정수 값을 StartingNodeOffset 으로 식별 되는 시작 점에서 사이트 맵 계층 위아래로 수준의 수를 식별 하는 StartFromCurrentNode 및 StartingNodeUrl 시작 노드 하위 트리를 오프셋 하는 속성 데이터 소스 컨트롤에 의해 노출 되는 합니다.
식별 된 시작 노드인 경우 현재 요청 된 페이지를 나타내는 노드를 StartingNodeOffset 무시 됩니다.
속성이 StartingNodeOffset 음수 -n 으로 설정된 경우 데이터 소스 컨트롤에 의해 노출되는 하위 트리의 시작 노드는 식별된 시작 노드 위의 상위 노드 n 계층 수준입니다. 경우 값 n 시작 노드 하위 트리를 계층적 트리의 상위 수준 수는 사이트 맵 계층의 루트 노드 보다 큽니다.
경우는 StartingNodeOffset 양수 속성 +n, 노출 되는 하위 트리의 시작 노드는 자식 노드입니다 n 식별된 시작 노드 아래에 있는 수준입니다. 계층의 자식 노드는 둘 이상의 분기 수 없으므로 SiteMapDataSource 식별된 시작 노드 및 가능한 경우 현재 요청 된 페이지를 나타내는 노드 간의 경로에 직접 자식 노드를 확인 하려고 시도 합니다. 현재 요청 된 페이지를 나타내는 노드 식별 된 시작 노드의 값의 하위 트리에서 없으면는 StartingNodeOffset 속성은 무시 됩니다. 현재 요청 된 페이지를 나타내는 노드가 미만 n 식별된 시작 노드를 현재 요청 된 페이지 노드 아래의 수준 시작 노드로 사용 됩니다.
값을 StartingNodeOffset 속성은 뷰 상태에 저장 됩니다.