【Github源码】
《上一篇》 介绍了Xmtool工具库中的图形验证码类库,今天我们继续为大家介绍其中的扩展动态对象类库。
扩展动态对象是整个工具库中最重要的一个设计。在软件开发过程中,我们经常需要定义各种各样的数据对象;例如:用于参数传递的数据实体类、用于接口返回结果的Json对象等等。
// 人员数据实体定义
public class Person
{
public string Name { get; set; } = null;
public int Age { get; set; } = 0;
}
当我们遇到的场景越多、越复杂,我们需要定义和维护的这种类也会更多;这无疑是一种负担,且这个过程相当枯燥和乏味。在编译型编程语言Javascript中,变量是没有强制指定类型的,用户使用时可以随意赋值;这让开发人员在使用过程中会非常灵活且方便;参考这种特性,并基于系统DynamicMetaObject对象,我们封装了DynamicObjectExt对象,我们称之为扩展动态对象,它实现了无需定义直接赋值的形式使用数据对象,像Javascript中一样简单和灵活,帮我们简化了大量的定义过程。
// 直接创建对象,并根据实际数据对象结构进行赋值即可
dynamic person = Xmtool.DynamicObject();
person.Name = "softwaiter";
person.Age = 18;
// TODO
除了这种基本能力之外,扩展对象中还提供了丰富的方法,用于对动态对象进行更多的判断和控制,使之能够满足各种各样的应用场景。
this属性
TrySetValue方法
TryGetValue方法
GetValue方法
GetValueByPath方法
SetValue方法
SetValueByPath方法
Has方法
HasPath方法
Remove方法
RemovePath方法
ToString方法
ToXMLString方法
1. this属性
说明:根据指定属性名称获取属性值。
dynamic person = Xmtool.DynamicObject();
person.Name = "softwaiter";
person.Age = 18;
Console.WriteLine(pernson["Name"]); // 打印Name属性值,输出softwaiter
2. TrySetValue方法
public bool TrySetValue(string name, object value)
说明:尝试为指定name的属性赋值,赋值成功返回true;否则返回false。
参数:
name:准备赋值的属性名称。
value:属性赋值内容。
3. TryGetValue方法
public bool TryGetValue(string name, out object result)
说明:尝试从指定name的属性获取值,获取成功返回true;否则返回false。
参数:
name:准备取值的属性名称。
result:获取到的属性值;为获取到将返回null。
4. GetValue方法
public object GetValue(string name)
说明:返回指定name的属性值;不存在找到则返回null。
参数:
name:属性名称。
5. GetValueByPath方法
public object GetValueByPath(string path)
说明:GetValue方法的扩展,GetValueByPath能获取多层级属性的值。
参数:
path:多层级属性路径,中间用“.”连接。文章来源:https://www.toymoban.com/news/detail-710444.html
dynamic person = Xmtool.DynamicObject();
person.Name = "softwaiter";
person.Age = 18;
person.Pet = Xmtool.DynamicObject();
person.Pet.Name = "Tom";
person.Pet.Kind = "Cat";
Console.WriteLine(pernson.GetValueByPath("Pet.Name")); // 打印宠物名称,输出Tom
6. SetValue方法
public object SetValue(string name, object value)
说明:为指定name的属性设置值。
参数:
name:准备设置值得属性名称。
value:属性值内容。
7. SetValueByPath方法
public bool SetValueByPath(string path, object value)
说明:SetValue方法的扩展,SetValueByPath能设置多层级属性的值。
参数:
path:多层级属性路径,中间用“.”连接。
value:属性值内容。
dynamic person = Xmtool.DynamicObject();
person.Name = "softwaiter";
person.Age = 18;
person.Pet = Xmtool.DynamicObject();
person.Pet.Name = "Tom";
person.Pet.Kind = "Cat";
person.SetValueByPath("Pet.Name", "Chika");
Console.WriteLine(pernson.GetValueByPath("Pet.Name")); // 打印宠物名称,输出Chika
8. Has方法
public bool Has(string key)
说明:判断是否包含指定属性。
参数:
key:属性名称。
9. HasPath方法
public bool HasPath(string path)
说明:Has方法的扩展,HasPath能判断多层级属性是否存在。
参数:
path:多层级属性路径,中间用“.”连接。
dynamic person = Xmtool.DynamicObject();
person.Name = "softwaiter";
person.Age = 18;
person.Pet = Xmtool.DynamicObject();
person.Pet.Name = "Tom";
person.Pet.Kind = "Cat";
if (person.HasPath("Pet.Name"))
{
// TODO
}
10. Remove方法
public bool Remove(string key)
说明:从对象上删除指定的属性。
参数:
key:属性名称。
11. RemovePath方法
public bool RemovePath(string path)
说明:Remove方法的扩展,RemovePath能删除多层级属性。
参数:
path:多层级属性路径,中间用“.”连接。
dynamic person = Xmtool.DynamicObject();
person.Name = "softwaiter";
person.Age = 18;
person.Pet = Xmtool.DynamicObject();
person.Pet.Name = "Tom";
person.Pet.Kind = "Cat";
person.RemovePath("Pet.Kind");
if (person.HasPath("Pet.Kind")) // 将返回false
{
// TODO
}
12. ToString方法
public override string ToString()
说明:将对象序列化为JSON字符串并返回;常用于API接口结果返回。
dynamic person = Xmtool.DynamicObject();
person.Name = "softwaiter";
person.Age = 18;
string json = person.ToString();
Console.WriteLine(json); // 输出{"Name":"softwaiter","Age":18}
13. ToXMLString方法
public string ToXMLString(string defaultNS = "")
说明:将对象序列化为XML字符串并返回。
参数:
defaultNS:默认命名空间。文章来源地址https://www.toymoban.com/news/detail-710444.html
dynamic person = Xmtool.DynamicObject();
person.Name = "softwaiter";
person.Age = 18;
string xml = person.ToXMLString();
Console.WriteLine(xml); //输出<xml><Name>softwaiter</Name><Age>18</Age></xml>
string xml2 = person.ToXMLString("http://www.xmltool.com");
Console.WriteLine(xml2); //输出<xml xmlns="http://www.xmltool.com"><Name>softwaiter</Name><Age>18</Age></xml>
【Github源码】
到了这里,关于开源.NetCore通用工具库Xmtool使用连载 - 扩展动态对象篇的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!