MultiView.ActiveViewIndex属性

获取或设置 MultiView 控件的活动 View 控件的索引。

命名空间：System.Web.UI.WebControls

属性值

类型：System.Int32

 

MultiView 控件的活动 View 控件的从零开始的索引。默认值为 -1，指示没有任何视图设置为活动视图。

 

 

使用 ActiveViewIndex 属性将 MultiView 控件中的 View 控件设置为活动视图。此属性也可用来返回当前设置为活动视图的 View 控件的索引。 View 控件的索引是由它在 MultiView 控件中的声明顺序确定的。例如，在 MultiView 控件中声明的第一个 View 控件的索引为 0。

在 MultiView 控件中，一次只能将一个 View 控件定义为活动视图。设置为 ActiveViewIndex 属性的 View 控件将呈现到客户端。如果 ActiveViewIndex 属性设置为 MultiView 控件中不存在的 View，则会在运行时引发 ArgumentOutOfRangeException。如果该属性为空，则 MultiView 控件不向客户端呈现任何内容。

可以在开发时以声明方式或在运行时以编程方式设置 ActiveViewIndex 属性。如果在定义 MultiView 控件时以声明方式设置 ActiveViewIndex 属性，则会使设置为活动视图的 View 控件在首次调用 MultiView 控件时呈现到客户端。如果以编程方式设置 ActiveViewIndex 属性，则应用程序可以在运行时根据用户标识或首选项等条件，确定向客户端呈现哪个 View 控件。

或者，也可以使用 SetActiveView 和 GetActiveView 方法设置或获取 MultiView 控件的活动视图。