NavigationService.Navigate 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
지정된 원본 콘텐츠로 비동기적으로 이동합니다.
오버로드
| 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
매개 변수
- 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
매개 변수
- 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 수 있습니다.
다음 이벤트 인수는 탐색 상태에 대한 액세스를 제공합니다.
ExtraData (이벤트에 전달됨 Navigating ).
ExtraData(, 이벤트 NavigatedNavigationStopped 처리기에 전달LoadCompleted됨).
추가 정보
적용 대상
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
매개 변수
반품
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은 동일합니다.