NavigationService.Navigate 메서드

참조

정의

네임스페이스:: System.Windows.Navigation

어셈블리:: PresentationFramework.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

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

오버로드

Navigate(Uri, Object, Boolean)	URI에 있는 소스 콘텐츠를 비동기적으로 탐색하고, 탐색 도중 처리할 탐색 상태가 들어 있는 개체를 전달하며 샌드박스에 콘텐츠를 전달합니다.
Navigate(Uri, Object)	URI에 있는 소스 콘텐츠를 비동기적으로 탐색하고, 탐색 도중 처리에 사용할 데이터가 들어 있는 개체를 전달합니다.
Navigate(Uri)	URI에 지정된 콘텐츠를 비동기적으로 탐색합니다.
Navigate(Object)	개체에 들어 있는 콘텐츠를 비동기적으로 탐색합니다.
Navigate(Object, Object)	개체에 들어 있는 콘텐츠를 비동기적으로 탐색하고, 탐색 도중 처리하는 데 사용할 데이터가 들어 있는 개체를 전달합니다.

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

public:
 bool Navigate(Uri ^ source, System::Object ^ navigationState, bool sandboxExternalContent);

public bool Navigate (Uri source, object navigationState, bool sandboxExternalContent);

member this.Navigate : Uri * obj * bool -> bool

Public Function Navigate (source As Uri, navigationState As Object, sandboxExternalContent As Boolean) As Boolean

매개 변수

source: Uri

해당 콘텐츠의 URI가 초기화된 Uri 개체입니다.

navigationState: Object

탐색 도중 처리하는 데 사용할 데이터가 들어 있는 개체입니다.

sandboxExternalContent: Boolean

true인 경우 콘텐츠를 기본 인터넷 영역 권한 집합과 함께 부분 신뢰 보안 샌드박스로 다운로드합니다. 기본값은 false입니다.

반환

Boolean

탐색이 취소되지 않았으면 true이고, 그렇지 않으면 false입니다.

설명

이 메서드는 독립 실행형 애플리케이션 및 XAML(Extensible Application Markup Language) 콘텐츠에만 사용됩니다.

이 방법으로 동일한 동작이 나타납니다 NavigationService.Navigate를 확장 하 여 부분 신뢰 보안 샌드박스로 다운로드 중인 콘텐츠가 배치 되는 확인 (사용 권한-의 기본 인터넷 영역 집합을 사용 하 여 참조 WPF 부분 신뢰 보안).

추가 정보

적용 대상

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

public:
 bool Navigate(Uri ^ source, System::Object ^ navigationState);

public bool Navigate (Uri source, object navigationState);

member this.Navigate : Uri * obj -> bool

Public Function Navigate (source As Uri, navigationState As Object) As Boolean

매개 변수

source: Uri

해당 콘텐츠의 URI가 초기화된 Uri 개체입니다.

navigationState: Object

탐색 도중 처리하는 데 사용할 데이터가 들어 있는 개체입니다.

반환

Boolean

탐색이 취소되지 않았으면 true이고, 그렇지 않으면 false입니다.

예제

다음 예제에서는 URI로 이동 하 고 탐색 상태를 전달 하는 방법을 보여 줍니다.

void goButton_Click(object sender, RoutedEventArgs e)
{
    this.NavigationService.Navigate(new Uri(this.addressTextBox.Text), DateTime.Now);
}
void NavigationService_LoadCompleted(object sender, NavigationEventArgs e)
{
    DateTime requestDateTime = (DateTime)e.ExtraData;
    string msg = string.Format("Request started {0}\nRequest completed {1}", requestDateTime, DateTime.Now);
    MessageBox.Show(msg);
}

Private Sub goButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Me.NavigationService.Navigate(New Uri(Me.addressTextBox.Text), Date.Now)
End Sub
Private Sub NavigationService_LoadCompleted(ByVal sender As Object, ByVal e As NavigationEventArgs)
    Dim requestDateTime As Date = CDate(e.ExtraData)
    Dim msg As String = String.Format("Request started {0}" & vbLf & "Request completed {1}", requestDateTime, Date.Now)
    MessageBox.Show(msg)
End Sub

설명

탐색은 비동기적 이므로 이므로 여러 탐색을 동시에 진행 될 수 있습니다. 예를 들어, 단일 페이지에 두 개의 자식 프레임이 있는 경우 모두 프레임을 탐색할 수 있습니다. 이 예에서 발생 하는 다양 한 탐색 이벤트 NavigationService 콘텐츠를 탐색 중인 각 부분에 대 한 번 발생 한 여러 되며 반드시 순서에 탐색이 요청을 수 있습니다. 따라서 특정 탐색 요청을 개별 요청에 관련 된 데이터를 처리 하는 경우 탐색에 대 한 모든 요청에서 사용 가능한 데이터를 사용할 수 없습니다. 대신, 사용할 수 있습니다 navigationState 탐색 요청을 처리 하는 탐색 관련이 대 한 데이터를 전달 합니다.

다음 이벤트 인수를 탐색 상태에 대 한 액세스를 제공합니다.

ExtraData (전달 된 Navigating 이벤트).
ExtraData (전달 된 Navigated, NavigationStopped, LoadCompleted 이벤트 처리기).

추가 정보

적용 대상

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

public:
 bool Navigate(Uri ^ source);

public bool Navigate (Uri source);

member this.Navigate : Uri -> bool

Public Function Navigate (source As Uri) As Boolean

매개 변수

source: Uri

해당 콘텐츠의 URI가 초기화된 Uri 개체입니다.

반환

Boolean

탐색이 취소되지 않았으면 true이고, 그렇지 않으면 false입니다.

예제

다음 예제에서는 URI로 이동 하는 방법을 보여 줍니다.

void goButton_Click(object sender, RoutedEventArgs e)
{
    this.NavigationService.Navigate(new Uri(this.addressTextBox.Text));
}

Private Sub goButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Me.NavigationService.Navigate(New Uri(Me.addressTextBox.Text))
End Sub

설명

값 source 은 웹 URL 또는 유효한 팩 URI일 수 있습니다( WPF의 Pack URI 참조).

Navigate 지정 된 URI로 이동 됩니다 source 다음 조건이 true 인 경우:

Navigating 이벤트가 취소 되지 않습니다.
웹 요청 (참조 Navigating)를 만들 수 있습니다.

하는 경우 source 됩니다 null, 기존 콘텐츠 (Content) 지워집니다.

참고

웹 콘텐츠를 다운로드할 웹 예외가 나타날 수 있습니다 (예를 들어 404: 파일을 찾을 수 없습니다). 이러한 예외를 처리할 수 NavigationFailed입니다.

사용할 수 있습니다 Navigate 콘텐츠 조각으로 이동 합니다. URI로 식별 된 콘텐츠가 현재 콘텐츠 인 경우 다시 다운로드 되지 않습니다.

추가 정보

적용 대상

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

public:
 bool Navigate(System::Object ^ root);

public bool Navigate (object root);

member this.Navigate : obj -> bool

Public Function Navigate (root As Object) As Boolean

매개 변수

root: Object

탐색 대상 콘텐츠가 들어 있는 개체입니다.

반환

Boolean

탐색이 취소되지 않았으면 true이고, 그렇지 않으면 false입니다.

예제

다음 예제에서는 탐색 하는 방법을 보여 줍니다는 Page 원본 콘텐츠 트리를 포함 하는 개체입니다.

void goObjectButton_Click(object sender, RoutedEventArgs e)
{
    this.NavigationService.Navigate(new ContentPage());
}

Private Sub goObjectButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Me.NavigationService.Navigate(New ContentPage())
End Sub

설명

Navigate 으로 이동 합니다 Object 에 지정 된 root 다음 조건이 true 인 경우:

Navigating 이벤트가 취소 되지 않습니다.
웹 요청 (참조 Navigating)를 만들 수 있습니다.

하는 경우 root 됩니다 null, 기존 콘텐츠 (Content) 지워집니다.

참고

웹 콘텐츠를 다운로드할 웹 예외가 나타날 수 있습니다 (예를 들어 404: 파일을 찾을 수 없습니다). 이러한 예외를 처리할 수 NavigationFailed입니다.

추가 정보

적용 대상

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

public:
 bool Navigate(System::Object ^ root, System::Object ^ navigationState);

public bool Navigate (object root, object navigationState);

member this.Navigate : obj * obj -> bool

Public Function Navigate (root As Object, navigationState As Object) As Boolean

매개 변수

root: Object

탐색 대상 콘텐츠가 들어 있는 개체입니다.

navigationState: Object

탐색 도중 처리하는 데 사용할 데이터가 들어 있는 개체입니다.

반환

Boolean

탐색이 취소되지 않았으면 true이고, 그렇지 않으면 false입니다.

예제

다음 예제에서는 탐색 하는 방법을 보여 줍니다는 Page 개체 소스 콘텐츠를 포함 하 고 탐색 상태를 전달 합니다.

void goButton_Click(object sender, RoutedEventArgs e)
{
    this.NavigationService.Navigate(new ContentPage(), DateTime.Now);
}
void NavigationService_LoadCompleted(object sender, NavigationEventArgs e)
{
    DateTime requestDateTime = (DateTime)e.ExtraData;
    string msg = string.Format("Request started {0}\nRequest completed {1}", requestDateTime, DateTime.Now);
    MessageBox.Show(msg);
}

Private Sub goButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Me.NavigationService.Navigate(New ContentPage(), Date.Now)
End Sub
Private Sub NavigationService_LoadCompleted(ByVal sender As Object, ByVal e As NavigationEventArgs)
    Dim requestDateTime As Date = CDate(e.ExtraData)
    Dim msg As String = String.Format("Request started {0}" & vbLf & "Request completed {1}", requestDateTime, Date.Now)
    MessageBox.Show(msg)
End Sub

설명

이 메서드는 같은 동작 NavigationService.Navigate이지만 개체 URI 대신 전달 됩니다.

추가 정보

적용 대상

NavigationService.Navigate 메서드

정의

오버로드

Navigate(Uri, Object, Boolean)

매개 변수

반환

설명

추가 정보

적용 대상

Navigate(Uri, Object)

매개 변수

반환

예제

설명

추가 정보

적용 대상

Navigate(Uri)

매개 변수

반환

예제

설명

추가 정보

적용 대상

Navigate(Object)

매개 변수

반환

예제

설명

추가 정보

적용 대상

Navigate(Object, Object)

매개 변수

반환

예제

설명

추가 정보

적용 대상

피드백

추가 리소스