LINQ之路19:LINQ to XML之X-DOM更新、和Value属性交互

news/2024/7/5 3:33:29

本篇包含两部分内容:X-DOM更新一节中我们会详细讨论LINQ to XML的更新方式,包括Value的更新、子节点和属性的更新、通过Parent节点实现更新;

和Value属性交互一节会详细讨论XElement和XAttribute的Value属性。如果一个元素只有单个XText子节点,那么XElement的Value属性即是对该子节点的快捷方式。对于XAttribute来讲,Value就是指其属性值。X-DOM为XElement和XAttribute的Value属性提供了一致的操作方式。

X-DOM更新

Value更新

成员

目标对象

Value { get; set }

XElement, XAttribute

SetValue (object value)

XElement, XAttribute

SetValue方法把element或attribue的内容替换为给定的简单值。设置Value属性完成相同的工作,但只接受string数据。下一节“和Value交互”详细讨论了这两个成员。

调用SetValue(或设置Value属性)时值得注意的地方是:它会替换所有的子节点/child nodes

            XElement settings = new XElement("settings",
new XElement("timeout", 30)
);
settings.SetValue("XXX"); // SetValue后子节点timeout已经被替换了

Console.WriteLine(settings.ToString());
// Result: <settings>XXX</settings>

更新子节点和属性

类型

成员

目标对象

Add

Add (params object[] content)

XContainer

AddFirst (params object[] content)

XContainer

Remove

RemoveNodes()

XContainer

RemoveAttributes()

XElement

RemoveAll()

XElement

Update

ReplaceNodes (params object[] content)

XContainer

ReplaceAttributes (params object[] content)

XElement

ReplaceAll (params object[] content)

XElement

SetElementValue (XName name, object value)

XElement

SetAttributeValue (XName name, object value)

XElement

上表中最方便的方法是最后两个:SetElementValue 和SetAttributeValue。他们实例化一个XElement或XAttribute,把它加至parent,并替换掉同名的元素或属性:

            XElement settings = new XElement("settings");
settings.SetElementValue("timeout", 30); // 添加子节点
settings.SetElementValue("timeout", 60); // 更新至60

Add方法向element或document对象添加一个子节点。AddFirst完成相同的工作,但是新节点会插入到最前面。

RemoveNodes方法会删除所有的子节点;RemoveAttributes会删除所有的属性;RemoveAll等价于调用这两个方法,同时删除所有子节点和属性。

ReplaceXXX方法等价于先调用Remove再调用Add方法。他们会先行获得输入参数的一个快照(拷贝),所以settings.ReplaceNodes(settings.Nodes());也会按照我们期望的方式工作。

通过Parent节点更新

成员

目标对象

AddBeforeSelf (params object[] content)

XNode

AddAfterSelf (params object[] content)

XNode

Remove()

XNode*, XAttribute*

ReplaceWith (params object[] content)

XNode

上表中的方法AddBeforeSelf、AddAfterSelf、Remove、和ReplaceWith不是用来操作子节点(children)。相反,他们操作当前节点本身所在的集合。这就决定了节点必须有一个父元素,否则将会抛出异常。

AddBeforeSelf和AddAfterSelf根据当前节点的位置来插入一个新节点:

            XElement items = new XElement("items",
new XElement("one"),
new XElement("three")
);
items.FirstNode.AddAfterSelf(new XElement("two"));

Console.WriteLine(items.ToString(SaveOptions.DisableFormatting));
// 结果如下:
<items><one /><two /><three /></items>

像上面这样在任意位置插入一个节点是非常有效的,哪怕是在一个有很多元素的sequence中,原因在于X-DOM中的nodes在内部是以链表的形式实现的。

Remove方法在其parent元素中删除当前节点本身;ReplaceWith完成相同的工作,然后在当前位置插入其他指定的内容。示例如下:

            XElement items = XElement.Parse ("<items><one/><two/><three/></items>");
items.FirstNode.ReplaceWith (new XComment ("One was here"));

// 结果如下:
<items><!--one was here--><two /><three /></items>
删除一个节点或属性sequence

正因为有了System.Xml.Linq中定义的扩展方法,我们可以在一个节点或属性sequence上调用Remove方法,实现一次删除多个节点或属性的功能:

            // 假如我们有如下格式的XElement
XElement contacts = XElement.Parse(
@"<contacts>
<customer name='Mary'/>
<customer name='Chris' archived='true'/>
<supplier name='Susan'>
<phone archived='true'>012345678<!--confidential--></phone>
</supplier>
</contacts>
");

// 下面的查询删除所有的customers:
contacts.Elements ("customer").Remove();

// 下面的代码删除所有archived为true的元素(Chris被删除):
contacts.Elements().Where (e => (bool?) e.Attribute ("archived") == true)
.Remove();

// 如果我们使用Descendants()来替换Elements(),phone元素也会被删除,结果如下:
<contacts>
<customer name="Mary" />
<supplier name="Susan" />
</contacts>

// 下面的示例删除任意位置带有confidential注释的所有元素:
contacts.Elements().Where (e => e.DescendantNodes()
.OfType<XComment>()
.Any (c => c.Value == "confidential")
).Remove();
// 结果如下:
<contacts>
<customer name="Mary" />
<customer name="Chris" archived="true" />
</contacts>

// 与之相比,下面这个这个更简单的查询删除所有的注释元素:
contacts.DescendantNodes().OfType<XComment>().Remove();

 

和Values属性交互

XElement和XAttribute都有一个string类型的Value属性。如果一个元素只有单个XText子节点,那么XElement的Value属性即是对该子节点的快捷方式。对于XAttribute来讲,Value就是指其属性值。X-DOM为XElement和XAttribute的Value属性提供了一致的操作方式。

设置Values

有两种方式来设置一个value:调用SetValue方法或设置Value属性。SetValue更加灵活因为它不只接受string类型的参数,还可以接受其他类型数据:

            var e = new XElement("date", DateTime.Now);
e.SetValue(DateTime.Now.AddDays(1));
Console.WriteLine(e.Value); // 2011-12-05T23:20:40.296875+08:00

上面的代码不只是设置了元素的Value属性,而且还意味着手动把DateTime值转换为string值。这种转换不是简单的调用ToString完成的,而是使用XmlConvert来得到一个符合XML格式要求的结果。

当我们把一个值传给XElement或XAttribute的构造函数时,对于非string类型参数会自动进行同样的转换。这保证了DateTime值被正确格式化,另外,true会被表示成小写形式,double.NegativeInfinity被表示成“-INF”。

获取Values

我们可以简单的把XElement或XAttribute强制转换为期望的数据类型来获得它的初始值,比如:

            XElement e = new XElement("now", DateTime.Now);
DateTime dt = (DateTime)e;
XAttribute a = new XAttribute("resolution", 1.234);
double res = (double)a;

一个元素或属性并不会在内部存放 DateTime或double值,而总是转换为字符串存放起来。他们也没有任何办法记起原来的类型,所以我们必须负责把他们转换为正确的类型,否则会出现运行时错误。为了让代码更加健壮,可以在try/catch代码块中进行数据转换并捕捉FormatException异常。

可以将XElement和XAttribute强制转换为如下数据类型:

  • 所有标准数值类型
  • string, bool, DateTime, DateTimeOffset, TimeSpan, Guid
  • 上述所列值类型的可空版本(Nullable<> versions)

转换为可空类型在与Element和Attribute方法一起使用时非常有效,因为即使请求的元素/属性不存在,转换也能正常完成,比如:

            // x 下面没有timeout元素
XElement x = new XElement("now", DateTime.Now);

// 下面的代码会产生运行时错误
int timeout = (int) x.Element ("timeout");

// OK; timeout2 is null.
int? timeout2 = (int?) x.Element ("timeout");

我们可以使用??操作符来去除最终结果中的可空类型。如下所示:

            // 如果resolution属性不存在,则使用默认值1.0
double resolution = (double?) x.Attribute ("resolution") ?? 1.0;

但是,如果元素或属性存在,但是拥有一个空值,或格式不正确的值,那么即使使用可空类型,我们还是会遇到麻烦。针对这种情况,我们必须捕捉FormatException异常。

我们也可以在LINQ查询中进行转换,下面的查询返回”John”:

            var data = XElement.Parse(
@"<data>
<customer id='1' name='Mary' credit='100' />
<customer id='2' name='John' credit='150' />
<customer id='3' name='Anne' />
</data>
");
// 转换为nullable int会防止Anne中出现空引用异常,因为他没有credit属性
IEnumerable<string> query = from cust in data.Elements()
where (int?)cust.Attribute("credit") > 100
select cust.Attribute("name").Value;

另一种解决方案是在where子句中添加一个条件:

            where cust.Attributes ("credit").Any() && (int) cust.Attribute...

Values和多种类型子节点

前面说到,我们可以通过Value属性来处理元素的XText子节点。那么你也许想知道,我们还需要直接处理XText节点吗?答案是当我们有多种类型的子节点时。比如:

<summary>An XAttribute is <bold>not</bold> an XNode</summary>

一个简单的Value属性并不能完全表示summary的内容。Summary元素包含了三个子节点:XText node、XElement、另一个XText node。下面是构建该summary的代码:

            XElement summary = new XElement("summary",
new XText("An XAttribute is "),
new XElement("bold", "not"),
new XText(" an XNode")
);

有意思的是,我们还是可以查询summary的Value属性,它并不会抛出异常。但是,它会返回所有子节点的Value属性在经过连接之后形成的一个字符串值:An XAttribute is not an XNode

当然,我们也可以重新对summary的Value属性赋值,只是它会替换上面所有的子节点。

XText自动拼接

当我们在XElement中添加简单的字符串值时,X-DOM会把值拼接在已有XText子节点的后面,而不是创建新的XText子节点。下面的示例中,e1和e2都只有一个XText节点,其Value为HelloWorld:

            var e1 = new XElement("test", "Hello"); e1.Add("World");
var e2 = new XElement("test", "Hello", "World");
Console.WriteLine(e1.Nodes().Count()); // 1
Console.WriteLine(e2.Nodes().Count()); // 1

但如果我们明确指定创建XText节点,则我们会得到多个子节点:

            var e = new XElement("test", new XText("Hello"), new XText("World"));
Console.WriteLine(e.Value); // HelloWorld
Console.WriteLine(e.Nodes().Count()); // 2

 

下一篇博客中我会和大家讨论LINQ to XML中的Documents、Declarations和Namespaces。

 


系列博客导航:

LINQ之路系列博客导航

LINQ之路 1:LINQ介绍

LINQ之路 2:C# 3.0的语言功能(上)

LINQ之路 3:C# 3.0的语言功能(下)

LINQ之路 4:LINQ方法语法

LINQ之路 5:LINQ查询表达式

LINQ之路 6:延迟执行(Deferred Execution)

LINQ之路 7:子查询、创建策略和数据转换

LINQ之路 8:解释查询(Interpreted Queries)

LINQ之路 9:LINQ to SQL 和 Entity Framework(上)

LINQ之路10:LINQ to SQL 和 Entity Framework(下)

LINQ之路11:LINQ Operators之过滤(Filtering)

LINQ之路12:LINQ Operators之数据转换(Projecting)

LINQ之路13:LINQ Operators之连接(Joining)

LINQ之路14:LINQ Operators之排序和分组(Ordering and Grouping)

LINQ之路15:LINQ Operators之元素运算符、集合方法、量词方法

LINQ之路16:LINQ Operators之集合运算符、Zip操作符、转换方法、生成器方法

LINQ之路17:LINQ to XML之X-DOM介绍

LINQ之路18:LINQ to XML之导航和查询

LINQ之路19:LINQ to XML之X-DOM更新、和Value属性交互

LINQ之路20:LINQ to XML之Documents、Declarations和Namespaces

LINQ之路21:LINQ to XML之生成X-DOM(Projecting)

LINQ之路系列博客后记

 

转载于:https://www.cnblogs.com/lifepoem/archive/2011/12/09/2281577.html


http://lihuaxi.xjx100.cn/news/243534.html

相关文章

【Python基础】11、文本处理与IO深入理解

1、有一个文件&#xff0c;单词之间使用空格、分号、逗号、或者句号分隔&#xff0c;请提取全部单词。解决方案&#xff1a;使用\w匹配并提取单词&#xff0c;但是存在误判使用str.split分隔字符字符串&#xff0c;但是需要多次分隔使用re.split分隔字符串In [4]: help(re.spli…

python语言中如何使用注释

每一种计算机语言都有自己的注释方式&#xff0c;我们知道注释的作用是解释这些代码&#xff0c;方便程序员以后的检查和修改。而且注释的一部分在运行程序的过程中不起作用&#xff0c;也不会显示出来。下面我们将为大家介绍&#xff0c;在python语言中如何使用注释? 在pytho…

Servlet,过滤器,监听器,拦截器的区别

由于最近两个月工作比较清闲&#xff0c;个人也比较“上进”&#xff0c;利用工作空余时间&#xff0c;也继续学习了一下&#xff0c;某天突然想起struts2和struts1的区别的时 候&#xff0c;发现为什么struts1要用servlet&#xff0c;而struts2要用filter呢&#xff1f;一时又…

TO BUY

// book 人月神话 // hardware 乐视、凯酷一生黑 HHKB 白无刻 Filco 奶酪绿 G600 // tyon // Book 重构 改善既有代码的设计 java与模式 人月神话&#xff08;40周年中文纪念版&#xff09; MTG-G1000D-1A2 CASIO GST-S110BD-1B转载于:https://www.cnblogs.com/jinglecode/p/6…

JAVA-基础(Class对象及反射)

JAVA-基础&#xff08;Class对象及反射&#xff09; 1.&#xff08;1&#xff09;什么是class对象&#xff1f; 首先&#xff0c;java有两种对象&#xff0c;第一种是实例对象&#xff0c;第二种是Class对象&#xff0c;每一个类运行的类型信息就是用Class对象表示的&#xff0…

女生参加UI设计培训班有没有前途

在这个用户至上的时代&#xff0c;企业对于用户体验的关注度越来越高&#xff0c;很多职业都随之重视起来&#xff0c;尤其是UI设计岗位&#xff0c;很多女性都想学习UI设计&#xff0c;那么女生参加UI设计培训班有没有前途呢?我们来看看下面的详细介绍。 UI设计工作方向&…

day20 文件上传下载

2019独角兽企业重金招聘Python工程师标准>>> 文件上传基础及api解析&#xff1a; 文件上传最终版&#xff1a; 文件下载&#xff1a; 转载于:https://my.oschina.net/u/2356966/blog/648774

051 日志案例分析(PV,UV),以及动态分区

1.实现的流程 需求分析 时间&#xff1a;日&#xff0c;时段 分区表&#xff1a;两级 PV UV 数据清洗 2015-08-28 18&#xff1a;19&#xff1a;10 字段&#xff1a;id,url,guid,tracktime 数据分析 导出 2.新建源数据库 3.新建表 4.加载原始数据 5.查看部分结果 6.建立清洗数据…