C# TextBox 扩展方法数据验证详细说明
查看公司项目代码时,存在这样一个问题:winform界面上有很多信息填写,提交后台服务器更新,但数据的合法验证及值的转换却不太敢恭维,一堆的if判断和转换,便想着是否能扩展个方法出来,琢磨出个思路,记录下来与大家共同探讨,有不对的地方还请大家指正。
设计思路:
1. 由于大部分从textbox控件中获取数据值,可以扩展个泛型方法出来,直接根据转换后的数据类型获得值,类似这样,
var value = this.txtsample.getvalue<int>();
2. 可以传入一个委托用来处理转换失败的操作,并重载此方法,提供一个默认的操作。
好,下面开工:
1. 创建textbox类型的扩展方法
引用msdn的解释:扩展方法使您能够向现有类型“添加”方法,而无需创建新的派生类型、重新编译或以其他方式修改原始类型。 扩展方法是一种特殊的静态方法,但可以像扩展类型上的实例方法一样进行调用。 对于用 c# 和 visual basic 编写的客户端代码,调用扩展方法与调用在类型中实际定义的方法之间没有明显的差异。
扩展方法被定义为静态方法,但它们是通过实例方法语法进行调用的。 它们的第一个参数指定该方法作用于哪个类型,并且该参数以 this 修饰符为前缀。 仅当您使用 using 指令将命名空间显式导入到源代码中之后,扩展方法才位于范围中。
注意:扩展方法是在非嵌套、非泛型静态类内部定义的
2. 由于转换类型未知,但为值类型,故采用泛型方法设计,并加上strut泛型约束,由于允许自定义处理转换失败时的操作,故传入一个action委托来实现,如下:
public static tresult getvalue<tresult>(this textbox textbox, action<textbox> failed)
where tresult : struct
{
var type = typeof(tresult);
var method = type.getmethod("tryparse", new type[] { typeof(string), type.makebyreftype() });
var parameters = new object[] { textbox.text, default(tresult) };
// 若转换失败,执行failed
if (!(bool)method.invoke(null, parameters))
{
failed(textbox);
throw new invalidcastexception("输入值格式不正确,请检查输入值。");
}
return (tresult)parameters[1];
}
这里采用反射机制来调用类型的t.tryparse(string param, out t value),例如int32.tryparse(string param,out int32 value)等,需要注意的是:
(1). getmethod()方法,必须传入合适的参数(要反射的方法的签名)来确定方法唯一,例如碰到重载这种情况(比较常见),否则返回值为null,方法的签名中,若参数带有ref 或out 关键字,则type类型需要加上.makebyreftype(),如上。
(2). 得到唯一的方法实例后,可以传入相应的参数,调用invoke方法来实现方法的调用,methodinfo.invoke(object obj, object[] parameters)方法第一个参数为反射调用该方法的对象,如果为静态方法(比如本例),可以传入null,第二个参数为方法的参数,顺序必须与方法签名一致。
(3). 方法参数中带有ref和out关键字,获得该值通过参数数组来获得。如本例中:parameters[1]
3. 定义转换失败操作的委托
c#内置封装的委托有两种,action和func委托,并有很多的重载版本,参数可以有十多个,所以不用担心参数问题。其中action委托无返回值,属于void类型,func委托具有返回值,如func<t,tresult>,在linq操作中比较常见,在该例中,无返回值的必要,故采用action委托,由于需要处理转换失败的操作,故将textbox作为该委托的参数里进行处理,如代码所示,当转换失败时进行处理:
// 若转换失败,执行failed
if (!(bool)method.invoke(null, parameters))
failed(textbox);
在此简单介绍下委托:委托其实是一个类型,通过反编译工具可以看出来,当构造委托时传入一个方法,其实会隐形的传入两个参数(target,methodptr),target参数为调用该方法的实例,若静态方法,则为null,methodptr为传入方法的内存地址(在元数据中存贮该信息),faild(textbox)表面看不太好理解,为什么一个对象后面带一个参数,其实c#编译器为我们做了很多工作,在这里实质为faild.invoke(textbox),这样看还好理解委托是个类型,通过faild的委托对象来调用该委托所注册的方法。
4. 创建重载版本:
用lambda表达式定义默认的转换失败操作,如果转换失败,则提示信息,并全部选中和定位到该输入框上。
public static tresult getvalue<tresult>(this textbox textbox, bool isshowerror)
where tresult : struct
{
return getvalue<tresult>(textbox, p =>
{
if (isshowerror)
{
p.focus();
p.selectall();
messagebox.show("输入值格式不正确,请重新输入!",
"提示--值类型:" + typeof(tresult).name,
messageboxbuttons.ok, messageboxicon.warning);
}
});
}
///默认版本,调用上个重载方法
public static tresult getvalue<tresult>(this textbox textbox)
where tresult : struct
{
return getvalue<tresult>(textbox, true);
}
5. 实验测试:
新建winform程序,界面如图所示:
后台代码:
private void btnconvert_click(object sender, eventargs e)
{
try
{
var intvalue = txtint.getvalue<int>();
var floatvalue = txtfloat.getvalue<float>();
var datetimevalue = txtdatetime.getvalue<datetime>();
var doublevalue = txtdouble.getvalue<double>();
}
catch (exception) { }
}
如果输入值非法,则提示错误,如图所示: