点击获取工具 >>
零碎背景
- 平台：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 处理程序提供动静内容）。