Navigazione della Shell MAUI di .NET

Sfoglia l'esempio

.NET Multipiattaforma App UI (.NET MAUI) Shell include un'esperienza di spostamento basata su URI che usa le route per passare a qualsiasi pagina nell'app, senza dover seguire una gerarchia di navigazione impostata. Inoltre, offre anche la possibilità di spostarsi all'indietro senza dover visitare tutte le pagine nello stack di navigazione.

La Shell classe definisce le proprietà correlate allo spostamento seguenti:

• BackButtonBehavior, di tipo BackButtonBehavior, una proprietà associata che definisce il comportamento del pulsante Indietro.
• CurrentItem, di tipo ShellItem, l'elemento attualmente selezionato.
• CurrentPage, di tipo Page, la pagina attualmente presentata.
• CurrentState, di tipo ShellNavigationState, lo stato di navigazione corrente dell'oggetto Shell.
• Current, di tipo Shell, che fornisce accesso alla shell corrente.

Le BackButtonBehaviorproprietà , CurrentIteme CurrentState sono supportate da BindableProperty oggetti , il che significa che queste proprietà possono essere destinazioni di data binding.

Lo spostamento viene eseguito richiamando il GoToAsync metodo dalla Shell classe . Quando la navigazione sta per essere eseguita, viene generato l'evento Navigating, e l'evento Navigated viene generato al termine della navigazione.

Percorsi

Lo spostamento viene eseguito in un'app Shell specificando un URI a cui passare. Gli URI di spostamento possono avere tre componenti:

• Route, che definisce il percorso verso il contenuto che fa parte della gerarchia visiva della Shell.
• Una pagina. Le pagine che non esistono nella gerarchia visiva della Shell possono essere inserite nello stack di navigazione da qualsiasi punto nel contesto di un'app Shell. Ad esempio, una pagina dei dettagli non verrà definita nella gerarchia visiva della shell, ma può essere inserita nello stack di navigazione in base alle esigenze.
• Uno o più parametri di query. I parametri di query sono parametri che possono essere passati alla pagina di destinazione durante lo spostamento.

Quando un URI di spostamento include tutti e tre i componenti, la struttura è: //route/page?queryParameters

Registrare le route

Le rotte possono essere definite su oggetti FlyoutItem, TabBar, Tab e ShellContent tramite le relative proprietà Route.

<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>

L'esempio precedente crea la seguente gerarchia di percorsi, che può essere usata nella navigazione programmata.

animals
  domestic
    cats
    dogs
  monkeys
  elephants
  bears
about

Per navigare all'oggetto per la route ShellContent, l'URI di route assoluto per dogs è //animals/domestic/dogs. Analogamente, per navigare all'oggetto ShellContent relativo al percorso about, l'URI assoluto del percorso è //about.

Registrare le rotte della pagina dettagli

Shell Nel costruttore della sottoclasse o in qualsiasi altra posizione eseguita prima che venga richiamata una route, è possibile registrare esplicitamente route aggiuntive per le pagine di dettaglio che non sono rappresentate nella gerarchia visiva dello Shell. Questa operazione viene eseguita con il Routing.RegisterRoute metodo :

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));

In questo esempio vengono registrate le pagine di dettaglio, non definite nella Shell sottoclasse, come route. È quindi possibile passare a queste pagine di dettaglio usando lo spostamento basato su URI, da qualsiasi posizione all'interno dell'app. Le route per tali pagine sono note come route globali.

In alternativa, le pagine possono essere registrate in gerarchie di route diverse, se necessario:

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));

In questo esempio viene abilitata la navigazione contestuale delle pagine, dove navigando alla route details dalla pagina per la route monkeys viene visualizzato il MonkeyDetailPage. Analogamente, passando al percorso details dalla pagina per il percorso elephants viene visualizzato il ElephantDetailPage. Per altre informazioni, vedere Navigazione contestuale.

Routing.RegisterRoute("trip/{tripId}", typeof(TripDetailPage));

Routing.RegisterRoute("trip/{tripId}", typeof(RequiredResultPage));
Routing.RegisterRoute("traveler/{name?}", typeof(TravelerResultPage));
Routing.RegisterRoute("rating/{stars=5}", typeof(DefaultValueResultPage));
Routing.RegisterRoute("reservation/{reservationId:int}", typeof(IntConstraintResultPage));
Routing.RegisterRoute("booking/{reference:guid}", typeof(GuidConstraintResultPage));
Routing.RegisterRoute("files/{*path}", typeof(CatchAllResultPage));
Routing.RegisterRoute("trip-{tripId}-summary", typeof(MixedResultPage));

await Shell.Current.GoToAsync("//routes/trip/SEA-204");

[QueryProperty(nameof(TripId), "tripId")]
public partial class TripDetailPage : ContentPage
{
    string tripId;

    public string TripId
    {
        get => tripId;
        set
        {
            tripId = value;
            OnPropertyChanged();
        }
    }

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

public class TripDetailViewModel : IQueryAttributable
{
    public string TripId { get; private set; }

    public void ApplyQueryAttributes(IDictionary<string, object> query)
    {
        if (query.TryGetValue("tripId", out object tripId))
            TripId = tripId.ToString();
    }
}

Eseguire la navigazione

Per eseguire la navigazione, è necessario prima ottenere un riferimento alla Shell sottoclasse. Questo riferimento può essere ottenuto tramite la Shell.Current proprietà . La navigazione può quindi essere eseguita chiamando il GoToAsync metodo sull'oggetto Shell . Questo metodo naviga verso ShellNavigationState e restituisce Task che verrà completato quando l'animazione di navigazione sarà completata. L'oggetto ShellNavigationState viene costruito dal metodo GoToAsync, da un string o un Uri, e la proprietà Location è impostata sul valore dell'argomento string o Uri.

// Correct: always await GoToAsync
await Shell.Current.GoToAsync($"details?id={item.Id}");

// Incorrect: fire-and-forget causes a race condition
Shell.Current.GoToAsync($"details?id={item.Id}");

Lo stato di navigazione corrente dell'oggetto Shell può essere recuperato tramite la Shell.Current.CurrentState proprietà , che include l'URI della route visualizzata nella Location proprietà .

Percorsi assoluti

La navigazione può essere eseguita specificando un URI assoluto valido come argomento per il GoToAsync metodo :

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

In questo esempio si accede alla pagina per la monkeys route, con la route definita su un ShellContent oggetto. L'oggetto ShellContent che rappresenta la monkeys route è figlio di un FlyoutItem oggetto , la cui route è animals.

Route relative

È anche possibile eseguire lo spostamento specificando un URI relativo valido come argomento per il GoToAsync metodo . Il sistema di routing tenterà di associare l'URI a un ShellContent oggetto . Pertanto, se tutte le route in un'app sono univoche, la navigazione può essere eseguita specificando solo il nome di route univoco come URI relativo.

Nell'esempio seguente viene visualizzata la pagina per la monkeydetails route:

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

In questo esempio viene eseguita la ricerca della route monkeyDetails fino a quando non viene trovata la pagina corrispondente. Quando la pagina viene trovata, viene aggiunta allo stack di navigazione.

Navigazione contestuale

Le route relative abilitano la navigazione contestuale. Si consideri ad esempio la gerarchia di route seguente:

monkeys
  details
bears
  details

Quando viene visualizzata la pagina registrata per la monkeys route, passando alla details route verrà visualizzata la pagina registrata per la monkeys/details route. Analogamente, quando viene visualizzata la pagina registrata per la bears route, passando alla details route verrà visualizzata la pagina registrata per la bears/details route. Per informazioni su come registrare le route in questo esempio, vedere Registrare le route delle pagine.

Spostamento indietro

È possibile eseguire lo spostamento indietro specificando ".." come argomento per il GoToAsync metodo :

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

La navigazione all'indietro con ".." può anche essere combinata con un itinerario:

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

In questo esempio viene eseguita la navigazione all'indietro e quindi si passa alla route specificata.

Analogamente, è possibile spostarsi più volte all'indietro e quindi passare a una route specificata:

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

In questo esempio la navigazione all'indietro viene eseguita due volte e quindi si passa alla route specificata.

Inoltre, i dati possono essere passati tramite proprietà di query durante la navigazione all'indietro.

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

In questo esempio viene eseguita la navigazione all'indietro e il valore del parametro di query viene passato al parametro di query nella pagina precedente.

Per maggiori informazioni sul passaggio dei dati durante la navigazione, vedere Passare i dati.

Route non valide

I formati di route seguenti non sono validi:

L'uso di questi formati di route comporta la visualizzazione di un'eccezione Exception .

Navigazione di debug

Alcune classi shell sono decorate con , DebuggerDisplayAttributeche specifica la modalità di visualizzazione di una classe o di un campo dal debugger. Ciò consente di eseguire il debug delle richieste di spostamento visualizzando i dati correlati alla richiesta di navigazione. Ad esempio, lo screenshot seguente mostra le CurrentItem proprietà e CurrentState dell'oggetto Shell.Current :

In questo esempio, la CurrentItem proprietà di tipo FlyoutItem, visualizza il titolo e la route dell'oggetto FlyoutItem . Analogamente, la CurrentState proprietà di tipo ShellNavigationState, visualizza l'URI della route visualizzata all'interno dell'app Shell.

Stack di navigazione

La classe Tab definisce una proprietà Stack di tipo IReadOnlyList<Page>, che rappresenta lo stack di navigazione corrente all'interno di Tab. La classe fornisce anche i seguenti metodi di navigazione sovrascrivibili:

• GetNavigationStack, restituisce IReadOnlyList<Page>, lo stack di navigazione corrente.
• OnInsertPageBefore, viene chiamato quando INavigation.InsertPageBefore viene chiamato .
• OnPopAsync, restituisce Task<Page>e viene chiamato quando INavigation.PopAsync viene chiamato .
• OnPopToRootAsync, restituisce Taske viene chiamato quando INavigation.OnPopToRootAsync viene chiamato .
• OnPushAsync, restituisce Taske viene chiamato quando INavigation.PushAsync viene chiamato .
• OnRemovePage, viene chiamato quando INavigation.RemovePage viene chiamato .

Nell'esempio seguente viene illustrato come eseguire l'override del OnRemovePage metodo :

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

        // Custom logic
    }
}

In questo esempio, gli oggetti MyTab devono essere utilizzati nella gerarchia visiva della Shell anziché gli oggetti Tab.

Eventi di navigazione

La Shell classe definisce l'evento Navigating, che viene generato quando la navigazione sta per essere eseguita, sia a causa di una navigazione programmatica che dell'interazione dell'utente. L'oggetto ShellNavigatingEventArgs che accompagna l'evento Navigating fornisce le proprietà seguenti:

Inoltre, la ShellNavigatingEventArgs classe fornisce un Cancel metodo che può essere usato per annullare la navigazione e un GetDeferral metodo che restituisce un ShellNavigatingDeferral token che può essere usato per completare la navigazione. Per altre informazioni sul rinvio dello spostamento, vedere Rinvio della navigazione.

La Shell classe definisce anche l'evento Navigated , che viene generato al termine della navigazione. L'oggetto ShellNavigatedEventArgs che accompagna l'evento Navigated fornisce le proprietà seguenti:

Le classi ShellNavigatedEventArgs e ShellNavigatingEventArgs hanno entrambe proprietà Source, di tipo ShellNavigationSource. Questa enumerazione fornisce i valori seguenti:

• Unknown
• Push
• Pop
• PopToRoot
• Insert
• Remove
• ShellItemChanged
• ShellSectionChanged
• ShellContentChanged

Pertanto, la navigazione può essere intercettata tramite un OnNavigating override, e azioni possono essere eseguite in base alla fonte di navigazione. Ad esempio, il codice seguente mostra come annullare lo spostamento indietro se i dati nella pagina non sono salvati:

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

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

Rinvio della navigazione

La navigazione della shell può essere intercettata e completata o annullata in base alla scelta dell'utente. A tale scopo, è possibile eseguire l'override del OnNavigating metodo nella Shell sottoclasse e chiamando il GetDeferral metodo sull'oggetto ShellNavigatingEventArgs . Questo metodo restituisce un ShellNavigatingDeferral token con un Complete metodo, che può essere usato per completare la richiesta di navigazione:

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();
    }    
}

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

        ShellNavigatingDeferral token = args.GetDeferral();

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

In questo esempio viene visualizzata una finestra delle azioni che invita l'utente a completare la richiesta di navigazione o annullarla. La navigazione viene annullata richiamando il Cancel metodo sull'oggetto ShellNavigatingEventArgs . La navigazione viene completata richiamando il metodo Complete sul token ShellNavigatingDeferral che è stato recuperato dal metodo GetDeferral sull'oggetto ShellNavigatingEventArgs.

Trasmettere i dati

I dati primitivi possono essere passati come parametri di query basati su stringa durante la navigazione programmabile basata su URI. Questa operazione viene ottenuta aggiungendo ? dopo una route, seguita da un ID parametro di query, =e un valore:

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

In questo esempio viene recuperato l'elefante attualmente selezionato in CollectionView, e si passa al percorso elephantdetails, passando elephantName come parametro di query.

Trasmettere dati di navigazione a uso multiplo basati su oggetti

È possibile passare più dati di navigazione basati su oggetti con un GoToAsync overload che specifica un IDictionary<string, object> argomento:

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

In questo esempio viene recuperato l'orso attualmente selezionato in CollectionView, come Animal. L'oggetto Animal viene aggiunto a un Dictionary oggetto con la chiave Bear. Viene quindi eseguita la navigazione sulla beardetails route, con l'oggetto Dictionary passato come parametro di navigazione.

Tutti i dati passati come IDictionary<string, object> argomento vengono conservati in memoria per la durata della pagina e non vengono rilasciati finché la pagina non viene rimossa dallo stack di navigazione. Questo può essere problematico, come illustrato nello scenario seguente:

1. Page1 passa a Page2 usando il GoToAsync metodo , passando un oggetto denominato MyData. Page2 riceve MyData quindi come parametro di query.
2. Page2 naviga verso Page3 utilizzando il metodo GoToAsync, senza trasmettere alcun dato.
3. Page3 si sposta all'indietro con il GoToAsync metodo . Page2 quindi riceve MyData nuovamente come parametro di query.

Anche se questo è auspicabile in molti scenari, se non lo è, si dovrebbe cancellare l'argomento IDictionary<string, object> mediante il metodo Clear dopo che è stato ricevuto per la prima volta da una pagina.

Trasmettere i dati di navigazione basati su oggetti monouso

I dati di spostamento monouso basati su oggetti possono essere passati con un GoToAsync overload che specifica un ShellNavigationQueryParameters argomento. Un ShellNavigationQueryParameters oggetto è destinato a dati di navigazione ad uso singolo che vengono cancellati dopo che la navigazione è avvenuta. L'esempio seguente illustra la navigazione durante il passaggio di dati a uso singolo.

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

In questo esempio viene recuperato l'orso attualmente selezionato in CollectionView, come oggetto Animal aggiunto all'oggetto ShellNavigationQueryParameters . Viene quindi eseguita la navigazione sulla beardetails route, con l'oggetto ShellNavigationQueryParameters passato come parametro di navigazione. Dopo che la navigazione è stata eseguita, i dati nell'oggetto ShellNavigationQueryParameters sono stati cancellati.

Ricevere i dati di navigazione

Esistono due approcci per ricevere i dati di navigazione:

1. La classe che rappresenta la pagina navigata a, o la classe della pagina, può BindingContext essere decorata con un QueryPropertyAttribute per ogni parametro di query. Per altre informazioni, vedere Elaborare i dati di navigazione usando gli attributi delle proprietà di query.
2. La classe che rappresenta la pagina a cui si naviga, o la classe per la pagina, può implementare BindingContext l'interfaccia IQueryAttributable. Per altre informazioni, vedere Elaborare i dati di navigazione usando un singolo metodo.

Elaborare i dati di navigazione usando gli attributi delle proprietà di query

I dati di navigazione possono essere ricevuti decorando la classe ricevente con un QueryPropertyAttribute per ciascun parametro di query basato su stringa, parametro di navigazione basato su oggetti o ShellNavigationQueryParameters oggetto:

[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;
    }
}

In questo esempio il primo argomento per l'oggetto QueryPropertyAttribute specifica il nome della proprietà che riceverà i dati, con il secondo argomento che specifica l'ID parametro. Pertanto, QueryPropertyAttribute nell'esempio precedente viene specificato che la Bear proprietà riceverà i dati passati nel Bear parametro di navigazione nella chiamata al GoToAsync metodo.

Elaborare i dati di navigazione usando un singolo metodo

I dati di navigazione possono essere ricevuti implementando l'interfaccia IQueryAttributable nella classe ricevente. L'interfaccia IQueryAttributable specifica che la classe di implementazione deve implementare il ApplyQueryAttributes metodo . Questo metodo ha un query argomento di tipo IDictionary<string, object>, che contiene tutti i dati passati durante la navigazione. Ogni chiave nel dizionario è un ID parametro di query, con il relativo valore corrispondente all'oggetto che rappresenta i dati. Il vantaggio di usare questo approccio è che i dati di navigazione possono essere elaborati usando un unico metodo, che può essere utile quando si dispone di più elementi di dati di navigazione che richiedono l'elaborazione nel suo complesso.

L'esempio seguente mostra una classe del modello di visualizzazione che implementa l'interfaccia 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");
    }
    ...
}

In questo esempio, il ApplyQueryAttributes metodo recupera l'oggetto che corrisponde alla Monkey chiave nel query dizionario, che è stato passato come argomento alla chiamata al GoToAsync metodo.

Passare ed elaborare più elementi di dati

È possibile passare più parametri di query basati su stringhe collegandoli con &. Ad esempio, il codice seguente passa due elementi di dati:

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}");
}

Questo esempio di codice recupera l'elefante attualmente selezionato in CollectionView, e naviga verso la route elephantdetails, passando elephantName e elephantLocation come parametri di query.

Per ricevere più elementi di dati, la classe che rappresenta la pagina a cui si viene reindirizzati oppure la classe della pagina stessa può essere decorata con un BindingContext per ogni parametro di query basato su stringa:

[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
        }
    }
    ...    
}

In questo esempio, la classe è decorata con un QueryPropertyAttribute per ogni parametro di query. Il primo QueryPropertyAttribute specifica che la Name proprietà riceverà i dati passati nel name parametro di query, mentre il secondo QueryPropertyAttribute specifica che la Location proprietà riceverà i dati passati nel location parametro di query. In entrambi i casi, i valori dei parametri di query vengono specificati nell'URI nella chiamata al GoToAsync metodo.

In alternativa, i dati di navigazione possono essere elaborati da un metodo unico implementando l'interfaccia IQueryAttributable nella classe che rappresenta la pagina a cui si passa o la classe per la BindingContext.

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());
        ...        
    }
    ...
}

In questo esempio, il metodo ApplyQueryAttributes recupera il valore dei parametri di query name e location dall'URI nella chiamata al metodo GoToAsync.

Comportamento del pulsante Indietro

È possibile ridefinire l'aspetto e il comportamento del pulsante Indietro impostando la BackButtonBehavior proprietà associata su un BackButtonBehavior oggetto . La classe BackButtonBehavior definisce le proprietà seguenti:

• Command, di tipo ICommand, che viene eseguito quando viene premuto il pulsante indietro.
• CommandParameter, di tipo object, che è il parametro passato a Command.
• IconOverride, di tipo ImageSource, l'icona usata per il pulsante Indietro.
• IsEnabled, di tipo boolean, indica se il pulsante Indietro è abilitato. Il valore predefinito è true.
• IsVisible, di tipo boolean, indica se il pulsante Indietro è visibile. Il valore predefinito è true.
• TextOverride, di tipo string, il testo usato per il pulsante Indietro.

<ContentPage ...>
    <Shell.BackButtonBehavior>
        <BackButtonBehavior Command="{Binding BackCommand}"
                            IconOverride="back.png"
                            AccessibilityLabel="Back to order list" />
    </Shell.BackButtonBehavior>
    ...
</ContentPage>

Il codice seguente mostra un esempio di ridefinizione dell'aspetto e del comportamento del pulsante Indietro:

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

La Command proprietà è impostata su un ICommand oggetto da eseguire quando viene premuto il pulsante Indietro e la IconOverride proprietà è impostata sull'icona usata per il pulsante Indietro:

Screenshot di sostituzione dell'icona del pulsante Indietro della Shell.