Page.TopAppBar Property

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Gets or sets the AppBar displayed in a dedicated area at the top of the page.

AppBar TopAppBar();

void TopAppBar(AppBar value);

public AppBar TopAppBar { get; set; }

var appBar = page.topAppBar;
page.topAppBar = appBar;

Public Property TopAppBar As AppBar

<Page ...>
  <Page.TopAppBar>
    <AppBar .../>
  </Page.TopAppBar>
</Page>

Property Value

AppBar

A reference to an AppBar displayed at the top of the page, if any; otherwise, null.

Remarks

Note

For apps in Windows 10 or later, placing commands in the TopAppBar and BottomAppBar is not recommended.

• For the latest guidance regarding general app commands, see Command bar.
• For the latest guidance regarding navigation commands, see Navigation design basics for Windows apps.

In XAML, make sure you specify the Page.TopAppBar property element in the same area as other property elements that may already be defined, like Page.BottomAppBar or Page.Resources. The XAML language enforces that you can't mix the property elements between the XAML content that is setting Content, such as the typical root Grid element. For more info on XAML syntax, see XAML syntax guide.

See also

• Command bar
• Navigation design basics for Windows apps