XStreamingElement 构造函数

定义

命名空间:

System.Xml.Linq

程序集:

System.Xml.XDocument.dll

初始化 XStreamingElement 类的新实例。

重载

XStreamingElement(XName)	从指定的 XName 初始化 XElement 类的新实例。
XStreamingElement(XName, Object)	用指定的名称和内容初始化 XStreamingElement 类的新实例。
XStreamingElement(XName, Object[])	用指定的名称和内容初始化 XStreamingElement 类的新实例。

注解

在序列化 之前， XStreamingElement 不会循环访问查询。 这与对 的内容使用查询形成 XElement鲜明对比，其中查询在构造新 XElement时迭代。

有关可传递给此构造函数的有效内容的详细信息，请参阅 XElement 和 XDocument 对象的有效内容。

XStreamingElement(XName)

Source:

XStreamingElement.cs

从指定的 XName 初始化 XElement 类的新实例。

public:
 XStreamingElement(System::Xml::Linq::XName ^ name);

public XStreamingElement (System.Xml.Linq.XName name);

new System.Xml.Linq.XStreamingElement : System.Xml.Linq.XName -> System.Xml.Linq.XStreamingElement

Public Sub New (name As XName)

参数

name

XName

一个包含元素名称的 XName。

示例

XElement srcTree = new XElement("Root",
                       new XElement("Child", 1),
                       new XElement("Child", 2),
                       new XElement("Child", 3),
                       new XElement("Child", 4),
                       new XElement("Child", 5)
                   );

XStreamingElement dstTree = new XStreamingElement("NewRoot",
                        from el in srcTree.Elements()
                        where (int)el >= 3
                        select new XElement("DifferentChild", (int)el)
                    );

Console.WriteLine(dstTree);

Dim srcTree As XElement = _
        <Root>
            <Child>1</Child>
            <Child>2</Child>
            <Child>3</Child>
            <Child>4</Child>
            <Child>5</Child>
        </Root>

Dim dstTree As XStreamingElement = New XStreamingElement("NewRoot", _
                From el In srcTree.Elements _
                Where el.Value >= 3 _
                Select <DifferentChild><%= el.Value %></DifferentChild> _
            )

Console.WriteLine(dstTree)

该示例产生下面的输出：

<NewRoot>
  <DifferentChild>3</DifferentChild>
  <DifferentChild>4</DifferentChild>
  <DifferentChild>5</DifferentChild>
</NewRoot>

注解

此构造函数创建一个没有内容且没有属性的流元素。

存在从字符串到 XName的隐式转换。 此构造函数的典型用法是将字符串指定为 参数，而不是创建新的 XName。

另请参阅

• LINQ to XML 概述

XStreamingElement(XName, Object)

Source:

XStreamingElement.cs

用指定的名称和内容初始化 XStreamingElement 类的新实例。

public:
 XStreamingElement(System::Xml::Linq::XName ^ name, System::Object ^ content);

public XStreamingElement (System.Xml.Linq.XName name, object? content);

new System.Xml.Linq.XStreamingElement : System.Xml.Linq.XName * obj -> System.Xml.Linq.XStreamingElement

Public Sub New (name As XName, content As Object)

参数

name

XName

一个包含元素名称的 XName。

content

Object

元素的内容。

示例

此示例使用以下名为 Source.xml 的 XML 文件：

<?xml version="1.0" encoding="utf-8" ?>
<Root>
  <Child Key="01">
    <GrandChild>aaa</GrandChild>
  </Child>
  <Child Key="02">
    <GrandChild>bbb</GrandChild>
  </Child>
  <Child Key="03">
    <GrandChild>ccc</GrandChild>
  </Child>
</Root>

注解

此构造函数创建具有指定内容和属性的流元素。

存在从字符串到 XName的隐式转换。 此构造函数的典型用法是将字符串指定为 参数，而不是创建新的 XName。

在序列化 之前， XStreamingElement 不会循环访问查询。 这与对 的内容使用查询形成 XElement鲜明对比，其中查询在构造新 XElement时迭代。

有关可传递给此构造函数的有效内容的详细信息，请参阅 XElement 和 XDocument 对象的有效内容。

另请参阅

• LINQ to XML 概述

XStreamingElement(XName, Object[])

Source:

XStreamingElement.cs

用指定的名称和内容初始化 XStreamingElement 类的新实例。

public:
 XStreamingElement(System::Xml::Linq::XName ^ name, ... cli::array <System::Object ^> ^ content);

public XStreamingElement (System.Xml.Linq.XName name, params object?[] content);

new System.Xml.Linq.XStreamingElement : System.Xml.Linq.XName * obj[] -> System.Xml.Linq.XStreamingElement

Public Sub New (name As XName, ParamArray content As Object())

参数

name

XName

一个包含元素名称的 XName。

content

Object[]

元素的内容。

示例

此示例使用以下名为 Source.xml 的 XML 文件：

<?xml version="1.0" encoding="utf-8" ?>
<Root>
  <Child Key="01">
    <GrandChild>aaa</GrandChild>
  </Child>
  <Child Key="02">
    <GrandChild>bbb</GrandChild>
  </Child>
  <Child Key="03">
    <GrandChild>ccc</GrandChild>
  </Child>
</Root>

注解

此构造函数创建具有指定内容和属性的流元素。

存在从字符串到 XName的隐式转换。 此构造函数的典型用法是将字符串指定为 参数，而不是创建新的 XName。

在序列化 之前， XStreamingElement 不会循环访问查询。 这与对 的内容使用查询形成 XElement鲜明对比，其中查询在构造新 XElement时迭代。

有关可传递给此函数的有效内容的详细信息，请参阅 XElement 和 XDocument 对象的有效内容。

另请参阅

• LINQ to XML 概述