NavigationService.Navigate Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Navigera asynkront till det angivna källinnehållet.
Överlagringar
| Name | Description |
|---|---|
| Navigate(Uri, Object, Boolean) |
Navigera asynkront till källinnehåll som finns på en URI, skicka ett objekt som innehåller navigeringstillstånd för bearbetning under navigeringen och sandbox-innehåll. |
| Navigate(Uri, Object) |
Navigera asynkront till källinnehåll som finns på en URI och skicka ett objekt som innehåller data som ska användas för bearbetning under navigeringen. |
| Navigate(Uri) |
Navigera asynkront till innehåll som anges av en URI. |
| Navigate(Object) |
Navigera asynkront till innehåll som finns i ett objekt. |
| Navigate(Object, Object) |
Navigera asynkront till innehåll som finns i ett objekt och skicka ett objekt som innehåller data som ska användas för bearbetning under navigeringen. |
Navigate(Uri, Object, Boolean)
Navigera asynkront till källinnehåll som finns på en URI, skicka ett objekt som innehåller navigeringstillstånd för bearbetning under navigeringen och sandbox-innehåll.
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
Parametrar
- navigationState
- Object
Ett objekt som innehåller data som ska användas för bearbetning under navigeringen.
- sandboxExternalContent
- Boolean
Ladda ned innehåll till en partiell säkerhetssandlåda för förtroende (med standarduppsättningen för Internetzon med behörigheter, om true. Standardvärdet är false.
Returer
trueom en navigering inte har avbrutits. annars . false
Kommentarer
Den här metoden är endast för fristående program och XAML-innehåll (Extensible Application Markup Language).
Den här metoden uppvisar samma beteende som NavigationService.Navigate och utökar det genom att se till att innehållet som laddas ned placeras i en partiell säkerhetssandlåda (med standarduppsättningen för Internetzon med behörigheter – se WPF Partial Trust Security).
Se även
Gäller för
Navigate(Uri, Object)
Navigera asynkront till källinnehåll som finns på en URI och skicka ett objekt som innehåller data som ska användas för bearbetning under navigeringen.
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
Parametrar
- navigationState
- Object
Ett objekt som innehåller data som ska användas för bearbetning under navigeringen.
Returer
trueom en navigering inte har avbrutits. annars . false
Exempel
I följande exempel visas hur du navigerar till en URI och skickar navigeringstillstånd.
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
Kommentarer
Eftersom navigeringen är asynkron är det möjligt att flera navigeringer pågår samtidigt. Om det till exempel finns två underordnade ramar på en enda sida kan båda bildrutorna navigera. I det här fallet kan de olika navigeringshändelser som genereras av NavigationService höjas flera gånger, en för varje innehåll som navigeras till, och inte nödvändigtvis för att navigeringen begärdes. Om en viss navigeringsbegäran behöver bearbeta data som är specifika för den enskilda begäran kan den därför inte använda data som är tillgängliga för alla navigeringsbegäranden. I stället kan du använda navigationState för att skicka data för navigeringsbearbetning som är specifik för en navigeringsbegäran.
Följande händelseargument ger åtkomst till navigeringstillstånd:
ExtraData (skickas Navigating till händelsen).
ExtraData(skickas till Navigatedhändelsehanterarna , NavigationStoppedLoadCompleted ).
Se även
Gäller för
Navigate(Uri)
Navigera asynkront till innehåll som anges av en URI.
public:
bool Navigate(Uri ^ source);
public bool Navigate(Uri source);
member this.Navigate : Uri -> bool
Public Function Navigate (source As Uri) As Boolean
Parametrar
Returer
trueom en navigering inte har avbrutits. annars . false
Exempel
I följande exempel visas hur du navigerar till en 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
Kommentarer
Värdet för source kan vara en webb-URL eller en giltig paket-URI (se Pack-URI:er i WPF).
Navigate navigerar till den URI som anges av source om följande villkor är uppfyllda:
Händelsen Navigating avbryts inte.
En webbbegäran (se Navigating) kan skapas.
Om source är nullrensas det befintliga innehållet (Content).
Note
När du laddar ned webbinnehåll kan du få ett webbfel (till exempel 404: Filen hittades inte). Du kan hantera sådana undantag från NavigationFailed.
Du kan använda Navigate för att navigera till ett innehållsfragment. Om innehållet som identifieras av URI:n är det aktuella innehållet laddas det inte ned igen.
Se även
Gäller för
Navigate(Object)
Navigera asynkront till innehåll som finns i ett objekt.
public:
bool Navigate(System::Object ^ root);
public bool Navigate(object root);
member this.Navigate : obj -> bool
Public Function Navigate (root As Object) As Boolean
Parametrar
- root
- Object
Ett objekt som innehåller det innehåll som ska navigeras till.
Returer
trueom en navigering inte har avbrutits. annars . false
Exempel
I följande exempel visas hur du navigerar till ett Page objekt som innehåller källinnehållsträdet.
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
Kommentarer
Navigate navigerar till angivet Object av root om följande villkor är sanna:
Händelsen Navigating avbryts inte.
En webbbegäran (se Navigating) kan skapas.
Om root är nullrensas det befintliga innehållet (Content).
Note
När du laddar ned webbinnehåll kan du få ett webbfel (till exempel 404: Filen hittades inte). Du kan hantera sådana undantag från NavigationFailed.
Se även
Gäller för
Navigate(Object, Object)
Navigera asynkront till innehåll som finns i ett objekt och skicka ett objekt som innehåller data som ska användas för bearbetning under navigeringen.
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
Parametrar
- root
- Object
Ett objekt som innehåller det innehåll som ska navigeras till.
- navigationState
- Object
Ett objekt som innehåller data som ska användas för bearbetning under navigeringen.
Returer
trueom en navigering inte har avbrutits. annars . false
Exempel
I följande exempel visas hur du navigerar till ett Page objekt som innehåller källinnehållet och skickar navigeringstillstånd.
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
Kommentarer
Den här metoden har samma beteende som NavigationService.Navigate, även om ett objekt skickas i stället för en URI.