点击获取工具>>

系统背景

• 平台：Frameworks (XAF & XPO)
• 产品：eXpressApp Framework

在某些情况下，可能需要在UI中创建其他功能区域来显示特定数据。通过在XAF模板中包含其他控件并实现将数据提供给控件的代码，可以解决此任务。 为了帮助您完成任务，XAF提供内置的CustomizeTemplateViewControllerBase控制器以及对内置模板的完整设计时支持。 结合使用这些功能，您可以轻松实现信息面板，该面板可以显示操作、视图以及可从View Controller访问的任何类型的数据，本文为大家介绍创建简单信息面板所需执行的步骤。

在应用程序中包含必需的模板

首先您需要确定要自定义的模板，在应用程序的不同部分中使用不同的模板。在本文中，将自定义Windows Forms MainForm和DetailViewForm模板以及ASP.NET DefaultVertical模板。

Windows Forms模板

内置Windows Forms模板是位于DevExpress.ExpressApp.Win程序集中的常规类，要自定义它们，您需要在解决方案中包含相应的源代码文件并处理XafApplication.CreateCustomTemplateevent。

ASP.NET模板

内资的ASP.NET模板其内容来自于位于DevExpress.ExpressApp.Web程序集中的用户控件页面，要自定义它们，您需要在解决方案中包含相应的源代码文件，并修改通过WebApplication.Settings属性公开的适当设置。

解决方案中包含所有必需的模板后，即可开始向其中添加面板控件。

将Panel Controls添加到Windows Forms Templates

要将面板控件添加到MainForm或DetailViewForm模板中，请在Solution Explorer中右键单击该模板，然后选择"View Designer"。

找到viewSitePanel控件，并将其Dock属性从Fill更改为None。

为了确保可以正确调整模板的大小，请将SplitContainerControl的Dock属性设置为Fill，将FixedPanel属性设置为Panel2。

为了能够用信息填充信息面板，SplitContainerControl必须在外部可见。 为此定义一个界面，通过该界面可以访问信息面板，这将使数据提供控制器与特定模板类型脱钩，相反他们将依赖接口。

`public interface IInfoPanelTemplateWin : IFrameTemplate {
DevExpress.XtraEditors.SplitContainerControl SplitContainer { get; }
}`

然后，在模板中实现接口。

`public partial class MainForm : MainFormTemplateBase, IDockManagerHolder,
ISupportClassicToRibbonTransform, IInfoPanelTemplateWin {
//...
public DevExpress.XtraEditors.SplitContainerControl SplitContainer {
get { return splitContainerControl1; }
}
}`

将面板控件添加到ASP.NET Web模板

要将面板控件添加到DefaultVertical模板，请右键单击您添加的ASCX文件，以替代标准DefaultVertical内容，然后选择 "View Markup"。

将以下两个单元格添加到MRC表。
`<td id="RS" style="width: 6px; border-bottom-style: none; border-top-style: none"
class="dxsplVSeparator_<%= BaseXafPage.CurrentTheme %>
dxsplPane_<%= BaseXafPage.CurrentTheme %>">
<div id="RSB" class="dxsplVSeparatorButton_<%= BaseXafPage.CurrentTheme %>"
onmouseover="OnMouseEnter('RSB')"
onmouseout="OnMouseLeave('RSB')" onclick="OnClick('Right', 'RSI')">
<div id="RSI" style="width: 6px;"
class="dxWeb_splVCollapseForwardButton_<%= BaseXafPage.CurrentTheme %>"/>
</div>
</td>
<td id="Right" width="250px" style="vertical-align: top">
<cc3:XafUpdatePanel ID="UPRight" runat="server" />
</td>`

该标记中的UPRight控件将代表信息面板。

打开ASCX的代码隐藏文件 - 右键单击该文件，然后选择View Code。

通过公开属性公开protected UPRight控件。
`public partial class MyDefaultVerticalTemplateContent : TemplateContent {
public Control PlaceHolder {
get { return UPRight; }
}
// ...
}`
在ASP.NET模块项目中，定义一个接口，控制器将通过该接口访问信息面板。
`public interface IInfoPanelTemplateWeb : IFrameTemplate {
Control PlaceHolder { get; }
}`
在Default模板中实现此接口 - 编辑位于ASP.NET应用程序项目中的`Default.aspx.cs文件。
public partial class Default : BaseXafPage, IInfoPanelTemplateWeb {
public Control PlaceHolder {
get {
return TemplateContent is MyDefaultVerticalTemplateContent
? ((MyDefaultVerticalTemplateContent)TemplateContent).PlaceHolder : null;
}
}
// ...
}`
现在，您需要实现Windows Forms和ASP.NET Web View Controllers，它们将为面板控件提供实际数据。为简化此任务，XAF提供要继承的CustomizeTemplateViewControllerBase Controller，为方便起见，TemplateType泛型参数可以是模板类型，也可以是由模板实现的接口。 CustomizeTemplateViewControllerBase已经提供了模板访问逻辑，因此您所要做的就是实现四个受保护的抽象方法。

• AddControlsToTemplateCore(TemplateType template) - 激活Controller后调用，此方法必须实例化所需要的控件并将其添加到信息面板中。
• RemoveControlsFromTemplateCore(TemplateType template) - 停用Controller时调用，此方法必须从信息面板中删除以前添加的控件。
• UpdateControls(View view) - 当前视图更改时调用，如果需要，此方法必须使用特定于视图的信息更新信息面板控件。
• UpdateControls(object currentObject) - 当前显示的对象更改时调用，如果需要，此方法必须使用特定于当前显示对象的数据更新信息面板控件。

注意：您可以访问XAF模板并对其进行自定义，来为您的任务实现标准的ASP.NET技术（例如，使用HTTP处理程序提供动态内容）。