2024年3月29日发(作者:)

MultiView

View Web

服务器控件概述

发送反馈

MultiView 和 View Web 服务器控件用作其他控件和标记的容器,并提供了一种可方便

地显示信息的替换视图的方式。

本主题包括:

方案

背景

代码示例

Class Reference

方案

可以使用 MultiView 和 View 控件执行如下任务:

根据用户选择或其他条件提供备选控件集。例如,您可能允许用户从一个源 (feed) 列表中

选择,其中每个源都在独立的 View 控件中配置。 然后可以显示包含用户选择的源的

View 控件。 可以使用 MultiView 和 View 控件作为创建多个 Panel 控件的一种替代方

法。

创建多页窗体。MultiView 和 View 控件可以提供与 Wizard 控件相似的行为。 Wizard

控件尤其适合于创建用户分步骤填写的窗体。 Wizard 控件还支持更多内置 UI 元素(如

页眉和页脚)、 “上一页”和 “下一页”按钮以及模板。 如果要创建根据条件(而不是按顺序)

更改的显示,或者不需要Wizard 控件支持的额外功能,则可以使用 MultiView 控件来代

替 Wizard。

返回页首

背景

MultiView 控件用作一个或多个 View 控件的外部容器。 View 控件又可包含标记和控件

的任何组合。

MultiView 控件一次显示一个 View 控件,并公开该 View 控件内的标记和控件。 通过

设置 MultiView 控件的 ActiveViewIndex 属性,可以指定当前可见的View 控件。

呈现 View 控件内容

未选择某个 View 控件时,该控件不会呈现到页面中。 但是,每次呈现页面时都会创建所

有 View 控件中的所有 Web 服务器控件的实例,并且将这些实例的值存储为页面的视图

状态的一部分。

无论是 MultiView 控件还是各个 View 控件,除当前 View 控件的内容外,都不会在页

面中显示任何标记。 例如,这些控件不会以与 Panel 控件相同的方式来呈现 div 元素。

这些控件也不支持可以作为一个整体应用于当前 View 控件的外观属性。 但是可以将一个

主题分配给 MultiView 或 View 控件,控件将该主题应用于当前 View 控件的所有子控

件。

引用控件

每个 View 控件都支持 Controls 属性,该属性包含该 View 控件中的控件集合。 也可

以在代码中单独引用 View 控件中的控件。 有关详细信息,请参见Accessing

Controls Programmatically。

在视图间导航

通过将 MultiView 控件的 ActiveViewIndex 属性设置为要显示的 View 控件的索引值,

可以在视图间移动。 MultiView 控件还支持可以添加到每个 View 控件的导航按钮。

若要创建导航按钮,可以向每个 View 控件添加一个按钮控件( Button、 LinkButton 或

ImageButton)。 然后可以将每个按钮的 CommandName 和CommandArgument 属

性设置为保留值以使 MultiView 控件移动到另一个视图。 下表列出了保留的

CommandName 值和相应的 CommandArgument 值。

CommandName

CommandArgument 值

NextView

(没有值)

PrevView

(没有值)

SwitchViewByID

要切换到的 View 控件的 ID。

SwitchViewByIndex

要切换到的 View 控件的索引号。

下面的代码示例显示一个包含三个 View 控件的 MultiView 控件。 每个 View 控件包含

一个移动到特定 View 控件的 Button 控件。

打印

View 1


CommandArgument="View2"

CommandName="SwitchViewByID"

Text="Go to View2" />

View 2


CommandArgument="View3"

CommandName="SwitchViewByID"

Text="Go to View 3" />

View 3


CommandArgument="View1"

CommandName="SwitchViewByID"

Text="Go to View 1" />

返回页首

代码示例

如何:向 Web 窗体页添加 MultiView Web 服务器控件

返回页首

类参考

The following table lists the classes that relate to the MultiView and View controls.

Member

说明

MultiView The main class for the MultiView control.

ViewCollection

表示一个集合,该集合使 MultiView 控件可以维护其子控件的列表。

View

View 控件的主类。

MultiViewControlB

与分析器进行交互以生成 MultiView 控件。 若要为 MultiView 派生的控件创建自定义控件

uilder

生成器,需要从此类继承。