Page 类 (System.Windows.Controls)

开启低带宽视图

全部折叠

语言筛选器

此页面仅适用于

Microsoft Visual Studio 2008/.NET Framework 3.5

同时提供下列产品的其他版本：

.NET Framework 3.0

.NET Framework 类库

Page 类

更新：2007 年 11 月

封装一页可由 Windows Internet Explorer、NavigationWindow 和 Frame 导航到和承载的内容。

命名空间： System.Windows.Controls
程序集： PresentationFramework（在 PresentationFramework.dll 中）
用于 XAML 的 XMLNS：http://schemas.microsoft.com/winfx/xaml/presentation

语法

Visual Basic（声明）

<ContentPropertyAttribute("Content")> _
Public Class Page _
    Inherits FrameworkElement _
    Implements IAddChild

Visual Basic (用法)

Dim instance As Page

[ContentPropertyAttribute("Content")]
public class Page : FrameworkElement, IAddChild

Visual C++

[ContentPropertyAttribute(L"Content")]
public ref class Page : public FrameworkElement, 
    IAddChild

/** @attribute ContentPropertyAttribute("Content") */
public class Page extends FrameworkElement implements IAddChild

JScript

public class Page extends FrameworkElement implements IAddChild

XAML 对象元素用法

<Page>
  Content
</Page>

备注

Page 封装一页可导航的内容，并具有以下关键成员：

生存期管理：KeepAlive。
导航：NavigationService。
外观：Background、Content、FontFamily、FontSize、Foreground、ShowsNavigationUI、Template、Title。
宿主窗口外观：WindowHeight、WindowWidth、WindowTitle。

可以使用标记、标记和代码隐藏或者代码来定义页。页通常是为导航而打包内容的首选方式，原因如下：

它易于定义、重用和管理。
它可以访问并使用导航到它的 NavigationService。
它可以改变其宿主窗口的标题、宽度、高度和导航 UI（WindowTitle、WindowWidth、WindowHeight、ShowsNavigationUI）。
Microsoft Visual Studio 为它提供了设计器支持。

页可以通过 Window、NavigationWindow、Frame、UserControl 或浏览器来承载。要进行承载，页可以：

是 XAML 中的 Window、NavigationWindow 或 Frame 元素的直接子元素。
实例化并设置为 Window、NavigationWindow 和 Frame 的 Content 属性的值。
设置为 NavigationWindow 或 Frame 的 Source 属性的统一资源标识符 (URI) 源。
设置为独立应用程序中的 StartupUri。
设置为 XBAP 中的 StartupUri。

一个应用程序通常具有两个或更多页，可以使用以下机制在这些页之间导航：

使用 Hyperlink 以声明方式导航。
使用 NavigationService 以编程方式导航。
使用宿主的导航 UI（包括 Windows Internet Explorer、NavigationWindow 和 Frame）以可视方式导航。

有关使用页函数 (PageFunction<(Of <(T>)>)) 的结构化导航，请参见结构化导航概述和导航拓扑概述。

示例

下面的示例演示如何只使用标记来定义一个标准页：

<Page 
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    Title="Markup Page">
  <!-- Page Content Goes Here -->
</Page>

下面的示例演示如何只使用代码来定义一个标准页：

using System.Windows.Controls;

public class CodePage : Page
{
    public CodePage() {}
}

下面的示例演示如何使用标记与代码隐藏的组合来定义一个标准页。

<Page 
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="MarkupAndCodeBehindPage"
    Title="Markup And Code-Behind Page">
  <!-- Page Content Goes Here -->
</Page>

using System.Windows.Controls;

public partial class MarkupAndCodeBehindPage : Page
{
    public MarkupAndCodeBehindPage()
    {
        InitializeComponent();
    }
}

继承层次结构