.NET MAUI Kabuğu gezintisi

Makale
02/13/2024

.NET Çok Platformlu Uygulama Kullanıcı Arabirimi (.NET MAUI) Kabuğu, belirli bir gezinti hiyerarşisini izlemek zorunda kalmadan uygulamadaki herhangi bir sayfaya gitmek için yolları kullanan URI tabanlı bir gezinti deneyimi içerir. Buna ek olarak, gezinti yığınındaki tüm sayfaları ziyaret etmek zorunda kalmadan geriye doğru gezinme olanağı da sağlar.

Shell sınıfı, gezintiyle ilgili aşağıdaki özellikleri tanımlar:

BackButtonBehavior, türünde BackButtonBehavior, geri düğmesinin davranışını tanımlayan ekli bir özelliktir.
CurrentItem, türüne ShellItemgöre seçili durumdaki öğedir.
CurrentPage, türündeki Page, şu anda sunulan sayfadır.
CurrentState, türündeki ShellNavigationStategeçerli gezinti durumu Shell.
Current, türüne göre Shell, için Application.Current.MainPagetür tarafından yazılan bir diğer addır.

BackButtonBehavior, CurrentItemve CurrentState özellikleri nesneler tarafından BindableProperty desteklenir; bu da bu özelliklerin veri bağlamalarının hedefleri olabileceği anlamına gelir.

Gezinti, Shell sınıfından GoToAsync yöntemi çağrılarak gerçekleştirilir. Gezinti gerçekleştirilmek üzereyken olay Navigating tetiklenir ve Navigated gezinti tamamlandığında olay tetiklenir.

Dekont

Özelliği kullanılarak Navigation bir Shell uygulamasındaki sayfalar arasında gezinti yine de gerçekleştirilebilir. Daha fazla bilgi için bkz . Modsuz gezinti gerçekleştirme.

Rotalar

Gezinti, gidilmesi gereken bir URI belirtilerek bir Shell uygulamasında gerçekleştirilir. Gezinti URI'lerinin üç bileşeni olabilir:

Shell görsel hiyerarşisinin bir parçası olarak var olan içeriğe giden yolu tanımlayan bir yol.
Bir sayfa. Shell görsel hiyerarşisinde mevcut olmayan sayfalar, bir Shell uygulamasının içinde herhangi bir yerden gezinti yığınına gönderilebilir. Örneğin, ayrıntılar sayfası Kabuk görsel hiyerarşisinde tanımlanamaz, ancak gerektiğinde gezinti yığınına gönderilebilir.
Bir veya daha fazla sorgu parametresi. Sorgu parametreleri, gezinirken hedef sayfaya geçirilebilen parametrelerdir.

Gezinti URI'sinin üç bileşeni de içerdiğinde yapısı şöyle olur: //route/page?queryParameters

Yolları kaydetme

Yollar, özellikleri aracılığıyla , TabBar, Tabve ShellContent nesnelerinde RouteFlyoutItemtanımlanabilir:

<Shell ...>
    <FlyoutItem ...
                Route="animals">
        <Tab ...
             Route="domestic">
            <ShellContent ...
                          Route="cats" />
            <ShellContent ...
                          Route="dogs" />
        </Tab>
        <ShellContent ...
                      Route="monkeys" />
        <ShellContent ...
                      Route="elephants" />  
        <ShellContent ...
                      Route="bears" />
    </FlyoutItem>
    <ShellContent ...
                  Route="about" />                  
    ...
</Shell>

Dekont

Kabuk hiyerarşisindeki tüm öğelerin kendisiyle ilişkilendirilmiş bir yolu vardır. Yol ayarlamazsanız, çalışma zamanında bir yol oluşturulur. Ancak oluşturulan yolların farklı uygulama oturumlarında tutarlı olması garanti edilmemektedir.

Yukarıdaki örnek, programlı gezintide kullanılabilecek aşağıdaki yol hiyerarşisini oluşturur:

animals
  domestic
    cats
    dogs
  monkeys
  elephants
  bears
about

Rotanın nesnesine ShellContent gitmek için dogs mutlak yol URI'si şeklindedir //animals/domestic/dogs. Benzer şekilde, yolun nesnesine ShellContent gitmek için about mutlak yol URI'si şeklindedir //about.

Uyarı

ArgumentException Yinelenen bir yol algılanırsa uygulama başlangıcında bir oluşturulur. Bu özel durum, hiyerarşide aynı düzeydeki iki veya daha fazla yol bir yol adını paylaşırsa da oluşturulur.

Ayrıntı sayfası yollarını kaydetme

Alt sınıf oluşturucusunda Shell veya bir yol çağrılmadan önce çalışan başka bir konumda, Kabuk görsel hiyerarşisinde temsil edilmeen tüm ayrıntı sayfaları için açıkça ek yollar kaydedilebilir. Bu, yöntemiyle Routing.RegisterRoute gerçekleştirilir:

Routing.RegisterRoute("monkeydetails", typeof(MonkeyDetailPage));
Routing.RegisterRoute("beardetails", typeof(BearDetailPage));
Routing.RegisterRoute("catdetails", typeof(CatDetailPage));
Routing.RegisterRoute("dogdetails", typeof(DogDetailPage));
Routing.RegisterRoute("elephantdetails", typeof(ElephantDetailPage));

Bu örnek, alt sınıfta tanımlanmayan Shell ayrıntı sayfalarını yol olarak kaydeder. Daha sonra bu ayrıntı sayfaları, uygulamanın içinde herhangi bir yerden URI tabanlı gezinti kullanılarak değiştirilebilir. Bu tür sayfaların yolları genel yollar olarak bilinir.

Uyarı

yöntemi aynı yolu iki veya daha fazla farklı türe kaydetmeyi denerse Routing.RegisterRoute bir ArgumentException oluşturulur.

Alternatif olarak, sayfalar gerekirse farklı yol hiyerarşilerine kaydedilebilir:

Routing.RegisterRoute("monkeys/details", typeof(MonkeyDetailPage));
Routing.RegisterRoute("bears/details", typeof(BearDetailPage));
Routing.RegisterRoute("cats/details", typeof(CatDetailPage));
Routing.RegisterRoute("dogs/details", typeof(DogDetailPage));
Routing.RegisterRoute("elephants/details", typeof(ElephantDetailPage));

Bu örnek bağlamsal sayfa gezintisini details etkinleştirir; burada rotanın sayfasından yola gitmek için monkeys öğesini görüntüler MonkeyDetailPage. Benzer şekilde, yolun sayfasından details yola gitmek için elephants öğesini görüntüler ElephantDetailPage. Daha fazla bilgi için bkz . Bağlamsal gezinti.

Dekont

Yolları yöntemiyle Routing.RegisterRoute kaydedilmiş sayfaların kaydı gerekirse yöntemiyle Routing.UnRegisterRoute silinebilir.

Gezinti gerçekleştirmek için önce alt sınıfa Shell bir başvuru alınmalıdır. Bu başvuru, özelliği bir Shell nesneye App.Current.MainPage atanarak veya özelliği aracılığıyla Shell.Current elde edilebilir. Daha sonra nesnede Shell yöntemi çağrılarak GoToAsync gezinti gerçekleştirilebilir. Bu yöntem, öğesine ShellNavigationState gider ve gezinti animasyonu tamamlandıktan sonra tamamlanacak bir Task döndürür. ShellNavigationState nesnesi yöntemi tarafından GoToAsync bir veya Uriöğesinden stringoluşturulur ve özelliği veya Uri bağımsız değişkenine string ayarlanmıştırLocation.

Önemli

Kabuk görsel hiyerarşisinden bir rotaya gidildiğinde, gezinti yığını oluşturulmaz. Ancak, Kabuk görsel hiyerarşisinde olmayan bir sayfaya gidildiğinde bir gezinti yığını oluşturulur.

Nesnenin Shell geçerli gezinti durumu, özelliğinde Shell.Current.CurrentState görüntülenen yolun URI'sini Location içeren özelliği aracılığıyla alınabilir.

Mutlak yollar

Gezinti, yöntemine bağımsız değişken GoToAsync olarak geçerli bir mutlak URI belirtilerek gerçekleştirilebilir:

await Shell.Current.GoToAsync("//animals/monkeys");

Bu örnek, rotanın sayfasına monkeys gider ve yol bir ShellContent nesnede tanımlanır. Yolu ShellContent temsil monkeys eden nesne, yolu olan bir FlyoutItem nesnenin alt öğesidir animals.

Göreli yollar

Gezinti, yöntemine bağımsız değişken GoToAsync olarak geçerli bir göreli URI belirtilerek de gerçekleştirilebilir. Yönlendirme sistemi, URI'yi bir ShellContent nesneyle eşleştirmeyi dener. Bu nedenle, bir uygulamadaki tüm yollar benzersizse, gezinti yalnızca benzersiz yol adı göreli URI olarak belirtilerek gerçekleştirilebilir.

Aşağıdaki göreli yol biçimleri desteklenir:

Biçimlendir	Açıklama
Rota	Yol hiyerarşisi, geçerli konumdan yukarı doğru belirtilen yol için aranacak. Eşleşen sayfa gezinti yığınına gönderilir.
/Rota	Yol hiyerarşisi, belirtilen rotadan, geçerli konumdan aşağı doğru aranır. Eşleşen sayfa gezinti yığınına gönderilir.
//Rota	Yol hiyerarşisi, geçerli konumdan yukarı doğru belirtilen yol için aranacak. Eşleşen sayfa gezinti yığınının yerini alır.
///Rota	Rota hiyerarşisi, geçerli konumdan aşağı doğru belirtilen yol için aranır. Eşleşen sayfa gezinti yığınının yerini alır.

Aşağıdaki örnek, yolun sayfasına monkeydetails gider:

await Shell.Current.GoToAsync("monkeydetails");

Bu örnekte, eşleşen sayfa bulunana monkeyDetails kadar yol hiyerarşiyi yukarı doğru arar. Sayfa bulunduğunda gezinti yığınına gönderilir.

Göreli yollar bağlamsal gezintiyi etkinleştirir. Örneğin, aşağıdaki yol hiyerarşisini göz önünde bulundurun:

monkeys
  details
bears
  details

Rotanın monkeys kayıtlı sayfası görüntülendiğinde, rotaya details gitmek yol için kayıtlı sayfayı monkeys/details görüntüler. Benzer şekilde, rotanın bears kayıtlı sayfası görüntülendiğinde, rotaya details gitmek, yolun kayıtlı sayfasını bears/details görüntüler. Bu örnekte yolları kaydetme hakkında bilgi için bkz . Sayfa yollarını kaydetme.

Yöntemin bağımsız değişkeni GoToAsync olarak ".." belirtilerek geriye doğru gezinti gerçekleştirilebilir:

await Shell.Current.GoToAsync("..");

".." ile geriye doğru gezinti bir yol ile de birleştirilebilir:

await Shell.Current.GoToAsync("../route");

Bu örnekte geriye doğru gezinti gerçekleştirilir ve ardından belirtilen yola gezinti yapılır.

Önemli

Geriye doğru ve belirtilen bir yola gitmek, yalnızca geriye doğru gezintinin sizi belirtilen yola gitmek için yol hiyerarşisindeki geçerli konuma getirmesi durumunda mümkündür.

Benzer şekilde, birden çok kez geriye gitmek ve ardından belirtilen bir yola gitmek mümkündür:

await Shell.Current.GoToAsync("../../route");

Bu örnekte, geriye doğru gezinti iki kez gerçekleştirilir ve ardından belirtilen yola gezinti yapılır.

Buna ek olarak, veriler geriye doğru gezinirken sorgu özellikleri aracılığıyla geçirilebilir:

await Shell.Current.GoToAsync($"..?parameterToPassBack={parameterValueToPassBack}");

Bu örnekte geriye doğru gezinti gerçekleştirilir ve sorgu parametresi değeri önceki sayfadaki sorgu parametresine geçirilir.

Dekont

Sorgu parametreleri herhangi bir geriye dönük gezinti isteğine eklenebilir.

Gezinirken veri geçirme hakkında daha fazla bilgi için bkz . Verileri geçirme.

Geçersiz yollar

Aşağıdaki yol biçimleri geçersiz:

Biçimlendir	Açıklama
//page veya ///page	Genel yollar şu anda gezinti yığınındaki tek sayfa olamaz. Bu nedenle, genel yollara mutlak yönlendirme desteklenmez.

Bu yol biçimlerinin kullanılması, bir Exception atılmasıyla sonuçlanıyor.

Uyarı

Varolmayan bir yola gidilmeye çalışılırsa bir ArgumentException özel durum oluşur.

Shell sınıflarından bazıları, hata ayıklayıcısı tarafından bir sınıfın DebuggerDisplayAttributeveya alanın nasıl görüntüleneceğini belirten ile dekore edilmiştir. Bu, gezinti isteğiyle ilgili verileri görüntüleyerek gezinti isteklerinde hata ayıklamaya yardımcı olabilir. Örneğin, aşağıdaki ekran görüntüsü nesnenin CurrentItem ve CurrentState özelliklerini Shell.Current gösterir:

Screenshot of debugger.

Bu örnekte, türündeki CurrentItemFlyoutItemözelliği nesnenin FlyoutItem başlığını ve yolunu görüntüler. Benzer şekilde, türündeki CurrentStateShellNavigationStateözelliği, Shell uygulamasında görüntülenen yolun URI'sini görüntüler.

Tab sınıfı, içindeki Tabgeçerli gezinti yığınını temsil eden türünde IReadOnlyList<Page>bir Stack özellik tanımlar. sınıfı aşağıdaki geçersiz kılınabilir gezinti yöntemlerini de sağlar:

GetNavigationStack, geçerli gezinti yığınını döndürür IReadOnlyList<Page>.
OnInsertPageBefore, çağrıldığında INavigation.InsertPageBefore çağrılır.
OnPopAsyncTask<Page>, döndürür ve çağrıldığında INavigation.PopAsync çağrılır.
OnPopToRootAsyncTask, döndürür ve çağrıldığında INavigation.OnPopToRootAsync çağrılır.
OnPushAsyncTask, döndürür ve çağrıldığında INavigation.PushAsync çağrılır.
OnRemovePage, çağrıldığında INavigation.RemovePage çağrılır.

Aşağıdaki örnekte yönteminin nasıl geçersiz kılınacak olduğu gösterilmektedir OnRemovePage :

public class MyTab : Tab
{
    protected override void OnRemovePage(Page page)
    {
        base.OnRemovePage(page);

        // Custom logic
    }
}

Bu örnekte nesneler, MyTab nesneler yerine Tab Shell görsel hiyerarşinizde kullanılmalıdır.

sınıfı Shell , programlı gezinti veya kullanıcı etkileşimi nedeniyle gezinti gerçekleştirilmek üzereyken tetiklenen olayı tanımlar Navigating . Olaya ShellNavigatingEventArgs eşlik Navigating eden nesne aşağıdaki özellikleri sağlar:

Özellik	Türü	Açıklama
`Current`	`ShellNavigationState`	Geçerli sayfanın URI'sini.
`Source`	`ShellNavigationSource`	Oluşan gezinti türü.
`Target`	`ShellNavigationState`	Gezintinin hedeflendiği yeri temsil eden URI.
`CanCancel`	`bool`	Gezintiyi iptal etmek mümkün olup olmadığını gösteren bir değer.
`Cancelled`	`bool`	Gezintinin iptal edilip iptal edilmediğini gösteren değer.

Ayrıca sınıfı, gezintiyi ShellNavigatingEventArgs iptal etmek için kullanılabilecek bir Cancel yöntem ve GetDeferral gezintiyi tamamlamak için kullanılabilecek bir belirteç döndüren bir ShellNavigatingDeferral yöntem sağlar. Gezinti erteleme hakkında daha fazla bilgi için bkz . Gezinti erteleme.

sınıfı Shell , gezinti tamamlandığında tetiklenen olayı da tanımlar Navigated . Olaya ShellNavigatedEventArgs eşlik Navigated eden nesne aşağıdaki özellikleri sağlar:

Özellik	Türü	Açıklama
`Current`	`ShellNavigationState`	Geçerli sayfanın URI'sini.
`Previous`	`ShellNavigationState`	Önceki sayfanın URI'sini.
`Source`	`ShellNavigationSource`	Oluşan gezinti türü.

Önemli

OnNavigating yöntemi, olay tetiklendiğinde Navigating çağrılır. Benzer şekilde, OnNavigated olay tetiklendiğinde Navigated yöntemi çağrılır. Gezinti isteklerini kesmek için her iki yöntem de alt sınıfınızda Shell geçersiz kılınabilir.

ShellNavigatedEventArgs ve ShellNavigatingEventArgs sınıflarının her ikisi de türünde ShellNavigationSourceözelliklere sahiptirSource. Bu numaralandırma aşağıdaki değerleri sağlar:

Unknown
Push
Pop
PopToRoot
Insert
Remove
ShellItemChanged
ShellSectionChanged
ShellContentChanged

Bu nedenle, gezinti bir OnNavigating geçersiz kılmada kesilebilir ve gezinti kaynağı temelinde eylemler gerçekleştirilebilir. Örneğin, aşağıdaki kod sayfadaki veriler kaydedilmemişse geriye doğru gezinmeyi nasıl iptal edileceğini gösterir:

protected override void OnNavigating(ShellNavigatingEventArgs args)
{
    base.OnNavigating(args);

    // Cancel any back navigation.
    if (args.Source == ShellNavigationSource.Pop)
    {
        args.Cancel();
    }
// }

Kabuk gezintisi, kullanıcı seçimine göre kesilebilir, tamamlanabilir veya iptal edilebilir. Bu, alt sınıfınızdaki Shell yöntemi geçersiz kılarak OnNavigating ve nesnesi üzerinde GetDeferralShellNavigatingEventArgs yöntemini çağırarak gerçekleştirilebilir. Bu yöntem, gezinti isteğini tamamlamak için kullanılabilecek bir yöntemi olan bir Complete belirteç döndürürShellNavigatingDeferral:

public MyShell : Shell
{
    // ...
    protected override async void OnNavigating(ShellNavigatingEventArgs args)
    {
        base.OnNavigating(args);

        ShellNavigatingDeferral token = args.GetDeferral();

        var result = await DisplayActionSheet("Navigate?", "Cancel", "Yes", "No");
        if (result != "Yes")
        {
            args.Cancel();
        }
        token.Complete();
    }    
}

Bu örnekte, kullanıcıyı gezinti isteğini tamamlamaya veya iptal etmeye davet eden bir eylem sayfası görüntülenir. Nesnede yöntemi ShellNavigatingEventArgs çağrılarak Cancel gezinti iptal edilir. Gezinti, nesnesindeki Complete yöntemi tarafından alınan belirteçte yöntemi ShellNavigatingDeferralShellNavigatingEventArgs çağrılarak GetDeferral tamamlanır.

Uyarı

Bir GoToAsync kullanıcı bekleyen bir InvalidOperationException gezinti ertelemesi varken gezinmeyi denerse yöntemi bir oluşturur.

Verileri geçirme

URI tabanlı programlı gezinti gerçekleştirilirken ilkel veriler dize tabanlı sorgu parametreleri olarak geçirilebilir. Bu, bir yolun arkasına eklenerek ve ardından bir sorgu parametresi kimliği, =ve bir değer eklenerek ? elde edilir:

async void OnCollectionViewSelectionChanged(object sender, SelectionChangedEventArgs e)
{
    string elephantName = (e.CurrentSelection.FirstOrDefault() as Animal).Name;
    await Shell.Current.GoToAsync($"elephantdetails?name={elephantName}");
}

Bu örnek, içinde seçili durumdaki CollectionViewfili alır ve sorgu parametresi olarak geçirerek elephantName yola giderelephantdetails.

Birden çok kullanımlı nesne tabanlı gezinti verileri, bağımsız değişken belirten IDictionary<string, object> bir GoToAsync aşırı yüklemeyle geçirilebilir:

async void OnCollectionViewSelectionChanged(object sender, SelectionChangedEventArgs e)
{
    Animal animal = e.CurrentSelection.FirstOrDefault() as Animal;
    var navigationParameter = new Dictionary<string, object>
    {
        { "Bear", animal }
    };
    await Shell.Current.GoToAsync($"beardetails", navigationParameter);
}

Bu örnek, içinde seçili durumdaki ayıyı CollectionViewolarak Animalalır. Animal nesnesi anahtarıyla Bearöğesine Dictionary eklenir. Ardından, gezinti beardetails parametresi olarak geçirilmekte olan rotaya Dictionary gezinti gerçekleştirilir.

Bağımsız değişken olarak IDictionary<string, object> geçirilen veriler, sayfanın ömrü boyunca bellekte tutulur ve sayfa gezinti yığınından kaldırılana kadar yayımlanmaz. Bu, aşağıdaki senaryoda gösterildiği gibi sorunlu olabilir:

Page1Page2 yöntemini kullanarak GoToAsync öğesine gider ve adlı MyDatabir nesneyi geçirir. Page2 ardından sorgu parametresi olarak alır MyData .
Page2Page3 herhangi bir veri geçirmeden yöntemini kullanmaya GoToAsync gider.
Page3 yöntemiyle GoToAsync geriye doğru gider. Page2 ardından sorgu parametresi olarak yeniden alır MyData .

Bu, birçok senaryoda istenen bir durum olsa da, istenmiyorsa, bir sayfa tarafından ilk kez alındıktan sonra yöntemiyle Clear bağımsız değişkeni temizlemeniz IDictionary<string, object> gerekir.

Tek kullanımlık nesne tabanlı gezinti verileri, bağımsız değişken belirten ShellNavigationQueryParameters bir GoToAsync aşırı yüklemeyle geçirilebilir. Nesne ShellNavigationQueryParameters , gezinti gerçekleştikten sonra temizlenen tek kullanımlık gezinti verilerine yöneliktir. Aşağıdaki örnek, tek kullanımlık verileri geçirirken gezinmeyi gösterir:

async void OnCollectionViewSelectionChanged(object sender, SelectionChangedEventArgs e)
{
    Animal animal = e.CurrentSelection.FirstOrDefault() as Animal;
    var navigationParameter = new ShellNavigationQueryParameters
    {
        { "Bear", animal }
    };
    await Shell.Current.GoToAsync($"beardetails", navigationParameter);
}

Bu örnek, nesneye eklenen bir Animal olarak içinde CollectionViewseçili durumdaki ayıyı ShellNavigationQueryParameters alır. Ardından, nesne bir gezinti beardetails parametresi olarak geçirilirken, rotaya ShellNavigationQueryParameters gezinti gerçekleştirilir. Gezinti gerçekleştikten sonra nesnedeki ShellNavigationQueryParameters veriler temizlenir.

Gezinti verilerini almaya yönelik iki yaklaşım vardır:

Gidilmekte olan sayfayı veya sayfanın BindingContextsınıfını temsil eden sınıf, her sorgu parametresi için bir QueryPropertyAttribute ile donatılabilir. Daha fazla bilgi için bkz . Sorgu özelliği özniteliklerini kullanarak gezinti verilerini işleme.
Gidilmekte olan sayfayı temsil eden sınıf veya sayfanın BindingContextsınıfı arabirimini IQueryAttributable uygulayabilir. Daha fazla bilgi için bkz . Gezinti verilerini tek bir yöntem kullanarak işleme.

Gezinti verileri, her dize tabanlı sorgu parametresi ve nesne tabanlı gezinti parametresi için alıcı sınıfı ile QueryPropertyAttribute süslenerek alınabiliyor:

Gezinti verileri, alıcı sınıfı her dize tabanlı sorgu parametresi, nesne tabanlı gezinti parametresi veya ShellNavigationQueryParameters nesne için bir QueryPropertyAttribute ile süslenerek alınabilir:

[QueryProperty(nameof(Bear), "Bear")]
public partial class BearDetailPage : ContentPage
{
    Animal bear;
    public Animal Bear
    {
        get => bear;
        set
        {
            bear = value;
            OnPropertyChanged();
        }
    }

    public BearDetailPage()
    {
        InitializeComponent();
        BindingContext = this;
    }
}

Bu örnekte için ilk bağımsız değişken QueryPropertyAttribute , verileri alacak özelliğin adını belirtir ve ikinci bağımsız değişken parametre kimliğini belirtir. Bu nedenle, QueryPropertyAttribute yukarıdaki örnekte özelliğin Bear yöntem çağrısındaki gezinti parametresinde BearGoToAsync geçirilen verileri alacağını belirtir.

Dekont

aracılığıyla QueryPropertyAttribute alınan dize tabanlı sorgu parametresi değerleri otomatik olarak URL kodunun çözülmesini sağlar.

Gezinti verileri, alma sınıfında arabirimi uygulanarak IQueryAttributable alınabiliyor. arabirimi, IQueryAttributable uygulayan sınıfın yöntemini uygulaması ApplyQueryAttributes gerektiğini belirtir. Bu yöntemin, gezinti sırasında geçirilen verileri içeren türünde IDictionary<string, object>bir query bağımsız değişkeni vardır. Sözlükteki her anahtar, verileri temsil eden nesneye karşılık gelen değeriyle bir sorgu parametresi kimliğidir. Bu yaklaşımı kullanmanın avantajı, gezinti verilerinin tek bir yöntem kullanılarak işlenebileceğidir. Bu yöntem, bir bütün olarak işlenmesi gereken birden çok gezinti verisi öğeniz olduğunda yararlı olabilir.

Aşağıdaki örnekte arabirimini uygulayan bir görünüm modeli sınıfı gösterilmektedir IQueryAttributable :

public class MonkeyDetailViewModel : IQueryAttributable, INotifyPropertyChanged
{
    public Animal Monkey { get; private set; }

    public void ApplyQueryAttributes(IDictionary<string, object> query)
    {
        Monkey = query["Monkey"] as Animal;
        OnPropertyChanged("Monkey");
    }
    ...
}

Bu örnekte yöntemi, ApplyQueryAttributes yöntem çağrısına Monkey bağımsız değişken olarak geçirilen sözlükteki query anahtara GoToAsync karşılık gelen nesneyi alır.

Önemli

Arabirim aracılığıyla IQueryAttributable alınan dize tabanlı sorgu parametresi değerleri otomatik olarak URL kodu çözülemez.

Birden çok veri öğesini geçirme ve işleme

ile bağlanarak &birden çok dize tabanlı sorgu parametresi geçirilebilir. Örneğin, aşağıdaki kod iki veri öğesi geçirir:

async void OnCollectionViewSelectionChanged(object sender, SelectionChangedEventArgs e)
{
    string elephantName = (e.CurrentSelection.FirstOrDefault() as Animal).Name;
    string elephantLocation = (e.CurrentSelection.FirstOrDefault() as Animal).Location;
    await Shell.Current.GoToAsync($"elephantdetails?name={elephantName}&location={elephantLocation}");
}

Bu kod örneği, içinde seçili durumdaki CollectionViewfili alır ve sorgu parametreleri olarak geçirerek elephantNameelephantLocation rotaya elephantdetails gider.

Birden çok veri öğesi almak için, gidilmekte olan sayfayı temsil eden sınıf veya sayfanın BindingContextsınıfı, dize tabanlı her sorgu parametresi için bir QueryPropertyAttribute ile donatılabilir:

[QueryProperty(nameof(Name), "name")]
[QueryProperty(nameof(Location), "location")]
public partial class ElephantDetailPage : ContentPage
{
    public string Name
    {
        set
        {
            // Custom logic
        }
    }

    public string Location
    {
        set
        {
            // Custom logic
        }
    }
    ...    
}

Bu örnekte, sınıfı her sorgu parametresi için bir QueryPropertyAttribute ile dekore edilmiştir. birincisi QueryPropertyAttribute , özelliğin Name sorgu parametresinde name geçirilen verileri alacağını belirtirken, ikincisi QueryPropertyAttribute özelliğin Location sorgu parametresinde location geçirilen verileri alacağını belirtir. Her iki durumda da sorgu parametresi değerleri yöntem çağrısındaki URI'de GoToAsync belirtilir.

Alternatif olarak gezinti verileri, gezinilen sayfayı IQueryAttributable temsil eden sınıfta veya sayfanın sınıfı için BindingContextarabirimi uygulanarak tek bir yöntemle işlenebilir:

public class ElephantDetailViewModel : IQueryAttributable, INotifyPropertyChanged
{
    public Animal Elephant { get; private set; }

    public void ApplyQueryAttributes(IDictionary<string, object> query)
    {
        string name = HttpUtility.UrlDecode(query["name"].ToString());
        string location = HttpUtility.UrlDecode(query["location"].ToString());
        ...        
    }
    ...
}

Bu örnekte yöntemi, ApplyQueryAttributes yöntem çağrısındaki name URI'den ve location sorgu parametrelerinin GoToAsync değerini alır.

Dekont

Yol tabanlı gezinti gerçekleştirilirken dize tabanlı sorgu parametreleri ve nesne tabanlı gezinti parametreleri aynı anda geçirilebilir.

Geri düğmesi davranışı

Geri düğmesi görünümü ve davranışı, eklenen özellik bir BackButtonBehavior nesneye BackButtonBehavior ayarlanarak yeniden tanımlanabilir. BackButtonBehavior sınıfı aşağıdaki özellikleri tanımlar:

Command, türündedir ICommandve geri düğmesine basıldığında yürütülür.
CommandParameter, türündeki objectparametresine Commandgeçirilir.
IconOverride, türünde ImageSource, geri düğmesi için kullanılan simge.
IsEnabled, türündeki boolean, geri düğmesinin etkinleştirilip etkinleştirilmediğini gösterir. Varsayılan değer: true.
IsVisible, türündeki boolean, geri düğmesinin görünür olup olmadığını gösterir. Varsayılan değer: true.
TextOverride, türündeki string, geri düğmesi için kullanılan metindir.

Bu özelliklerin tümü nesneler tarafından BindableProperty desteklenir, bu da özelliklerin veri bağlamalarının hedefleri olabileceği anlamına gelir.

Aşağıdaki kodda geri düğmesi görünümünü ve davranışını yeniden tanımlama örneği gösterilmektedir:

<ContentPage ...>    
    <Shell.BackButtonBehavior>
        <BackButtonBehavior Command="{Binding BackCommand}"
                            IconOverride="back.png" />   
    </Shell.BackButtonBehavior>
    ...
</ContentPage>

Command özelliği, geri düğmesine basıldığında yürütülecek şekilde ICommand ayarlanır ve IconOverride özellik de geri düğmesi için kullanılan simgeye ayarlanır:

Rotalar

Yolları kaydetme

Ayrıntı sayfası yollarını kaydetme

Gezinti gerçekleştirme

Mutlak yollar

Göreli yollar

Bağlamsal gezinti

Geriye doğru gezinti

Geçersiz yollar

Hata ayıklama gezintisi

Gezinti yığını

Gezinti olayları

Gezinti erteleme

Verileri geçirme

Birden çok kullanım nesne tabanlı gezinti verisi geçirme

Tek kullanımlık nesne tabanlı gezinti verilerini geçirme

Gezinti verilerini alma

Sorgu özelliği özniteliklerini kullanarak gezinti verilerini işleme

Tek bir yöntem kullanarak gezinti verilerini işleme

Birden çok veri öğesini geçirme ve işleme

Geri düğmesi davranışı

Geri Bildirim

Ek kaynaklar