BlogJava-云自无心水自闲-随笔分类-.Net

DevExpress XtraReports设计器中工具箱控件的本地化（主要是汉化）

云自无心水自闲 — Wed, 08 Nov 2006 07:15:00 GMT

第一步. 使用正统的Localizer方法
在项目中添加一个类ChnReportLocalizer，继承ReportLocalizer，将ReportLocalizer类的所有代码拷贝过来。原来的代码返回的都是英文，我们需要全部翻译成中文
比如原来是    case ReportStringId.Msg_FileNotFound:
                    return "File not found.";
我们修改成：
            case ReportStringId.Msg_FileNotFound:
                    return "文件没有找到";
全部翻译完毕后，赋值
DevExpress.XtraReports.Localization.ReportLocalizer.Active = new ChnReportLocalizer();
再次运行XtraReports的Designer，发现只有第一个Pointer被正确的翻译了，下面的CheckBox、RichText等等都还是英文。查找原因发现工具箱的控件是动态生成的，在XtraReports.UserDesigner.Native.AsmHelper中的函数GetToolboxItems负责往工具箱内添加控件。控件显示的名称就是ToolboxItem的DisplayName。

OK，搞清楚之后开始动手修改，
1. 在XtraReports.Localization.ReportStringId这个枚举中添加控件对应的枚举，比如：Subreport对应添加枚举值为UD_SubreportCaption，CheckBox添加的枚举值为UD_CheckBoxCaption，控件名与枚举值的名称需要有对应关系，因为需要使用Enum.Parse根据控件的名称映射枚举值。
2. 在ChnReportLocalizer中添加对应的翻译，case ReportStringID.UD_SubreportCaption : return "子报表"; 等等。
3. 在AsmHelper中修改原代码，新生成的ToolboxItem不再直接添加到ArrayList中，先进行DisplayName的本地化。先根据DisplayName使用Enum.Parse获得枚举值，然后调用ReportLocalizer.GetString获得本地化的字符串赋值给ToolboxItem.DisplayName。

云自无心水自闲 2006-11-08 15:15 发表评论

XtraReports的报表编辑器

云自无心水自闲 — Tue, 26 Sep 2006 08:53:00 GMT

XtraReports的设计器可以作为给终端用户使用的独立的报表设计器, 也就是说用户可以自己编辑,预览,甚至创建报表. 这个设计器和Visual Studio的集成开发环境很象, 可以定制外观, 满足用户的需要. 甚至, 你可以自己创建报表设计器, 因为在XtraReport中设计器是一个分开独立的控件.
    先介绍一下设计器的组成元件. 报表设计器主要是用于使用户可以编辑报表. 标准的设计器是使用XRDesignFormEx类来展示的, 这个类提供了编辑和创建报表的主要功能.
    下图是一个标准的报表设计器:

    这个Form里包含了不同的元件: 报表在XRDesignPanel对象中被编辑, 其他工具栏和停靠面板由XRDesignBarManager和XRDesignDockManager控制. 所有的这些控件都可以通过设计Form的XRDesignFormExBase.DesignPanel, XRDesignFormEx.DesignBarManager和XRDesignFormEx.DesignDockManager属性来操作.
    下面列举了设计器中使用的元件接口.

Element	Description
Design Panel	这是报表设计器的主要元件. 它展示了一个面板用于创建一个新的报表或者编辑原有的报表. 它显示报表带并控制报表带中控件的归属, 并可以移动, 缩放, 复制, 粘贴这些控件, 另外还可以在控件上绑定数据, 或者进行其他的操作. 而且可以预览报表效果.
Main Menu	展示报表设计器的主菜单. 包含了一系列的项目和子项目, 用于为用户提供相关操作. 通常, 它复制所有的ToolBar按钮, 格式化按钮以及布局按钮.
Main Toolbar	展示报表设计器的ToolBar. 包含创建报表, 保存装载报表布局, 剪裁,复制,粘贴等按钮, 以及撤销, 重做等操作.
Formatting Toolbar	展示报表设计器的格式化Toolbar. 包含一些缺省的操作文本的按钮.
Layout Toolbar	展示报表设计器的布局Toolbar. 包含缩放, 移动一组控件位置的按钮.
Status Bar	在报表设计器底部展示StatusBar. 通常用于显示报表编辑操作过程中的特殊信息.
Toolbox	展示报表设计器的控件工具箱. 包含所有报表控件, 可以拖放新的控件到报表区中. 可以添加自定义控件到工具箱中.
Report Explorer	展示报表设计器的Explorer. 它显示了报表树状结构, 使用它可以很方便地浏览整个报表.
Field List	展示了报表设计器的树状字段列表. 显示了数据源的树状结构. 用于将数据绑定到报表.
Property Grid	展示报表设计器的属性容器. 可以修改报表元件的属性.

激活报表设计器: 尽管报表设计器是XRDesignFromEx的实例, 但一般不需要手工创建此对象. 通常使用以下代码:

// Create a new report.
XtraReport1 report = new XtraReport1();

// Invoke the End-User Designer and load the report into it.
report.ShowDesigner();

// Invoke the End-User Designer and load the report into it, modally.
report.ShowDesignerDialog();

云自无心水自闲 2006-09-26 16:53 发表评论

DevExpress XtraReports的控件介绍(使用帮助)

云自无心水自闲 — Mon, 25 Sep 2006 03:55:00 GMT

在此介绍创建报表过程中使用到的XtraReports的控件. 所有的控件都可以在设计时,运行时,或者通过设计器添加到报表中, 本文介绍的是一些最基本的信息.

报表控件概览

XtraReports中的所有报表对象都通过在Bands中的控件来表现. 在设计时, 报表控件可以从工具箱添加到报表中, 只有点击工具箱中需要的控件, 然后放到报表带中即可. 另一种方式是使用字段列举窗口添加控件, 这种情况下, 控件将和数据字段绑定.

如果要在运行时添加报表控件, 你只需要简单地创建一个相应类型的变量, 并通过XRControlCollection.Add方法添加到报表带中即可

所有的报表控件包括bands都是继承自XRControl. 其中部分控件可以还作为容器, 这种情况下控件集合可以通过XRControl.Controls来获得. 如果要获取控件的容器, 可使用XRControl.Parent属性.

下面列举了XtraReports中的标准报表控件.

Class	Description
Subreport	用于在报表中添加子报表. 被添加的报表需要被包含在项目中, 并设置SubReport的ReportSource属性. 子报表可用于合并报表和创建主从表.
WinControlContainer	用于添加Windows Forms或者第三方的控件. 此对实际上是添加的控件的封装, 并提供对Drawing方法的支持
XRBarCode	用于在报表中显示条形码. 使用XRBarCode.Symbology和XRBarCode.SymbologyId来设置条形码的类型
XRChart	在报表中显示图形, 使用此控件来根据一个或多个SeriesViewTypes来展示不同的数据.
XRCheckBox	用于在报表中展示复选框.
XRLabel	标签. 可以是单行的, 也可以是多行的.
XRLine	线条. 使用这个控件来画线.
XRPageBreak	换页. 如果是Band中需要换页, 那么使用控件的Band.PageBreak属性比较好.
XRPageInfo	显示报表页面的附加信息. 可以显示页码, 日期或者其他信息.
XRPanel	用于包含其他控件的控件. 可以使用此控件来进行控件的分组.
XRPictureBox	在报表中显示一个图片
XRRichText	显示一个控件, 用于显示,输入,修改格式化的文本. 可以用XRRichText.LoadFile从文件中加载文本.
XRTable	表格
XRTableCell	表格单元. 与XRControl.Text绑定
XRTableRow	表格中的行. 通过不需要用到此控件, 直接操作表格单元更普遍.
XRZipCode	邮政编码

云自无心水自闲 2006-09-25 11:55 发表评论

DevExpress的XtraReport中的Report Bands介绍和使用心得(帮助文档)

云自无心水自闲 — Fri, 22 Sep 2006 03:05:00 GMT

一个普通的XtraReport报表一般包含数个包含报表控件的带. 在这里介绍一个XtraReports中的几种不同类型的带, 他们都有一些什么用途, 又是如何添加,编辑,删除.

Report Bands

在把报表添加到应用之后, 缺省的样子如下图所示. 可以看到, 报表被初始化分为3个基本的带(页头, 明细, 和页脚), 这些带中可以添加不同的报表控件.

每一种带指明了控件在报表中是怎样定位和被打印的, 即确定了打印的顺序和次数. 注意, 有些包含了带是如何被打印的信息, 比如: PageHeader和PageFooter就说明了是每一页都有这一带的.

在创建报表时, 可以添加或者删除任意的带. 在XtraReports中有很多不同类型的带, 每一个都是的子类. 列举如下:

Bands类	描述
TopMarginBand	用于放置出现在报表每页页头最上面的控件
ReportHeaderBand	用于放置出现在报表开头的控件
PageHeaderBand	用于放置出现在报表页上面, 仅次于TopMarginBand位置的控件. 主要是用于放置需要分页的表格的头,
GroupHeaderBand	用于放置明细带中分组记录的头部控件.
DetailBand	用于显示绑定数据的每条记录
DetailReportBand	用于创建主从报表. 主从关系由从报表的XtraReportsBase.DataMember属性指定
GroupFooterBand	用于放置明细带中分组记录下方的控件
PageFooterBand	用于放置报表页下方的控件
ReportFooterBand	用于放置报表结束的控件
BottomMarginBand	用于放置报表每页最下方的控件

下图显示了不同类型的带的相对位置:

TopMarginBand and BottomMarginBand

ReportHeaderBand and ReportFooterBand

PageHeaderBand and PageFooterBand

GroupHeaderBand and GroupFooterBand

DetailBand

报表的预览显示的不是带本身, 而是的输出. PageHeaderBand, PageFooterBand, TopMarginBand和BottomMarginBand在报表预览的每一页都有输出. ReportHeaderBand和ReportFooterBand类只显示一次. GroupHeaderBand和GroupFooterBand出现在每个记录组中.

云自无心水自闲 2006-09-22 11:05 发表评论

DevExpress的XtraReports使用心得(帮助文档)

云自无心水自闲 — Fri, 22 Sep 2006 02:20:00 GMT

在XtraReport中, 每一个报表都是XtraReport或者其子类. 打个比方说, XtraReport就好象Windows Forms. 同样的道理, 所有的form都Form类的子类.

XtraReport中的报表类可以与数据绑定也可以不绑定. 如果要创建一个绑定数据的报表, 需要查看<数据绑定>和<绑定数据控件>这两个主题的帮助.
在创建一个报表时, 可以从已有的报表中加载样式和布局, 样式中包含了报表控件外观的属性值, 而布局包含了报表的结构信息. 另外, 还可以从其他报表系统中导入报表, 比如: Access, 水晶报表等等, 如果要详细了解XtraReport的导入功能, 请参阅主题.
报表类(XtraReport的子类)创建后, 就可以生成其实例. 需要注意的是, XtraReport对象可以在Windows Forms中使用也可以在Asp.net中使用. 在Windows应用中使用报表, 通常需要维护报表的, 这个对象提供了报表的输出功能.

创建报表有两种方式, 一种是简单地添加一个"模板"报表, 一种是通过报表向导来创建报表. 在报表添加到项目后, 报表设计器提供了大量的设计时元素来加快简化报表的创建. XtraReport工具箱包含了所有的控件, Report Navigator可以浏览整个报表, Feild List可以拖放数据字段来创建与数据绑定的报表控件.
XtraReport的所有报表都是由和组成的.

public class XtraReport1 : DevExpress.XtraReports.UI.XtraReport
{
   private DevExpress.XtraReports.UI.DetailBand Detail;
   private DevExpress.XtraReports.UI.PageHeaderBand PageHeader;
   private DevExpress.XtraReports.UI.PageFooterBand PageFooter;
   private DevExpress.XtraReports.UI.XRLabel xrLabel1;
   private DevExpress.XtraReports.UI.XRLabel xrLabel2;

   private System.ComponentModel.Container components = null;

   public XtraReport1()
   {
      InitializeComponent();
   }

   protected override void Dispose( bool disposing )
   {
      if( disposing )
      {
         if(components != null)
         {
            components.Dispose();
         }
      }
      base.Dispose( disposing );
   }

   // .

然后开始创建报表的结构, 首先在XtraReportBase.Bands属性中添加Bands, 然后在相应的Bands的XRControl.Controls属性中添加控件. 报表带和控件的添加方法一般是这样的

// Add Detail, PageHeader and PageFooter bands to the report's collection of bands.
this.Bands.AddRange(new DevExpress.XtraReports.UI.Band[] {this.Detail, this.PageHeader, this.PageFooter});

// Add two XRLabel controls to the Detail band.
this.Detail.Controls.AddRange(new DevExpress.XtraReports.UI.XRControl[] {this.xrLabel1, this.xrLabel2});

最后创建好的报表可以输出给用户看了

// Create a report.
XtraReport1 report = new XtraReport1();

// Create the report's document so it can then be previewed, printed or exported.
// NOTE: Usually you don't need to call this method as it's automatically called by all of the following methods.
// See the corresponding member topic to find out when it needs to be called.
report.CreateDocument();

// Show the form with the report's print preview.
report.ShowPreview();

// Print the report in a dialog and "silent" mode.
report.PrintDialog();
report.Print();

// Open the report in the End-User designer
report.RunDesigner();

// Export the report.
report.CreateHtmlDocument("report.html");
report.CreatePdfDocument("report.pdf");
report.CreateImage("report.jpg", System.Drawing.Imaging.ImageFormat.Gif);

附: XtraReport的类结构层次图:

云自无心水自闲 2006-09-22 10:20 发表评论

Asp.net 2.0 中集成的表单验证控件，完全实现了用户登录功能。

云自无心水自闲 — Wed, 01 Mar 2006 07:19:00 GMT

表单认证是Asp.net中最Cool的功能之一，一般来说应用都会要求输入认证信息（典型的是用户名和密码）。
在Web.config的设置项中，可以指定登录页面和哪些资源需要保护。当用户第一次访问被保存的资源时，应用会自动定向到指定的登录页面。
如果成功登录，ASP.NET会转到用户初始请求的页面。
以往的应用需要在每个页面的顶部判断用户是否成功登录，手工定向到登录页面，而现在这个工作由表单认证简单地完成了。

举个简单的例子来说明开发过程：
一个应用中有两个页面PublicPage.aspx是向公众开放的，PrivatePage.aspx只允许登录用户才能访问。
第3个页面是登录页面，要求输入用户名和密码。
步骤如下：
1、把PublicPage.aspx, login.aspx, web.config拷贝到一个IIS的虚拟目录下。
2、创建一个子目录Secret，将PrivatePage.aspx, web.config拷贝到子目录中。
3、在web.config中添加以下代码, 实现访问保存页面自动跳转登录页面的功能

....

4、另外有一个小节列出合法用户和密码

此例子中关掉了的加密选项，缺省是开的。

5、在Secret子目录的web.config中添加以下代码，实现保护功能。

这是用于通知权限管理模块System.Web.Security.UrlAuthorizationModule阻止未登录用户的访问。"?"代表匿名用户，也可以说是未登录用户。
实际的权限验证是由Login.aspx完成的。下列语句
if(FormsAuthentication.Authenticate(UserName.Text,Password.Text))
把用户名和密码传给System.Web.Security.FormsAuthentication，如果验证成功，返回True。并且执行页面跳转语句
FormsAuthentication.RedirectFromLoginPage(UserName.Text,false);

6、真实环境的表单认证比上面的例子要复杂的多，真实应用不大可能把用户和密码保存在文本文件中，比较常见的是存放在数据库中。
假定用户表Users有3个字段UserName, password, Role.
对于这种情况，我们需要在刚才的基础上进行2个地方的修改：Login.aspx、web.config(根目录下的)
在web.config中不再需要小节了。
login.aspx也不再使用 FormsAuthentication.Authenticate 来验证密码，而使用CustomAuthenticate替代。
在这个方法中使用Sql查询语句来判断用户是否合法。

云自无心水自闲 2006-03-01 15:19 发表评论