Frame.Navigate Método

Definição

Namespace:

Windows.UI.Xaml.Controls

Sobrecargas

Navigate(TypeName)	Faz com que o Frame carregue o conteúdo representado pelo tipo de dados derivado de página especificado.
Navigate(TypeName, Object)	Faz com que o Frame carregue o conteúdo representado pelo tipo de dados derivado de 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 de página especificado, passando também um parâmetro a 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 Frame carregue o conteúdo representado pelo tipo de dados derivado de página especificado.

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

sourcePageType

TypeName Type

A página para a qual navegar, especificada como uma referência de tipo para seu tipo de classe parcial. Deve ser um tipo de dados derivado de página; caso contrário, uma exceção será gerada. (Uma referência de tipo é fornecida como System.Type para Microsoft .NET ou um struct auxiliar TypeName para extensões de componente do Visual C++ (C++/CX)).

Retornos

Boolean

bool

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

Implementações

M:Windows.UI.Xaml.Controls.INavigate.Navigate(Windows.UI.Xaml.Interop.TypeName) M:Windows.UI.Xaml.Controls.INavigate.Navigate(System.Type)

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 como true e usar o valor retornado do método Navigate para responder à falha.

Os aplicativos normalmente usam GetNavigationState para serializar o estado do quadro quando o aplicativo é suspenso. Você pode fazer isso diretamente no código do aplicativo ou indiretamente usando a SuspensionManager classe gerada pelos modelos do Visual Studio. Para habilitar a serialização de estado de quadro usando GetNavigationState, você deve usar apenas tipos básicos para o parâmetro de navegação, como os tipos de cadeia de caracteres, char, numeric e GUID . Caso contrário , GetNavigationState lançará uma exceção quando o aplicativo for suspenso. O parâmetro poderá ter outros tipos se você não usar GetNavigationState.

O valor do parâmetro poderá 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 parâmetro . 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 Customer objeto , passe uma referência para o CustomerIDe procure o Customer depois que a navegação for concluída.

Dica

Se você estiver programando usando uma linguagem Microsoft .NET (C# ou Microsoft Visual Basic), o tipo TypeName será projetado 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 extensões de componente do Visual C++ (C++/CX), em que precisará criar um struct auxiliar TypeName , poderá usar a extensão de componente typeid.

Confira também

• Page
• Navigate(TypeName, Object)
• NavigationFailed
• Navegação

Navigate(TypeName, Object)

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

public:
 virtual bool Navigate(TypeName sourcePageType, Platform::Object ^ parameter) = Navigate;

bool Navigate(TypeName const& sourcePageType, IInspectable const& parameter);

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

sourcePageType

TypeName Type

A página para a qual navegar, especificada como uma referência de tipo para seu tipo de classe parcial. Deve ser um tipo de dados derivado de página; caso contrário, uma exceção será gerada. (Uma referência de tipo é fornecida como System.Type para Microsoft .NET ou um struct auxiliar TypeName para extensões de componente do Visual C++ (C++/CX)).

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 (string, char, numeric ou GUID) para dar suporte à serialização de parâmetros usando GetNavigationState.

Retornos

Boolean

bool

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

Confira também

• Page
• Navigate(TypeName)
• Navegação

Navigate(TypeName, Object, NavigationTransitionInfo)

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

public:
 virtual bool Navigate(TypeName sourcePageType, Platform::Object ^ parameter, NavigationTransitionInfo ^ infoOverride) = Navigate;

bool Navigate(TypeName const& sourcePageType, IInspectable const& parameter, NavigationTransitionInfo const& infoOverride);

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

sourcePageType

TypeName Type

A página para a qual navegar, especificada como uma referência de tipo para seu tipo de classe parcial. Deve ser um tipo de dados derivado de página; caso contrário, uma exceção será gerada. (Uma referência de tipo é fornecida como System.Type para Microsoft .NET ou um struct auxiliar TypeName para extensões de componente do Visual C++ (C++/CX)).

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 (string, char, numeric ou GUID) para dar suporte à serialização de parâmetros usando GetNavigationState.

infoOverride

NavigationTransitionInfo

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

Retornos

Boolean

bool

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

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

Confira também

• Navigate(TypeName, Object)
• Navigate(TypeName)
• Navegação