NavigationService.Navigate Metoda

Definice

Obor názvů:: System.Windows.Navigation

Sestavení:: PresentationFramework.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přejděte asynchronně na zadaný zdrojový obsah.

Přetížení

Name	Description
Navigate(Uri, Object, Boolean)	Asynchronně přejděte ke zdrojovému obsahu umístěnému v identifikátoru URI, předejte objekt obsahující navigační stav pro zpracování během navigace a obsah sandboxu.
Navigate(Uri, Object)	Přejděte asynchronně ke zdrojovému obsahu umístěnému v identifikátoru URI a předejte objekt obsahující data, která se mají použít ke zpracování během navigace.
Navigate(Uri)	Asynchronně přejděte k obsahu určenému identifikátorem URI.
Navigate(Object)	Asynchronně přejděte k obsahu, který je obsažen objektem.
Navigate(Object, Object)	Přejděte asynchronně na obsah obsažený objektem a předejte objekt obsahující data, která se mají použít ke zpracování během navigace.

Asynchronně přejděte ke zdrojovému obsahu umístěnému v identifikátoru URI, předejte objekt obsahující navigační stav pro zpracování během navigace a obsah sandboxu.

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 Objekt inicializovaný s identifikátorem URI požadovaného obsahu.

navigationState: Object

Objekt, který obsahuje data, která se mají použít ke zpracování během navigace.

sandboxExternalContent: Boolean

Stáhněte obsah do izolovaného prostoru zabezpečení s částečnou důvěryhodností (s výchozí sadou oprávnění zóny Internetu, pokud true. Výchozí hodnota je false.

Návraty

Boolean

truepokud není zrušena navigace; v opačném případě . false

Poznámky

Tato metoda je určena pouze pro samostatné aplikace a obsah JAZYKa XAML (Extensible Application Markup Language).

Tato metoda vykazuje stejné chování jako NavigationService.Navigatea rozšiřuje ho tím, že zajišťuje, že obsah, který se stahuje, je umístěn do částečně důvěryhodného sandboxu zabezpečení (s výchozí sadou oprávnění zóny internetu – viz část Zabezpečení částečné důvěryhodnosti WPF).

Viz také

Platí pro

Přejděte asynchronně ke zdrojovému obsahu umístěnému v identifikátoru URI a předejte objekt obsahující data, která se mají použít ke zpracování během navigace.

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 Objekt inicializovaný s identifikátorem URI požadovaného obsahu.

navigationState: Object

Objekt, který obsahuje data, která se mají použít ke zpracování během navigace.

Návraty

Boolean

truepokud není zrušena navigace; v opačném případě . false

Příklady

Následující příklad ukazuje navigaci do identifikátoru URI a předávání stavu navigace.

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

Poznámky

Vzhledem k tomu, že navigace jsou asynchronní, je možné, že najednou probíhá více navigačních panelů. Pokud jsou například na jedné stránce dva podřízené rámce, můžou být oba snímky přecházení. V takovém případě mohou být vyvolány různé navigační události, které jsou vyvolány NavigationService vícekrát, jeden pro každou část obsahu, ke které se prochází, a ne nutně v pořadí, v jakém byly požadovány navigace. V důsledku toho, pokud konkrétní navigační požadavek potřebuje zpracovat data specifická pro jednotlivé požadavky, nemůže použít data, která jsou k dispozici pro všechny požadavky navigace. Místo toho můžete použít navigationState k předávání dat pro zpracování navigace, která jsou specifická pro jeden požadavek navigace.

Následující argumenty události poskytují přístup k navigačnímu stavu:

ExtraData (předáno události Navigating ).
ExtraData(předáno obslužné rutině Navigatedudálosti , NavigationStopped LoadCompleted

Viz také

Platí pro

Asynchronně přejděte k obsahu určenému identifikátorem 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 Objekt inicializovaný s identifikátorem URI požadovaného obsahu.

Návraty

Boolean

truepokud není zrušena navigace; v opačném případě . false

Příklady

Následující příklad ukazuje, jak přejít na identifikátor 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

Poznámky

Hodnota source může být webová adresa URL nebo platný identifikátor URI balíčku (viz identifikátory URI balíčků ve WPF).

Navigate přejde na identifikátor URI určený source v případě, že jsou splněny následující podmínky:

Událost Navigating není zrušena.
Je možné vytvořit webový požadavek (viz Navigating).

Pokud source ano null, stávající obsah (Content) se vymaže.

Note

Při stahování webového obsahu může dojít k výjimce webu (například 404: Soubor nebyl nalezen). Tyto výjimky můžete zpracovat z NavigationFailed.

Můžete použít Navigate k přechodu na fragment obsahu. Pokud je obsah identifikovaný identifikátorem URI aktuální obsah, nestáhnou se znovu.

Viz také

Platí pro

Asynchronně přejděte k obsahu, který je obsažen objektem.

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

Objekt, který obsahuje obsah, na který chcete přejít.

Návraty

Boolean

truepokud není zrušena navigace; v opačném případě . false

Příklady

Následující příklad ukazuje, jak přejít na Page objekt obsahující strom zdrojového obsahu.

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

Poznámky

Navigate přejde na zadanou Object podmínkou root , pokud jsou splněny následující podmínky:

Událost Navigating není zrušena.
Je možné vytvořit webový požadavek (viz Navigating).

Pokud root ano null, stávající obsah (Content) se vymaže.

Note

Při stahování webového obsahu může dojít k výjimce webu (například 404: Soubor nebyl nalezen). Tyto výjimky můžete zpracovat z NavigationFailed.

Viz také

Platí pro

Přejděte asynchronně na obsah obsažený objektem a předejte objekt obsahující data, která se mají použít ke zpracování během navigace.

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

Objekt, který obsahuje obsah, na který chcete přejít.

navigationState: Object

Objekt, který obsahuje data, která se mají použít ke zpracování během navigace.

Návraty

Boolean

truepokud není zrušena navigace; v opačném případě . false

Příklady

Následující příklad ukazuje, jak přejít na Page objekt obsahující zdrojový obsah a předat stav navigace.

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

Poznámky

Tato metoda má stejné chování jako NavigationService.Navigate, ačkoli objekt je předán místo identifikátoru URI.

Viz také

Platí pro

Váš názor

Byla tato stránka užitečná?

NavigationService.Navigate Metoda

Definice

Přetížení

Navigate(Uri, Object, Boolean)

Parametry

Návraty

Poznámky

Viz také

Platí pro

Navigate(Uri, Object)

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

Navigate(Uri)

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

Navigate(Object)

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

Navigate(Object, Object)

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

Váš názor