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

Definicja

Przejdź asynchronicznie do zawartości określonego źródła.Navigate asynchronously to the specified source content.

Przeciążenia

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

Przejdź asynchronicznie do źródła zawartości znajdującej się na identyfikator URI, przekazać obiekt zawierający Stan nawigacji dla przetwarzania podczas nawigacji i piaskownicy zawartości.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)

Przejdź asynchronicznie do źródła zawartości znajdującej się na identyfikator URI i przekazać obiekt, który zawiera dane, które ma być używany dla przetwarzania podczas nawigowania.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)

Przejdź asynchronicznie do zawartości, który jest określony przez identyfikator URI.Navigate asynchronously to content that is specified by a URI.

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

Przejdź asynchronicznie do zawartości, która znajduje się za pomocą obiektu.Navigate asynchronously to content that is contained by an object.

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

Asynchronicznie przejdź do zawartości, która znajduje się za pomocą obiektu i przekazać obiekt, który zawiera dane, które ma być używany do przetworzenia podczas nawigacji.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)

Przejdź asynchronicznie do źródła zawartości znajdującej się na identyfikator URI, przekazać obiekt zawierający Stan nawigacji dla przetwarzania podczas nawigacji i piaskownicy zawartości.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

Parametry

source
Uri Uri Uri Uri

A Uri obiekt został zainicjowany przy użyciu identyfikatora URI dla żądanej zawartości.A Uri object initialized with the URI for the desired content.

navigationState
Object Object Object Object

Obiekt, który zawiera dane, które ma być używany do przetworzenia podczas nawigacji.An object that contains data to be used for processing during navigation.

sandboxExternalContent
Boolean Boolean Boolean Boolean

Pobierz zawartość w izolowanym częściowej relacji zaufania (przy użyciu domyślnego internetowego strefa zestaw uprawnień, jeśli true.Download content into a partial trust security sandbox (with the default Internet zone set of permissions, if true. Wartość domyślna to false.The default is false.

Zwraca

true Jeśli nie zostało anulowane nawigacji; w przeciwnym razie false.true if a navigation is not canceled; otherwise, false.

Uwagi

Ta metoda jest przeznaczona tylko dla aplikacji autonomicznej i Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) zawartości.This method is only for standalone applications and Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) content.

Ta metoda wykazuje takie samo zachowanie jako NavigationService.Navigate, i rozszerza je, zapewniając, że zawartość, która jest pobierany jest umieszczana w izolowanym częściowej relacji zaufania (z domyślnym zestawem strefy Internet uprawnień — zobacz częściowej relacji zaufania WPF Zabezpieczenia).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).

Zobacz też

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

Przejdź asynchronicznie do źródła zawartości znajdującej się na identyfikator URI i przekazać obiekt, który zawiera dane, które ma być używany dla przetwarzania podczas nawigowania.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

Parametry

source
Uri Uri Uri Uri

A Uri obiekt został zainicjowany przy użyciu identyfikatora URI dla żądanej zawartości.A Uri object initialized with the URI for the desired content.

navigationState
Object Object Object Object

Obiekt, który zawiera dane, które ma być używany do przetworzenia podczas nawigacji.An object that contains data to be used for processing during navigation.

Zwraca

true Jeśli nie zostało anulowane nawigacji; w przeciwnym razie false.true if a navigation is not canceled; otherwise, false.

Przykłady

Poniższy przykład demonstruje, przechodząc do identyfikatora URI i przekazanie Stan nawigacji.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

Uwagi

Ponieważ tego są asynchroniczne, istnieje możliwość, że wiele tego być w toku, w tym samym czasie.Since navigations are asynchronous, it is possible for multiple navigations to be in progress at the same time. Na przykład w przypadku dwóch ramek podrzędnych na jednej stronie, można przejść obie ramki.For example, if there are two child frames on a single page, both frames could be navigating. W tym przypadku różnych zdarzeń nawigacji, które są wywoływane przez NavigationService może być podniesione wiele razy, jeden dla każdego elementu zawartości, do którego następuje do, ale niekoniecznie, tego zażądano.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. W związku z tym jeśli żądanie określonej nawigacji potrzebuje do przetwarzania danych, które są specyficzne dla pojedynczego żądania, nie można użyć danych, która jest dostępna dla wszystkich żądań nawigacji.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. Zamiast tego można użyć navigationState do przekazywania danych dla nawigacji przetwarzania, który jest specyficzny dla nawigacji jednego żądania.Instead, you can use navigationState to pass data for navigation processing that is specific to one navigation request.

Następujące argumenty zdarzenia zapewniają dostęp do Stan nawigacji:The following event arguments provide access to navigation state:

Zobacz też

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

Przejdź asynchronicznie do zawartości, który jest określony przez identyfikator 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

Parametry

source
Uri Uri Uri Uri

A Uri obiekt został zainicjowany przy użyciu identyfikatora URI dla żądanej zawartości.A Uri object initialized with the URI for the desired content.

Zwraca

true Jeśli nie zostało anulowane nawigacji; w przeciwnym razie false.true if a navigation is not canceled; otherwise, false.

Przykłady

Poniższy przykład pokazuje, jak można przejść do identyfikatora 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

Uwagi

Wartość source może być sieć Web Adres URLURL lub prawidłowy identyfikator URI pakietu (zobacz pakiet URI w WPF).The value of source can be a Web Adres URLURL or a valid pack URI (see Pack URIs in WPF).

Navigate spowoduje przejście do określonego przez identyfikator URI source jeśli są spełnione następujące warunki:Navigate will navigate to the URI specified by source if the following conditions are true:

Jeśli source jest null, istniejąca zawartość (Content) jest wyczyszczone.If source is null, the existing content (Content) is cleared.

Uwaga

Podczas pobierania zawartości sieci Web, może pojawić się wyjątek sieci Web (na przykład 404: nie można odnaleźć pliku).When downloading Web content, you may receive a Web exception (for example, 404: File Not Found). Może obsługiwać wyjątków z NavigationFailed.You can handle such exceptions from NavigationFailed.

Możesz użyć Navigate do nawigacji do fragmentu zawartości.You can use Navigate to navigate to a content fragment. Jeśli zawartość identyfikowane przez identyfikator URI jest bieżącej zawartości, nie została pobrana ponownie.If the content identified by the URI is the current content, it is not downloaded again.

Zobacz też

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

Przejdź asynchronicznie do zawartości, która znajduje się za pomocą obiektu.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

Parametry

root
Object Object Object Object

Obiekt, który zawiera zawartość, aby przejść do.An object that contains the content to navigate to.

Zwraca

true Jeśli nie zostało anulowane nawigacji; w przeciwnym razie false.true if a navigation is not canceled; otherwise, false.

Przykłady

Poniższy przykład pokazuje, jak można przejść do Page obiekt zawierający drzewa zawartości źródłowej.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

Uwagi

Navigate spowoduje przejście do Object określony przez root jeśli są spełnione następujące warunki:Navigate will navigate to the Object specified by root if the following conditions are true:

Jeśli root jest null, istniejąca zawartość (Content) jest wyczyszczone.If root is null, the existing content (Content) is cleared.

Uwaga

Podczas pobierania zawartości sieci Web, może pojawić się wyjątek sieci Web (na przykład 404: nie można odnaleźć pliku).When downloading Web content, you may receive a Web exception (for example, 404: File Not Found). Może obsługiwać wyjątków z NavigationFailed.You can handle such exceptions from NavigationFailed.

Zobacz też

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

Asynchronicznie przejdź do zawartości, która znajduje się za pomocą obiektu i przekazać obiekt, który zawiera dane, które ma być używany do przetworzenia podczas nawigacji.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

Parametry

root
Object Object Object Object

Obiekt, który zawiera zawartość, aby przejść do.An object that contains the content to navigate to.

navigationState
Object Object Object Object

Obiekt, który zawiera dane, które ma być używany do przetworzenia podczas nawigacji.An object that contains data to be used for processing during navigation.

Zwraca

true Jeśli nie zostało anulowane nawigacji; w przeciwnym razie false.true if a navigation is not canceled; otherwise, false.

Przykłady

Poniższy przykład pokazuje, jak można przejść do Page obiekt zawierający zawartość źródłową, a następnie przekazanie Stan nawigacji.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

Uwagi

Ta metoda ma takie samo zachowanie jako NavigationService.Navigate, mimo że obiekt jest przekazywany zamiast identyfikatora URI.This method has the same behavior as NavigationService.Navigate, although an object is passed instead of a URI.

Zobacz też

Dotyczy