NavigationService.Navigate Yöntem

Tanım

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.

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.

C#
public bool Navigate (Uri source, object navigationState, bool sandboxExternalContent);

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

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

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public bool Navigate (Uri source, object navigationState);

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

true gezinti iptal edilmediyse; aksi takdirde , false.

Örnekler

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

C#
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);
}

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:

Ayrıca bkz.

Şunlara uygulanır

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Navigate(Uri)

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

C#
public bool Navigate (Uri source);

Parametreler

source
Uri

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

Döndürülenler

true gezinti iptal edilmediyse; aksi takdirde , false.

Örnekler

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

C#
void goButton_Click(object sender, RoutedEventArgs e)
{
    this.NavigationService.Navigate(new Uri(this.addressTextBox.Text));
}

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:

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

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Navigate(Object)

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

C#
public bool Navigate (object root);

Parametreler

root
Object

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

Döndürülenler

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.

C#
void goObjectButton_Click(object sender, RoutedEventArgs e)
{
    this.NavigationService.Navigate(new ContentPage());
}

Açıklamalar

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

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

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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.

C#
public bool Navigate (object root, object navigationState);

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

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.

C#
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);
}

Açıklamalar

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

Ayrıca bkz.

Şunlara uygulanır

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9