C# Winform 通过FlowLayoutPanel及自定义的编辑控件，实现快速构建C/S版的编辑表单页面

个人理解，开发应用程序的目的，不论是B/S或是C/S结构类型，无非就是实现可供用户进行查、增、改、删，其中查询用到最多，开发设计的场景也最为复杂，包括但不限于：表格记录查询、报表查询、导出文件查询等等，其次就是增加、更改、删除，我这里统称为编辑，而编辑在开发设计中的场景就显得较为通用，大多都采用编辑组件（文本框、下拉框、选择框、数字框等）来供用户进行编辑操作，由于查询的开发设计场景需与实际的数据及客户要求来进行的，所以在此不作讨论，本文主要讲述的是如何利用FlowLayoutPanel及我（梦在旅途）自定义的编辑控件来实现快速构建C/S版的编辑表单页面。

有经历过开发ASP.NET MVC网站的人都知道，在构建编辑页面时，我们可以通过HtmlHelper扩展类相关方法来快速生成相应的编辑控件，如：Html.LabelFor,Html.TextBoxFor等等，而在Winform 项目中却并没有类似的方法可以让我们快速构建编辑表单页面，所以为了减轻我们经常遇到，又比较耗时，且没有任何技术含量的开发工作量，我开发了类似的编辑控件系列，包括：CTextBox【文本框】、CPictureBox【图片框】、CNumberBox【数字框】、CDropDownBox【下拉框】、CDisplayBox【显示框】、CCheckBox【勾选框】,这些控件都一些共有特性，如：Label：显示编辑项目名称，Value：控件的值，ValueFor<TEntity>：快速设置控件相关属性的方法，这些共有特性是实现快速构造编辑控件的关键，当然每种编辑控件还有自己独特的属性，如：CTextBox可以设置是否显示按钮，是否只读，是否多行等，CNumberBox可以设置小数位、最大值与最小值等，由于这些控件的代码加起来可能比较多，我这里仅以CTextBox为例来进行分析与说明，CTextBox是属性最多的控件。

首先还是看一下CTextBox控件的界面设计，如下图：



从图中可以看出，CTextBox控件由一个TableLayouPanel、一个Label、一个TextBox、一个Button共同组成：

TableLayouPanel作为控件的顶层容器，其DOCK属性设置为Fill，实现占据整个控件，另外分别设有一行三列，第一列宽度设为自动调整，第二列宽度设为100%，第三列宽度设为自动调整，如下图：



TableLayouPanel这样设计的目的是：实现第一列的宽度依据LABEL的内容自动调整，第二列的宽度为TextBox的宽度，第三列的宽度为Button的宽度，这样一来，我们在改变CTextBox的整个大小时，确保布局一致性（即：在CTextBox总宽度内，TextBox的宽度是CTextBox总宽度-LABEL与Button的实际宽度）

Label控件作为显示编辑项目名称部份，它的属性AutoSize设为True,Anchor设为Left，设计目的：实现在第一列中向左居中，且宽度依据实际内容而改变

TextBox控件作为可供编辑内容部份，它的属性设Anchor设为Top, Bottom, Left, Right，设计目的：实现 TextBox控件占据整个第二列，即若控件的宽度与高度改变，TextBox控件也会跟着改变，这个很重要哦！

Button控件为可选部份，若需要用到控件的值来源于其它选项（如：浏览文件、保存文件等），则可将其CTextBox.DispalyOpenButton设为True即可，同样，它的属性Anchor设为Left，并调整好固定的宽度与高度，设计目的：实现在第三列中向左居中，且宽度不变

实现的整体效果如下图示：





我这里用红线框出来了，大家看出效果来了吗？也就是我直接拖放了三个CTextBox控件，然后分别将LABEL的内容设置为不相同，除非手动改变控件宽度，否则每个控件宽度均相同，这样再结合FlowLayoutPanel控件的流式布局（即：每个控件按照顺序依次排列，若宽度与高度发生变化，控件的排列就会改变），就能很好的快速构建编辑页面，看看最终用在我的项目中的效果吧，有没有觉得不错呢：



这是改变宽度前的布局，有5列，我有红框标出来了，都是对齐的



这是我缩小宽度后的布局，有2列，我有红框标出来了，仍然都是对齐的

以上布局效果是不需要编写任何代码的，代码部份仅是设置相应的属性与方法，如下：

CTextBox控件源码：

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Data;
using System.Linq;
using System.Text;
using System.Windows.Forms;
using System.Linq.Expressions;
using Zwj.TEMS.Common;

namespace TEMS.Controls
{
public partial class CTextBox : UserControl,IZwjDefControl
{
[Description("当点击按钮时触发该事件")]
public event EventHandler OnOpen;

public CTextBox()
{
InitializeComponent();
this.DispalyOpenButton = false;
}

[Browsable(true)]
[Description("设置文本框的值")]
public string Value
{
get
{
return textBox1.Text;
}
set
{
textBox1.Text = value;
}
}

[Browsable(true)]
[Description("设置标签的值")]
public string Label
{
get
{
return label1.Text;
}
set
{
label1.Text = value;
}
}

[Browsable(true)]
[Description("设置是否显示打开按钮")]
public bool DispalyOpenButton
{
get
{
return button1.Visible;
}
set
{
button1.Visible = value;
textBox1.ReadOnly = button1.Visible;
}
}

[Browsable(true)]
[Description("设置是否允许多行")]
public bool AllowMultiline
{
get
{
return textBox1.Multiline;
}
set
{
textBox1.Multiline = value;
if (textBox1.Multiline)
{
textBox1.ScrollBars = ScrollBars.Vertical;
}
}
}

public void ValueFor<TEntity>(Expression<Func<TEntity, dynamic>> selectField, string fieldValue, bool displayBtn = false, bool allowMultiline=false) where TEntity : class
{
var fieldInfo = General.GetPropertyInfo(selectField);
this.Label = General.GetDisplayName(fieldInfo);
this.Value = fieldValue;
this.DispalyOpenButton = displayBtn;
this.AllowMultiline = allowMultiline;
}

private void button1_Click(object sender, EventArgs e)
{
if (this.OnOpen != null)
{
this.OnOpen(this, null);
}
}
}
}

　　

以下是系统自动生成的源码：

namespace TEMS.Controls
{
partial class CTextBox
{
/// <summary>
/// 必需的设计器变量。
/// </summary>
private System.ComponentModel.IContainer components = null;

/// <summary>
/// 清理所有正在使用的资源。
/// </summary>
/// <param name="disposing">如果应释放托管资源，为 true；否则为 false。</param>
protected override void Dispose(bool disposing)
{
if (disposing && (components != null))
{
components.Dispose();
}
base.Dispose(disposing);
}

#region 组件设计器生成的代码

/// <summary>
/// 设计器支持所需的方法 - 不要
/// 使用代码编辑器修改此方法的内容。
/// </summary>
private void InitializeComponent()
{
this.tableLayoutPanel1 = new System.Windows.Forms.TableLayoutPanel();
this.label1 = new System.Windows.Forms.Label();
this.textBox1 = new System.Windows.Forms.TextBox();
this.button1 = new System.Windows.Forms.Button();
this.tableLayoutPanel1.SuspendLayout();
this.SuspendLayout();
//
// tableLayoutPanel1
//
this.tableLayoutPanel1.ColumnCount = 3;
this.tableLayoutPanel1.ColumnStyles.Add(new System.Windows.Forms.ColumnStyle());
this.tableLayoutPanel1.ColumnStyles.Add(new System.Windows.Forms.ColumnStyle(System.Windows.Forms.SizeType.Percent, 100F));
this.tableLayoutPanel1.ColumnStyles.Add(new System.Windows.Forms.ColumnStyle());
this.tableLayoutPanel1.Controls.Add(this.label1, 0, 0);
this.tableLayoutPanel1.Controls.Add(this.textBox1, 1, 0);
this.tableLayoutPanel1.Controls.Add(this.button1, 2, 0);
this.tableLayoutPanel1.Dock = System.Windows.Forms.DockStyle.Fill;
this.tableLayoutPanel1.Location = new System.Drawing.Point(0, 0);
this.tableLayoutPanel1.Name = "tableLayoutPanel1";
this.tableLayoutPanel1.RowCount = 1;
this.tableLayoutPanel1.RowStyles.Add(new System.Windows.Forms.RowStyle(System.Windows.Forms.SizeType.Percent, 100F));
this.tableLayoutPanel1.Size = new System.Drawing.Size(250, 40);
this.tableLayoutPanel1.TabIndex = 0;
//
// label1
//
this.label1.Anchor = System.Windows.Forms.AnchorStyles.Left;
this.label1.AutoSize = true;
this.label1.Font = new System.Drawing.Font("微软雅黑", 11.25F, System.Drawing.FontStyle.Regular, System.Drawing.GraphicsUnit.Point, ((byte)(134)));
this.label1.Location = new System.Drawing.Point(3, 10);
this.label1.Name = "label1";
this.label1.Size = new System.Drawing.Size(44, 20);
this.label1.TabIndex = 0;
this.label1.Text = "label";
this.label1.TextAlign = System.Drawing.ContentAlignment.MiddleLeft;
//
// textBox1
//
this.textBox1.Anchor = ((System.Windows.Forms.AnchorStyles)((((System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Bottom)
| System.Windows.Forms.AnchorStyles.Left)
| System.Windows.Forms.AnchorStyles.Right)));
this.textBox1.Font = new System.Drawing.Font("微软雅黑", 11.25F, System.Drawing.FontStyle.Regular, System.Drawing.GraphicsUnit.Point, ((byte)(134)));
this.textBox1.Location = new System.Drawing.Point(53, 3);
this.textBox1.Name = "textBox1";
this.textBox1.Size = new System.Drawing.Size(151, 27);
this.textBox1.TabIndex = 1;
//
// button1
//
this.button1.Anchor = System.Windows.Forms.AnchorStyles.None;
this.button1.Location = new System.Drawing.Point(210, 8);
this.button1.Name = "button1";
this.button1.Size = new System.Drawing.Size(37, 23);
this.button1.TabIndex = 2;
this.button1.Text = "...";
this.button1.UseVisualStyleBackColor = true;
this.button1.Click += new System.EventHandler(this.button1_Click);
//
// CTextBox
//
this.AutoScaleDimensions = new System.Drawing.SizeF(6F, 12F);
this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font;
this.Controls.Add(this.tableLayoutPanel1);
this.Name = "CTextBox";
this.Size = new System.Drawing.Size(250, 40);
this.tableLayoutPanel1.ResumeLayout(false);
this.tableLayoutPanel1.PerformLayout();
this.ResumeLayout(false);

}

#endregion

private System.Windows.Forms.TableLayoutPanel tableLayoutPanel1;
private System.Windows.Forms.Label label1;
private System.Windows.Forms.TextBox textBox1;
private System.Windows.Forms.Button button1;
}
}

代码就比较简单了，在此就不再详细说明了，只是其中用到了两个我自定义的方法：

General.GetPropertyInfo ---根据LINQ表达式获取属性信息；

General.GetDisplayName ---根据属性信息获取显示的名称；

方法定义代码如下(我以前的博文及个人网站www.zuowenjun.cn中也有说明)：

/// <summary>
/// 获取属性需要显示的名称
/// </summary>
/// <param name="p"></param>
/// <returns></returns>
public static string GetDisplayName(PropertyInfo p)
{
string displayName = null;
DisplayAttribute attr = p.GetAttribute<DisplayAttribute>();
if (attr != null)
{
displayName = attr.Name;
}
else
{
displayName = p.Name;
}
return displayName;
}

/// <summary>
/// 获取指定属性信息（非String类型存在装箱与拆箱）
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="select"></param>
/// <returns></returns>
public static PropertyInfo GetPropertyInfo<T>(Expression<Func<T, dynamic>> select)
{
var body = select.Body;
if (body.NodeType == ExpressionType.Convert)
{
var o = (body as UnaryExpression).Operand;
return (o as MemberExpression).Member as PropertyInfo;
}
else if (body.NodeType == ExpressionType.MemberAccess)
{
return (body as MemberExpression).Member as PropertyInfo;
}
return null;
}

如果觉得可以给个推荐吧，如果觉得有不足的地方，欢迎指出，谢谢！

另外为了方便大家学习与使用系列控件，我已将源码打包上传，大家可以点以下链接下载：

Zwj-Controls.rar