Frame.Navigate Método

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Sobrecargas

Navigate(TypeName)	Faz com que o de Quadro carregue o conteúdo representado pelode Página especificado.
Navigate(TypeName, Object)	Faz com que o Frame carregue o conteúdo representado pelode Página especificado, passando também um parâmetro para ser interpretado pelo destino da navegação.
Navigate(TypeName, Object, NavigationTransitionInfo)	Faz com que o Frame carregue o conteúdo representado pelo tipo de dados derivado dede página especificado, passando também um parâmetro para ser interpretado pelo destino da navegação e um valor que indica a transição animada a ser usada.

Navigate(TypeName)

Faz com que o de Quadro carregue o conteúdo representado pelode Página especificado.

C#

public bool Navigate(System.Type sourcePageType);

Parâmetros

sourcePageType

Type

A página para a qual navegar, especificada como uma referência de tipo para seu tipo de classe parcial. (Uma referência de tipo é fornecida como System.Type para Microsoft .NET ou um TypeName struct auxiliar para C++).

Retornos

Boolean

se um manipulador de eventos NavigationFailed tiver definido Manipulado como ; caso contrário, . Consulte Comentários para obter mais informações.

Implementações

M:Microsoft.UI.Xaml.Controls.INavigate.Navigate(System.Type)

Navigate(TypeName, Object)

Faz com que o Frame carregue o conteúdo representado pelode Página especificado, passando também um parâmetro para ser interpretado pelo destino da navegação.

C#

[Windows.Foundation.Metadata.Overload("Navigate")]
public bool Navigate(System.Type sourcePageType, object parameter);

Parâmetros

sourcePageType

Type

A página para a qual navegar, especificada como uma referência de tipo para seu tipo de classe parcial. (Uma referência de tipo é fornecida como System.Type para Microsoft .NET ou um TypeName struct auxiliar para C++).

parameter

Object

O parâmetro de navegação a ser passado para a página de destino.

Retornos

Boolean

se um manipulador de eventos NavigationFailed tiver definido Manipulado como ; caso contrário, . Consulte Comentários para obter mais informações.

Atributos

OverloadAttribute

Navigate(TypeName, Object, NavigationTransitionInfo)

Faz com que o Frame carregue o conteúdo representado pelo tipo de dados derivado dede página especificado, passando também um parâmetro para ser interpretado pelo destino da navegação e um valor que indica a transição animada a ser usada.

C#

[Windows.Foundation.Metadata.Overload("NavigateWithTransitionInfo")]
public bool Navigate(System.Type sourcePageType, object parameter, NavigationTransitionInfo infoOverride);

Parâmetros

sourcePageType

Type

A página para a qual navegar, especificada como uma referência de tipo para seu tipo de classe parcial. (Uma referência de tipo é fornecida como System.Type para Microsoft .NET ou um TypeName struct auxiliar para C++).

parameter

Object

O parâmetro de navegação a ser passado para a página de destino; deve ter um tipo básico (cadeia de caracteres, caractere, numérico ou GUID) para dar suporte à serialização de parâmetros usando GetNavigationState.

infoOverride

NavigationTransitionInfo

Informações sobre a transição animada.

Retornos

Boolean

se um manipulador de eventos NavigationFailed tiver definido Manipulado como ; caso contrário, . Consulte Comentários para obter mais informações.

Atributos

OverloadAttribute

Exemplos

XAML

<Frame x:Name="myFrame">
    <Frame.ContentTransitions>
        <TransitionCollection>
            <NavigationThemeTransition />
        </TransitionCollection>
    </Frame.ContentTransitions>
</Frame>

C#

// Play the default animation
myFrame.Navigate(typeof(Page2), null);

// Explicitly play the page refresh animation
myFrame.Navigate(typeof(Page2), null, new EntranceNavigationTransitionInfo());

// Play the drill in animation
myFrame.Navigate(typeof(Page2), null, new DrillInNavigationTransitionInfo());

// Suppress the default animation
myFrame.Navigate(typeof(Page2), null, new SuppressNavigationTransitionInfo());

Comentários

Você manipula o evento NavigationFailed para responder à falha de navegação. Você pode lidar com a falha diretamente no manipulador de eventos ou pode definir a propriedade NavigationFailedEventArgs.Handled para true e usar o o método Navigate retornar valor para responder à falha.

Valores de parâmetro

Você pode usar GetNavigationState para serializar o estado do quadro e SetNavigationState para restaurá-lo mais tarde. Para habilitar a serialização de estado de quadro usando esses métodos, você deve usar apenas tipos básicos para os tipos de de navegação, como cadeia de caracteres, caracteres, numéricos e tipos de GUID . Caso contrário, GetNavigationState lançará uma exceção.

O valor parameter pode ter um tipo complexo se você não usar GetNavigationState. No entanto, você ainda deve usar apenas tipos básicos para evitar o excesso de uso de memória causado pela pilha de navegação do quadro que contém uma referência ao parameter. Uma abordagem preferencial é não passar o objeto real, mas passar um identificador que você pode usar para pesquisar o objeto na página de aterrissagem de destino. Por exemplo, em vez de passar um objeto Customer, passe uma referência para o CustomerIDe procure o Customer após a conclusão da navegação.

Dica

Se você estiver programando usando uma linguagem Microsoft .NET (C# ou Microsoft Visual Basic), o TypeName digite projetos como System.Type. Ao programar usando C#, é comum usar o operador typeof para obter referências ao System.Type de um tipo. No Microsoft Visual Basic, use GetType. Se você estiver usando C++/WinRT, poderá usar a função auxiliar winrt::xaml_typename<T>() para criar um objeto TypeName. Consulte modelo de função winrt::xaml_typename para obter mais detalhes e um exemplo de código.

Confira também

• Page
• NavigationFailed
• noções básicas de design de navegação