다음을 통해 공유


NavigationService 클래스

정의

탐색을 지원하는 메서드, 속성 및 이벤트가 들어 있습니다.

public ref class NavigationService sealed
public sealed class NavigationService
type NavigationService = class
Public NotInheritable Class NavigationService
상속
NavigationService

설명

NavigationService 브라우저 스타일 탐색의 컨텍스트 내에서 콘텐츠를 다운로드 하는 기능을 캡슐화 합니다.

콘텐츠 HTML 파일과.NET Framework 개체의 형식일 수 있습니다. 그러나 일반적으로 페이지는 콘텐츠를 탐색 하는 방법으로 기본 설정 (참조 Page).

개체의 인스턴스를 제공 하 고 오버 로드를 호출 하 여 콘텐츠를 탐색할 수 있습니다는 Navigate 개체를 허용 하는 메서드:

상대 또는 절대 URI 중 하나에 전달 하 여에 콘텐츠를 이동 하 게 또는 Navigate URI를 허용 하는 메서드 오버 로드 합니다.

URI에서 콘텐츠를 탐색 하는 경우 NavigationService 내용이 들어 있는 개체를 반환 합니다.

다음 이벤트를 통해 탐색의 수명을 추적할 수 있습니다.

일부 이벤트 탐색 발생 될 때마다 발생 하는 발생 하는 이벤트 집합에는 (취소 됨, 중지 또는 실패) 형식 (콘텐츠 또는 콘텐츠 조각) 발생 하는 탐색 및 탐색을 완료 하는 방법에 따라 결정 됩니다.

다음 그림에서는 이러한 이벤트가 발생 하는 시퀀스를 보여 줍니다.

페이지 탐색 흐름 차트

하는 동안 또는 탐색 후 NavigationService 찾았고, 탐색 중인 콘텐츠에의 URI를 포함 하 여 콘텐츠에 대 한 정보를 제공 (Source), 현재 콘텐츠의 URI (CurrentSource), 그리고 포함 된 개체는 탐색 된 콘텐츠 (Content).

콘텐츠를 탐색할 때 NavigationService 탐색 항목으로 탐색 기록에 기록 합니다. 호출 하 여 새 탐색 중 발생 하는 경우 후방 탐색 기록에 항목이 추가 됩니다는 Navigate 메서드를 호출 하 여 전방 탐색 기록의 항목으로 이동 하 여 또는 GoForward합니다. 호출 하 여 탐색 기록을 뒤에 항목으로 이동 하 여 전방 탐색 기록에 항목이 추가 됩니다 GoBack합니다. CanGoBackCanGoForward 있는지 여부를 보고 하 고 전방 탐색 기록 항목 뒤에 각각 있습니다. 또한 가장 최근 항목이 후방 탐색 기록을 호출 하 여 제거할 수 있습니다 RemoveBackEntry합니다.

기본적으로 NavigationService 탐색 기록의 콘텐츠 개체의 인스턴스를 저장 하지 않습니다. 대신 NavigationService 탐색 기록을 사용 하 여 탐색할 때마다 콘텐츠 개체의 새 인스턴스를 만듭니다. 이 동작은 큰 숫자 및 대규모 콘텐츠를 탐색할 때 과도 한 메모리 소비를 방지 하도록 설계 되었습니다. 따라서 콘텐츠 상태는 다음 탐색 간에 기억 되지 않습니다. 그러나 WPF 탐색 기록에 콘텐츠의 부분에 대 한 상태 저장할 수 있는 몇 가지 방법을 제공 합니다.

사용 하 여 AddBackEntry, 여러 인스턴스를 단일 페이지에 대 한 상태 집합을 기억할 수도 있습니다.

NavigationService sealed 클래스 및 따라서 인스턴스화할 수 없습니다; 대신 NavigationService 탐색기에서 탐색을 사용 하도록 설정 하는 데 사용 됩니다. WPF에는 두 검색 기가: NavigationWindowFrame입니다.

시각적으로 XBAP는 인터넷 Explorer 탐색기로 사용하여 통합된 사용자 환경을 제공합니다. 그러나 실제로 XBAP는 탐색기로 MainWindow 사용합니다NavigationWindow. 인터넷 Explorer 실행되는 XBAP의 속성은 에 대한 참조를 NavigationWindow반환하고 에서 관리하는 NavigationWindow 탐색 기록은 다음과 같은 방법으로 인터넷 Explorer 관리되는 탐색 기록과 통합됩니다.

  • XBAP 내에서 , 및 GoBackGoForward 를 호출Navigate하여 콘텐츠를 탐색하는 경우 관련 탐색 기록 항목도 인터넷 Explorer 탐색 기록에 추가됩니다.
  • 인터넷 Explorer 탐색 UI의 항목을 선택하면 인터넷 Explorer NavigationService 해당 항목과 연결된 콘텐츠로 뒤로 또는 앞으로 이동합니다.

참고

Frame 호스팅하는 탐색기의 탐색 기록을 사용 하 여 또는 자체 탐색 기록을 제공할 수 있습니다. 자체 탐색 기록을 제공하는 경우 Frame 탐색 기록의 항목을 탐색하는 고유한 탐색 UI를 표시할 수 있습니다. 해당 항목은 호스트 탐색기(NavigationWindow, Frame, 브라우저)의 탐색 기록에 추가되지 않으므로 각 항목의 탐색 UI에서 로 이동할 수 없습니다(참조 JournalOwnership).

XBAP 지원에 대한 자세한 내용은 WPF 브라우저 호스팅 애플리케이션(XBAP)에 대한 질문과 대답을 참조하세요.

속성

CanGoBack

후방 탐색 기록에 항목이 최소한 하나 이상 있는지 여부를 나타내는 값을 가져옵니다.

CanGoForward

전방 탐색 기록에 항목이 최소한 하나 이상 있는지 여부를 나타내는 값을 가져옵니다.

Content

현재 콘텐츠가 들어 있는 개체의 참조를 가져오거나 설정합니다.

CurrentSource

마지막으로 탐색된 콘텐츠의 URI를 가져옵니다.

Source

현재 콘텐츠의 URI 또는 현재 탐색 대상인 새 콘텐츠의 URI를 가져오거나 설정합니다.

메서드

AddBackEntry(CustomContentState)

후방 탐색 기록에 CustomContentState 개체가 들어 있는 항목을 추가합니다.

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 작동합니다.

(다음에서 상속됨 Object)
GetNavigationService(DependencyObject)

지정된 NavigationService가 들어 있는 콘텐츠의 탐색기에 대한 DependencyObject의 참조를 가져옵니다.

GetType()

현재 인스턴스의 Type을 가져옵니다.

(다음에서 상속됨 Object)
GoBack()

후방 탐색 기록(있는 경우)에서 최신 항목을 탐색합니다.

GoForward()

전방 탐색 기록(있는 경우)에서 최신 항목을 탐색합니다.

MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
Navigate(Object)

개체에 들어 있는 콘텐츠를 비동기적으로 탐색합니다.

Navigate(Object, Object)

개체에 들어 있는 콘텐츠를 비동기적으로 탐색하고, 탐색 도중 처리하는 데 사용할 데이터가 들어 있는 개체를 전달합니다.

Navigate(Uri)

URI에 지정된 콘텐츠를 비동기적으로 탐색합니다.

Navigate(Uri, Object)

URI에 있는 소스 콘텐츠를 비동기적으로 탐색하고, 탐색 도중 처리에 사용할 데이터가 들어 있는 개체를 전달합니다.

Navigate(Uri, Object, Boolean)

URI에 있는 소스 콘텐츠를 비동기적으로 탐색하고, 탐색 도중 처리할 탐색 상태가 들어 있는 개체를 전달하며 샌드박스에 콘텐츠를 전달합니다.

Refresh()

현재 콘텐츠를 다시 로드합니다.

RemoveBackEntry()

후방 기록에서 최신 탐색 기록을 제거합니다.

StopLoading()

현재 탐색 요청으로 인해 콘텐츠가 더 이상 다운로드되지 않게 중지합니다.

ToString()

현재 개체를 나타내는 문자열을 반환합니다.

(다음에서 상속됨 Object)

이벤트

FragmentNavigation

콘텐츠 조각에 대한 탐색이 시작될 때 발생합니다. 이는 원하는 조각이 현재 콘텐츠에 있거나 원본 XAML 콘텐츠가 로드된 후 원하는 조각이 다른 콘텐츠에 있는 경우 즉시 발생합니다.

LoadCompleted

탐색된 콘텐츠가 로드 및 구문 분석되어 렌더링되기 시작할 때 발생합니다.

Navigated

탐색 대상 콘텐츠를 찾았고, 아직 완전히 로드되지 않았지만 Content 속성을 통해 콘텐츠를 사용할 수 있는 경우에 발생합니다.

Navigating

새 탐색이 요청되면 발생합니다.

NavigationFailed

요청된 콘텐츠를 탐색하는 동안 오류가 발생하면 발생합니다.

NavigationProgress

탐색 진행 정보를 제공하기 위해 다운로드하는 동안 정기적으로 발생합니다.

NavigationStopped

StopLoading() 메서드가 호출되거나 현재 탐색이 진행되는 동안 새 탐색이 요청될 때 발생합니다.

적용 대상