Frame.Navigate Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
Navigate(TypeName) |
Faz com que o de Quadro |
Navigate(TypeName, Object) |
Faz com que o |
Navigate(TypeName, Object, NavigationTransitionInfo) |
Faz com que o |
Navigate(TypeName)
Faz com que o de Quadro
public:
virtual bool Navigate(TypeName sourcePageType) = Navigate;
bool Navigate(TypeName const& sourcePageType);
public bool Navigate(System.Type sourcePageType);
function navigate(sourcePageType)
Public Function Navigate (sourcePageType As Type) As Boolean
Parâmetros
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
bool
Implementações
Aplica-se a
Navigate(TypeName, Object)
Faz com que o
public:
virtual bool Navigate(TypeName sourcePageType, Platform::Object ^ parameter) = Navigate;
/// [Windows.Foundation.Metadata.Overload("Navigate")]
bool Navigate(TypeName const& sourcePageType, IInspectable const& parameter);
[Windows.Foundation.Metadata.Overload("Navigate")]
public bool Navigate(System.Type sourcePageType, object parameter);
function navigate(sourcePageType, parameter)
Public Function Navigate (sourcePageType As Type, parameter As Object) As Boolean
Parâmetros
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
Platform::Object
IInspectable
O parâmetro de navegação a ser passado para a página de destino.
Retornos
bool
- Atributos
Aplica-se a
Navigate(TypeName, Object, NavigationTransitionInfo)
Faz com que o
public:
virtual bool Navigate(TypeName sourcePageType, Platform::Object ^ parameter, NavigationTransitionInfo ^ infoOverride) = Navigate;
/// [Windows.Foundation.Metadata.Overload("NavigateWithTransitionInfo")]
bool Navigate(TypeName const& sourcePageType, IInspectable const& parameter, NavigationTransitionInfo const& infoOverride);
[Windows.Foundation.Metadata.Overload("NavigateWithTransitionInfo")]
public bool Navigate(System.Type sourcePageType, object parameter, NavigationTransitionInfo infoOverride);
function navigate(sourcePageType, parameter, infoOverride)
Public Function Navigate (sourcePageType As Type, parameter As Object, infoOverride As NavigationTransitionInfo) As Boolean
Parâmetros
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
Platform::Object
IInspectable
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
bool
- Atributos
Exemplos
<Frame x:Name="myFrame">
<Frame.ContentTransitions>
<TransitionCollection>
<NavigationThemeTransition />
</TransitionCollection>
</Frame.ContentTransitions>
</Frame>
// 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 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 CustomerID
e procure o Customer
após a conclusão da navegação.
Ponta
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