NavigationService.Navigate Yöntem

Başvuru

Tanım

Ad Alanı:: System.Windows.Navigation

Bütünleştirilmiş Kod:: PresentationFramework.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Belirtilen kaynak içeriğe zaman uyumsuz olarak gidin.

Aşırı Yüklemeler

Navigate(Uri, Object, Boolean)	Bir URI'de bulunan kaynak içeriğe zaman uyumsuz olarak gidin, gezinti sırasında işlenmek üzere gezinti durumunu içeren bir nesne geçirin ve içeriği korumalı alana alın.
Navigate(Uri, Object)	Bir URI'de bulunan kaynak içeriğe zaman uyumsuz olarak gidin ve gezinti sırasında işlenmek üzere kullanılacak verileri içeren bir nesne geçirin.
Navigate(Uri)	URI tarafından belirtilen içeriğe zaman uyumsuz olarak gidin.
Navigate(Object)	Bir nesnenin içerdiği içeriğe zaman uyumsuz olarak gidin.
Navigate(Object, Object)	Bir nesnenin içerdiği içeriğe zaman uyumsuz olarak gidin ve gezinti sırasında işlenmek üzere kullanılacak verileri içeren bir nesneyi geçirin.

Bir URI'de bulunan kaynak içeriğe zaman uyumsuz olarak gidin, gezinti sırasında işlenmek üzere gezinti durumunu içeren bir nesne geçirin ve içeriği korumalı alana alın.

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

Parametreler

source: Uri

Uri İstenen içerik için URI ile başlatılan bir nesne.

navigationState: Object

Gezinti sırasında işleme için kullanılacak verileri içeren bir nesne.

sandboxExternalContent: Boolean

İçeriği kısmi güven güvenlik korumalı alanına indirin (varsa true, varsayılan İnternet bölgesi izin kümesiyle). Varsayılan değer: false.

Döndürülenler

Boolean

true gezinti iptal edilmediyse; aksi takdirde , false.

Açıklamalar

Bu yöntem yalnızca tek başına uygulamalar ve Genişletilebilir Uygulama Biçimlendirme Dili (XAML) içeriği içindir.

Bu yöntem, ile aynı davranışı NavigationService.Navigatesergiler ve indirilmekte olan içeriğin kısmi güven güvenlik korumalı alanına yerleştirildiğinden emin olarak genişletir (varsayılan İnternet bölgesi izin kümesiyle - bkz . WPF Kısmi Güven Güvenliği).

Ayrıca bkz.

Şunlara uygulanır

Bir URI'de bulunan kaynak içeriğe zaman uyumsuz olarak gidin ve gezinti sırasında işlenmek üzere kullanılacak verileri içeren bir nesne geçirin.

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

Parametreler

source: Uri

Uri İstenen içerik için URI ile başlatılan bir nesne.

navigationState: Object

Gezinti sırasında işleme için kullanılacak verileri içeren bir nesne.

Döndürülenler

Boolean

true gezinti iptal edilmediyse; aksi takdirde , false.

Örnekler

Aşağıdaki örnek, URI'ye geçmeyi ve gezinti durumunu geçirmeyi gösterir.

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

Açıklamalar

Gezintiler zaman uyumsuz olduğundan, birden çok gezintinin aynı anda devam ediyor olması mümkündür. Örneğin, tek bir sayfada iki alt çerçeve varsa, her iki çerçeve de geziniyor olabilir. Bu durumda, tarafından NavigationService tetiklenen çeşitli gezinti olayları, gidilen her içerik parçası için bir tane olmak üzere birden çok kez tetiklenebilir ve gezintilerin istendiği sırada olması gerekmez. Sonuç olarak, belirli bir gezinti isteğinin tek tek isteğe özgü verileri işlemesi gerekiyorsa, tüm gezinti isteklerinde kullanılabilen verileri kullanamaz. Bunun yerine, tek bir gezinti isteğine özgü gezinti işleme verilerini geçirmek için kullanabilirsiniz navigationState .

Aşağıdaki olay bağımsız değişkenleri gezinti durumuna erişim sağlar:

ExtraData (olaya geçirilir Navigating ).
ExtraData(, , NavigationStopped LoadCompleted olay işleyicilerine geçirilirNavigated).

Ayrıca bkz.

Şunlara uygulanır

URI tarafından belirtilen içeriğe zaman uyumsuz olarak gidin.

public:
 bool Navigate(Uri ^ source);

public bool Navigate (Uri source);

member this.Navigate : Uri -> bool

Public Function Navigate (source As Uri) As Boolean

Parametreler

source: Uri

Uri İstenen içerik için URI ile başlatılan bir nesne.

Döndürülenler

Boolean

true gezinti iptal edilmediyse; aksi takdirde , false.

Örnekler

Aşağıdaki örnekte URI'ye nasıl gid gidildi gösterilmektedir.

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

Açıklamalar

değeri source bir Web URL'si veya geçerli bir paket URI'si olabilir (bkz. WPF'de URI'leri paketleme).

Navigate aşağıdaki koşullar doğruysa tarafından source belirtilen URI'ye gider:

Etkinlik Navigating iptal edilmiyor.
Bir web isteği (bkz Navigating. ) oluşturulabilir.

ise sourcenull, mevcut içerik (Content) temizlenir.

Not

Web içeriğini indirirken bir Web özel durumu alabilirsiniz (örneğin, 404: Dosya Bulunamadı). bu tür özel durumları içinden NavigationFailedişleyebilirsiniz.

bir içerik parçasına gitmek için kullanabilirsiniz Navigate . URI tarafından tanımlanan içerik geçerli içerikse, yeniden indirılmaz.

Ayrıca bkz.

Şunlara uygulanır

Bir nesnenin içerdiği içeriğe zaman uyumsuz olarak gidin.

public:
 bool Navigate(System::Object ^ root);

public bool Navigate (object root);

member this.Navigate : obj -> bool

Public Function Navigate (root As Object) As Boolean

Parametreler

root: Object

Gidecek içeriği içeren bir nesne.

Döndürülenler

Boolean

true gezinti iptal edilmediyse; aksi takdirde , false.

Örnekler

Aşağıdaki örnekte, kaynak içerik ağacını içeren bir Page nesneye nasıl gidilmesi gösterilmektedir.

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

Açıklamalar

Navigateaşağıdaki koşullar doğruysa belirtilen root değerine giderObject:

Etkinlik Navigating iptal edilmiyor.
Bir web isteği (bkz Navigating. ) oluşturulabilir.

ise rootnull, mevcut içerik (Content) temizlenir.

Not

Web içeriğini indirirken bir Web özel durumu alabilirsiniz (örneğin, 404: Dosya Bulunamadı). bu tür özel durumları içinden NavigationFailedişleyebilirsiniz.

Ayrıca bkz.

Şunlara uygulanır

Bir nesnenin içerdiği içeriğe zaman uyumsuz olarak gidin ve gezinti sırasında işlenmek üzere kullanılacak verileri içeren bir nesneyi geçirin.

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

Parametreler

root: Object

Gidecek içeriği içeren bir nesne.

navigationState: Object

Gezinti sırasında işleme için kullanılacak verileri içeren bir nesne.

Döndürülenler

Boolean

true gezinti iptal edilmediyse; aksi takdirde , false.

Örnekler

Aşağıdaki örnekte, kaynak içeriği içeren bir Page nesneye nasıl gidilmesi ve gezinti durumunun geçirilmesi gösterilmektedir.

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

Açıklamalar

URI yerine bir nesne geçirilse de, bu yöntem ile aynı davranışa NavigationService.Navigatesahiptir.

Ayrıca bkz.

Şunlara uygulanır

Aracılığıyla paylaş

NavigationService.Navigate Yöntem

Tanım

Aşırı Yüklemeler

Navigate(Uri, Object, Boolean)

Parametreler

Döndürülenler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Navigate(Uri, Object)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Navigate(Uri)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Navigate(Object)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Navigate(Object, Object)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar