aspxpivotgrid layout upgrade event

WebForms的枢轴网格 - 如何管理Pivot网格布局

以下示例演示了如何从一个枢轴网格中保存布局并将其应用于另一个枢轴网格。

要查看的文件

• default.aspx（cs） / default.aspx（vb）
• default.aspx.cs / default.aspx.vb

示例概述

枢轴网格布局确定其视觉元素的位置和外观。您可以自定义并保存当前的枢轴网格控件的布局，并将相同的设置应用于其他枢轴网格控件。

旧的枢轴网格包含新枢轴网格中不存在的“年”和“四分之一”字段。新的枢轴网格包含旧枢轴网格中不存在的“国家”和“销售人员”字段。当您将保存的布局应用于新的Pivot网格控制中时，“保存的布局”中的“年”和“季度”字段取代了“国家”和“销售人员”字段。此行为是由RemoveoldColumns和AddNewColumns属性设置的。在此示例中，删除columns和addNewColumns属性设置为false 。结果，枢轴网格还原保存的布局中存在的字段，并在枢轴网格和具有相同名称值的保存布局中留下字段。

为两个枢轴网格控件定义了布局属性。当您单击“还原布局”按钮（并且从数据存储中恢复保存的布局）时，由于布局版本不同，因此增加了布局调整事件。结果，将新的“数量”字段添加到新的枢轴网格控制中。

枢轴网格使用字段的名称属性值来确定存储的布局中的字段。

相关API

• aspxpivotgrid.savelayouttostream

  将枢轴网格布局保存到指定的流。

• aspxpivotgrid.loadlayoutfromstream

  从指定的流恢复枢轴网格布局。

• 选项columnlayout.storeapearance

  获取或设置是当布局保存到存储中时还存储列和频段的外观设置，并在从存储中恢复布局时还原。在此示例中，存储“年”和“四分之一”字段的标题。

• OptionsColumnLayout.AddNewColumns，OptionsColumnLayout.removeoldColumns

  新列是控件中的字段，旧列是保存的布局中的字段。

  如果旧字段和新字段具有相同的ID，则控件将保存的布局更改对控件中的字段进行更改。

  如果旧字段和新字段具有不同的ID，则会发生以下行为：

  • 如果两个属性都是正确的，则枢轴网格将从保存的布局中删除字段，并允许控件中的字段保留在那里。

  • 如果两个属性都是错误的，则枢轴网格将从布局恢复字段并从控件中删除字段。

  • 如果AddNewColumns为真，并且emoveOldColumns是错误的，则枢轴网格将恢复布局中的字段，并将控件中的字段留在那里。

  • 如果addNewColumns为false ，并且removeOldColumns为真，则枢轴网格将从布局和控制中删除字段。

• aspxpivotgrid.layoutupgrade

  当从数据存储中恢复布局时发生，并且其版本与控件的当前布局版本不同。使用LeaouTversion属性分配布局的版本，并启用Layoutupgrade事件。

文档

• 保存和还原布局

此示例是否满足您的开发要求/目标？

（您将被重定向到devexpress.com提交您的答复）