NavigationService.Navigate 메서드

정의

지정된 원본 콘텐츠로 비동기적으로 이동합니다.

오버로드

Name Description
Navigate(Uri, Object, Boolean)

URI에 있는 원본 콘텐츠로 비동기적으로 탐색하고 탐색 중에 처리를 위해 탐색 상태가 포함된 개체를 전달하고 콘텐츠를 샌드박스로 만듭니다.

Navigate(Uri, Object)

URI에 있는 원본 콘텐츠로 비동기적으로 탐색하고 탐색 중에 처리에 사용할 데이터가 포함된 개체를 전달합니다.

Navigate(Uri)

URI로 지정된 콘텐츠로 비동기적으로 이동합니다.

Navigate(Object)

개체에 포함된 콘텐츠로 비동기적으로 이동합니다.

Navigate(Object, Object)

개체에 포함된 콘텐츠로 비동기적으로 탐색하고 탐색 중에 처리에 사용할 데이터가 포함된 개체를 전달합니다.

Navigate(Uri, Object, Boolean)

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입니다.

반품

true탐색이 취소되지 않은 경우 그렇지 않으면 . false

설명

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

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

추가 정보

적용 대상

Navigate(Uri, Object)

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

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

반품

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 수 있습니다.

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

추가 정보

적용 대상

Navigate(Uri)

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를 사용하여 초기화된 개체입니다.

반품

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 는 다음 조건이 true인 경우 지정된 source URI로 이동합니다.

  • Navigating 이벤트가 취소되지 않습니다.

  • 웹 요청(참조 Navigating)을 만들 수 있습니다.

source경우 null 기존 콘텐츠(Content)가 지워집니다.

메모

웹 콘텐츠를 다운로드할 때 웹 예외(예: 404: 파일을 찾을 수 없음)가 표시될 수 있습니다. 에서 이러한 예외를 처리할 수 있습니다.NavigationFailed

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

추가 정보

적용 대상

Navigate(Object)

개체에 포함된 콘텐츠로 비동기적으로 이동합니다.

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

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

반품

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는 다음 조건이 true이면 지정된 Object 값으로 이동합니다root.

  • Navigating 이벤트가 취소되지 않습니다.

  • 웹 요청(참조 Navigating)을 만들 수 있습니다.

root경우 null 기존 콘텐츠(Content)가 지워집니다.

메모

웹 콘텐츠를 다운로드할 때 웹 예외(예: 404: 파일을 찾을 수 없음)가 표시될 수 있습니다. 에서 이러한 예외를 처리할 수 있습니다.NavigationFailed

추가 정보

적용 대상

Navigate(Object, Object)

개체에 포함된 콘텐츠로 비동기적으로 탐색하고 탐색 중에 처리에 사용할 데이터가 포함된 개체를 전달합니다.

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

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

반품

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

설명

개체가 URI 대신 전달되지만 이 메서드의 동작 NavigationService.Navigate은 동일합니다.

추가 정보

적용 대상