NavigationService.Navigate NavigationService.Navigate NavigationService.Navigate NavigationService.Navigate Method

Определение

Выполняет асинхронный переход к содержимому заданного источника.Navigate asynchronously to the specified source content.

Перегрузки

Navigate(Uri, Object, Boolean) Navigate(Uri, Object, Boolean) Navigate(Uri, Object, Boolean) Navigate(Uri, Object, Boolean)

Выполняет асинхронный переход к содержимому источника с указанным URI, передает объект, содержащий состояние перехода для использования в процессе перехода, и выводит содержимое в песочнице.Navigate asynchronously to source content located at a URI, pass an object containing navigation state for processing during navigation, and sandbox the content.

Navigate(Uri, Object) Navigate(Uri, Object) Navigate(Uri, Object) Navigate(Uri, Object)

Выполняет асинхронный переход к содержимому источника с указанным URI и передает объект с данными, предназначенными для использования в процессе перехода.Navigate asynchronously to source content located at a URI, and pass an object that contains data to be used for processing during navigation.

Navigate(Uri) Navigate(Uri) Navigate(Uri) Navigate(Uri)

Выполняет асинхронный переход к содержимому, идентифицируемому URI.Navigate asynchronously to content that is specified by a URI.

Navigate(Object) Navigate(Object) Navigate(Object) Navigate(Object)

Выполняет асинхронный переход к содержимому, которое находится в объекте.Navigate asynchronously to content that is contained by an object.

Navigate(Object, Object) Navigate(Object, Object) Navigate(Object, Object) Navigate(Object, Object)

Выполняет асинхронный переход к содержимому, которое находится в объекте, и передает объект с данными, предназначенными для использования в процессе перехода.Navigate asynchronously to content that is contained by an object, and pass an object that contains data to be used for processing during navigation.

Navigate(Uri, Object, Boolean) Navigate(Uri, Object, Boolean) Navigate(Uri, Object, Boolean) Navigate(Uri, Object, Boolean)

Выполняет асинхронный переход к содержимому источника с указанным URI, передает объект, содержащий состояние перехода для использования в процессе перехода, и выводит содержимое в песочнице.Navigate asynchronously to source content located at a URI, pass an object containing navigation state for processing during navigation, and sandbox the content.

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 Uri

Объект Uri, инициализированный с помощью URI для нужного содержимого.A Uri object initialized with the URI for the desired content.

navigationState
Object Object Object Object

Объект, содержащий данные для использования в процессе перехода.An object that contains data to be used for processing during navigation.

sandboxExternalContent
Boolean Boolean Boolean Boolean

Если содержит значение true, содержимое загружается в песочницу с частичным доверием (с разрешениями зоны Интернета по умолчанию).Download content into a partial trust security sandbox (with the default Internet zone set of permissions, if true. Значение по умолчанию — false.The default is false.

Возвраты

true, если переход не отменен; в противном случае — false.true if a navigation is not canceled; otherwise, false.

Комментарии

Этот метод предназначен только для автономных приложений Язык XAMLExtensible Application Markup Language (XAML) и содержимого.This method is only for standalone applications and Язык XAMLExtensible Application Markup Language (XAML) content.

Этот метод действует так же, как NavigationService.Navigateи, и расширяет его, гарантируя, что загружаемое содержимое помещается в песочницу безопасности с частичным доверием (с набором разрешений по умолчанию для зоны Интернета). см. раздел Безопасность частичного доверия в WPF. ).This method exhibits the same behavior as NavigationService.Navigate, and extends it by ensuring that the content that is being downloaded is placed into a partial trust security sandbox (with the default Internet zone set of permissions - see WPF Partial Trust Security).

Дополнительно

Navigate(Uri, Object) Navigate(Uri, Object) Navigate(Uri, Object) Navigate(Uri, Object)

Выполняет асинхронный переход к содержимому источника с указанным URI и передает объект с данными, предназначенными для использования в процессе перехода.Navigate asynchronously to source content located at a URI, and pass an object that contains data to be used for processing during navigation.

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 Uri

Объект Uri, инициализированный с помощью URI для нужного содержимого.A Uri object initialized with the URI for the desired content.

navigationState
Object Object Object Object

Объект, содержащий данные для использования в процессе перехода.An object that contains data to be used for processing during navigation.

Возвраты

true, если переход не отменен; в противном случае — false.true if a navigation is not canceled; otherwise, false.

Примеры

В следующем примере демонстрируется переход к URI и передача состояния навигации.The following example demonstrates navigating to a URI and passing navigation state.

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

Комментарии

Так как переходы являются асинхронными, одновременно может выполняться несколько переходов.Since navigations are asynchronous, it is possible for multiple navigations to be in progress at the same time. Например, если на одной странице есть два дочерних кадра, то можно перемещаться по обоим кадрам.For example, if there are two child frames on a single page, both frames could be navigating. В этом случае различные события навигации, вызванные NavigationService , могут вызываться несколько раз, по одному для каждого фрагмента содержимого, к которому осуществляется переход, и не обязательно в порядке, в котором были запрошены переходы.In this case, the various navigation events that are raised by NavigationService may be raised multiple times, one for each piece of content that is being navigated to, and not necessarily in order that the navigations were requested. Следовательно, если определенный запрос навигации должен обрабатывать данные, относящиеся к отдельному запросу, он не может использовать данные, доступные для всех запросов навигации.Consequently, if a particular navigation request needs to process data that is specific to the individual request, it cannot use data that is available to all navigation requests. Вместо этого можно использовать navigationState для передачи данных для обработки навигации, относящейся к одному запросу навигации.Instead, you can use navigationState to pass data for navigation processing that is specific to one navigation request.

Следующие аргументы события предоставляют доступ к состоянию навигации:The following event arguments provide access to navigation state:

Дополнительно

Navigate(Uri) Navigate(Uri) Navigate(Uri) Navigate(Uri)

Выполняет асинхронный переход к содержимому, идентифицируемому URI.Navigate asynchronously to content that is specified by a 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 Uri

Объект Uri, инициализированный с помощью URI для нужного содержимого.A Uri object initialized with the URI for the desired content.

Возвраты

true, если переход не отменен; в противном случае — false.true if a navigation is not canceled; otherwise, false.

Примеры

В следующем примере показано, как переходить к URI.The following example shows how to navigate to a 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-адресURL кодом или допустимым URI типа "Pack" (см. раздел Pack URI в WPF).The value of source can be a Web URL-адресURL or a valid pack URI (see Pack URIs in WPF).

Navigateбудет переходить к URI, указанному в, source если выполняются следующие условия.Navigate will navigate to the URI specified by source if the following conditions are true:

Если source параметр nullимеет значение, то существующееContentсодержимое () удаляется.If source is null, the existing content (Content) is cleared.

Примечание

При скачивании веб-содержимого может появиться веб-исключение (например, 404: Файл не найден).When downloading Web content, you may receive a Web exception (for example, 404: File Not Found). Эти исключения можно обрабатывали NavigationFailedиз.You can handle such exceptions from NavigationFailed.

Для перехода к Navigate фрагменту содержимого можно использовать.You can use Navigate to navigate to a content fragment. Если содержимое, определяемое URI, является текущим, оно не загружается повторно.If the content identified by the URI is the current content, it is not downloaded again.

Дополнительно

Navigate(Object) Navigate(Object) Navigate(Object) Navigate(Object)

Выполняет асинхронный переход к содержимому, которое находится в объекте.Navigate asynchronously to content that is contained by an 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 Object Object Object

Объект с содержимым, к которому осуществляется переход.An object that contains the content to navigate to.

Возвраты

true, если переход не отменен; в противном случае — false.true if a navigation is not canceled; otherwise, false.

Примеры

В следующем примере показано, как переходить к Page объекту, содержащему дерево исходного содержимого.The following example shows how to navigate to a Page object containing the source content tree.

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 если выполняются следующие условия.Navigate will navigate to the Object specified by root if the following conditions are true:

Если root параметр nullимеет значение, то существующееContentсодержимое () удаляется.If root is null, the existing content (Content) is cleared.

Примечание

При скачивании веб-содержимого может появиться веб-исключение (например, 404: Файл не найден).When downloading Web content, you may receive a Web exception (for example, 404: File Not Found). Эти исключения можно обрабатывали NavigationFailedиз.You can handle such exceptions from NavigationFailed.

Дополнительно

Navigate(Object, Object) Navigate(Object, Object) Navigate(Object, Object) Navigate(Object, Object)

Выполняет асинхронный переход к содержимому, которое находится в объекте, и передает объект с данными, предназначенными для использования в процессе перехода.Navigate asynchronously to content that is contained by an object, and pass an object that contains data to be used for processing during navigation.

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 Object Object Object

Объект с содержимым, к которому осуществляется переход.An object that contains the content to navigate to.

navigationState
Object Object Object Object

Объект, содержащий данные для использования в процессе перехода.An object that contains data to be used for processing during navigation.

Возвраты

true, если переход не отменен; в противном случае — false.true if a navigation is not canceled; otherwise, false.

Примеры

В следующем примере показано, как перейти к Page объекту, содержащему исходное содержимое, и передать состояние навигации.The following example shows how to navigate to a Page object containing the source content, and passing navigation state.

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 передается объект.This method has the same behavior as NavigationService.Navigate, although an object is passed instead of a URI.

Дополнительно

Применяется к