다음을 통해 공유

SiteMapDataSource.StartingNodeOffset 속성

  • 참조

정의

네임스페이스:
System.Web.UI.WebControls
어셈블리:
System.Web.dll

데이터 소스 컨트롤에 의해 노출되는 루트 계층 구조를 결정하는 시작점에서 양의 정수 또는 음의 정수 오프셋을 가져오거나 설정합니다.

public:
 virtual property int StartingNodeOffset { int get(); void set(int value); };
public virtual int StartingNodeOffset { get; set; }
member this.StartingNodeOffset : int with get, set
Public Overridable Property StartingNodeOffset As Integer

속성 값

Int32

기본값은 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 속성은 뷰 상태에 저장 됩니다.

적용 대상

추가 정보