在.net应用程序中使用用户控件

郑佐 <chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="11" year="2004"><span lang="EN-US" style="FONT-SIZE: 9pt">2004-11-30</span></chsdate>

做过 asp.net 的人都知道开发的时候使用用户控件很方便，为功能模块化提供了相当大的灵活性。令人高兴的是开发 Windows 窗体也可以使用用户控件。这里我们来看看为用户控件添加属性和事件，并实现把消息发送到父容器。本文主要是为没有使用过用户控件的朋友提供一些参考。

用户控件的实现比较简单，直接从 System.Windows.Forms.UserControl 。

public class UserControl1 : System.Windows.Forms.UserControl

为了便于测试我在上面添加了一个 TextBox, 并注册 TextBox 的 TextChanged 事件，

this .textBox1.TextChanged += new System.EventHandler( this .textBox1_TextChanged);

事件处理函数，

private void textBox1_TextChanged( object sender, System.EventArgs e)

{

MessageBox.Show( this .textBox1.Text);

}

这里演示如果控件中文本框的内容改变就会用 MessageBox 显示当前的文本框内容。

控件显示如下：

<shapetype id="_x0000_t75" stroked="f" filled="f" path="m@4@5l@4@11@9@11@9@5xe" o:preferrelative="t" o:spt="75" coordsize="21600,21600"><stroke joinstyle="miter"></stroke><formulas><f eqn="if lineDrawn pixelLineWidth 0"></f><f eqn="sum @0 1 0"></f><f eqn="sum 0 0 @1"></f><f eqn="prod @2 1 2"></f><f eqn="prod @3 21600 pixelWidth"></f><f eqn="prod @3 21600 pixelHeight"></f><f eqn="sum @0 0 1"></f><f eqn="prod @6 1 2"></f><f eqn="prod @7 21600 pixelWidth"></f><f eqn="sum @8 21600 0"></f><f eqn="prod @7 21600 pixelHeight"></f><f eqn="sum @10 21600 0"></f></formulas><path o:connecttype="rect" gradientshapeok="t" o:extrusionok="f"></path><lock aspectratio="t" v:ext="edit"></lock></shapetype>

在窗体中添加上面的用户控件，当我们改变 textBox 的文本时，可以看到跳出一个对话框，很简单吧。

下面来看看对控件添加属性。

这里定义一个私有变量。

private string customValue;

添加访问他的属性

public string CustomValue

{

get { return customValue;}

set {customValue = value ;}

}

在窗体中使用的时候像普通控件一样进行访问，

userControl11.CustomValue = " 用户控件自定义数据 ";

通过事件可以传递消息到窗体上，在定义之前我们先来写一个简单的参数类。

public class TextChangeEventArgs : EventArgs

{

private string message;

public TextChangeEventArgs( string message)

{

this .message = message;

}

public string Message

{

get { return message;}

}

}

定义委托为，

public delegate void TextBoxChangedHandle( object sender,TextChangeEventArgs e);

接下去在用户控件中添加事件，

// 定义事件

public event TextBoxChangedHandle UserControlValueChanged;

为了激发用户控件的新增事件，修改了一下代码，

private void textBox1_TextChanged( object sender, System.EventArgs e)

{

if (UserControlValueChanged != null )

UserControlValueChanged( this , new TextChangeEventArgs( this .textBox1.Text));

}

好了，为了便于在 Csdn 上回答问题，把完整的代码贴了出来：

using System;

using System.Collections;

using System.ComponentModel;

using System.Drawing;

using System.Data;

using System.Windows.Forms;

namespace ZZ.WindowsApplication1

{

public class UserControl1 : System.Windows.Forms.UserControl

{

private System.Windows.Forms.TextBox textBox1;

private string customValue;

private System.ComponentModel.Container components = null ;

public string CustomValue

{

get { return customValue;}

set {customValue = value ;}

}

// 定义事件

public event TextBoxChangedHandle UserControlValueChanged;

public UserControl1()

{

InitializeComponent();

}

protected override void Dispose( bool disposing )

{

if ( disposing )

{

if (components != null )

{

components.Dispose();

}

}

base .Dispose( disposing );

}

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

private void InitializeComponent()

{

this .textBox1 = new System.Windows.Forms.TextBox();

this .SuspendLayout();

this .textBox1.Location = new System.Drawing.Point(12, 36);

this .textBox1.Name = "textBox1";

this .textBox1.TabIndex = 0;

this .textBox1.Text = "textBox1";

this .textBox1.TextChanged += new System.EventHandler( this .textBox1_TextChanged);

this .Controls.Add( this .textBox1);

this .Name = "UserControl1";

this .Size = new System.Drawing.Size(150, 92);

this .ResumeLayout( false );

}

#endregion

private void textBox1_TextChanged( object sender, System.EventArgs e)

{

if (UserControlValueChanged != null )

UserControlValueChanged( this , new TextChangeEventArgs( this .textBox1.Text));

}

}

// 定义委托

public delegate void TextBoxChangedHandle( object sender,TextChangeEventArgs e);

public class TextChangeEventArgs : EventArgs

{

private string message;

public TextChangeEventArgs( string message)

{

this .message = message;

}

public string Message

{

get { return message;}

}

}

}

使用时要在窗体中注册上面的事件，比较简单都贴源代码了，

using System;

using System.Drawing;

using System.Collections;

using System.ComponentModel;

using System.Windows.Forms;

using System.Data;

namespace ZZ.WindowsApplication1

{

public class Form1 : System.Windows.Forms.Form

{

private WindowsApplication1.UserControl1 userControl11;

private System.ComponentModel.Container components = null ;

public Form1()

{

InitializeComponent();

userControl11.CustomValue = " 用户控件自定义数据 ";

userControl11.UserControlValueChanged += new TextBoxChangedHandle(userControl11_UserControlValueChanged);

}

protected override void Dispose( bool disposing )

{

if ( disposing )

{

if (components != null )

{

components.Dispose();

}

}

base .Dispose( disposing );

}

#region Windows 窗体设计器生成的代码

private void InitializeComponent()

{

this .userControl11 = new WindowsApplication1.UserControl1();

this .SuspendLayout();

this .userControl11.Location = new System.Drawing.Point(8, 8);

this .userControl11.Name = "userControl11";

this .userControl11.Size = new System.Drawing.Size(150, 84);

this .userControl11.TabIndex = 0;

this .AutoScaleBaseSize = new System.Drawing.Size(6, 14);

this .ClientSize = new System.Drawing.Size(292, 193);

this .Controls.Add( this .userControl11);

this .Name = "Form1";

this .Text = "Form1";

this .ResumeLayout( false );

}

#endregion

[STAThread]

static void <place w:st="on">Main</place>()

{

Application.Run( new Form1());

}

private void userControl11_UserControlValueChanged( object sender, TextChangeEventArgs e)

{

MessageBox.Show(" 当前控件的值为 :" + e.Message);

}

}

}

另外需要动态加载，就把控件添加在容器的 Controls 集合就行了，下面是在构造函数中添加控件，

public Form1()

{

InitializeComponent();

UserControl1 uc = new UserControl1();

uc.CustomValue = " 动态加载的用户控件 ";

uc.UserControlValueChanged += new TextBoxChangedHandle(userControl11_UserControlValueChanged);

this .Controls.Add(uc);

}

另外从 VS.net 中的工具箱中拖动用户控件到窗体上，如果是第一次需要编译一下项目。

在.net应用程序中使用用户控件