XStreamingElement Konstruktoren

Definition

Namespace:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Initialisiert eine neue Instanz der XStreamingElement-Klasse.

Überlädt

XStreamingElement(XName)	Initialisiert eine neue Instanz der XElement-Klasse aus dem angegebenen XName.
XStreamingElement(XName, Object)	Initialisiert eine neue Instanz der XStreamingElement-Klasse mit dem angegebenen Namen und Inhalt.
XStreamingElement(XName, Object[])	Initialisiert eine neue Instanz der XStreamingElement-Klasse mit dem angegebenen Namen und Inhalt.

Hinweise

Abfragen werden erst durchlaufen, wenn das XStreamingElement serialisiert ist. Dies steht im Gegensatz zur Verwendung von Abfragen für Inhalte für ein XElement, bei dem Abfragen zum Zeitpunkt der Erstellung des neuen XElementdurchlaufen werden.

Ausführliche Informationen zu den gültigen Inhalten, die an diesen Konstruktor übergeben werden können, finden Sie unter Gültiger Inhalt von XElement- und XDocument-Objekten.

XStreamingElement(XName)

Source:

XStreamingElement.cs

Initialisiert eine neue Instanz der XElement-Klasse aus dem angegebenen XName.

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)

Parameter

name

XName

Ein XName, der den Namen des Elements enthält.

Beispiele

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)

Dieses Beispiel erzeugt die folgende Ausgabe:

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

Hinweise

Dieser Konstruktor erstellt ein Streamingelement ohne Inhalt und ohne Attribute.

Es gibt eine implizite Konvertierung von Zeichenfolge in XName. Die typische Verwendung dieses Konstruktors besteht darin, eine Zeichenfolge als Parameter anzugeben, anstatt einen neuen XNamezu erstellen.

Weitere Informationen

• Übersicht über LINQ to XML

XStreamingElement(XName, Object)

Source:

XStreamingElement.cs

Initialisiert eine neue Instanz der XStreamingElement-Klasse mit dem angegebenen Namen und Inhalt.

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)

Parameter

name

XName

Ein XName, der den Elementnamen enthält.

content

Object

Der Inhalt des Elements.

Beispiele

In diesem Beispiel wird die folgende XML-Datei mit dem Namen Source.xml verwendet:

<?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>

Hinweise

Dieser Konstruktor erstellt ein Streamingelement mit den angegebenen Inhalten und Attributen.

Es gibt eine implizite Konvertierung von Zeichenfolge in XName. Die typische Verwendung dieses Konstruktors besteht darin, eine Zeichenfolge als Parameter anzugeben, anstatt einen neuen XNamezu erstellen.

Abfragen werden erst durchlaufen, wenn das XStreamingElement serialisiert ist. Dies steht im Gegensatz zur Verwendung von Abfragen für Inhalte für ein XElement, bei dem Abfragen zum Zeitpunkt der Erstellung des neuen XElementdurchlaufen werden.

Ausführliche Informationen zu den gültigen Inhalten, die an diesen Konstruktor übergeben werden können, finden Sie unter Gültiger Inhalt von XElement- und XDocument-Objekten.

Weitere Informationen

• Übersicht über LINQ to XML

XStreamingElement(XName, Object[])

Source:

XStreamingElement.cs

Initialisiert eine neue Instanz der XStreamingElement-Klasse mit dem angegebenen Namen und Inhalt.

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())

Parameter

name

XName

Ein XName, der den Elementnamen enthält.

content

Object[]

Der Inhalt des Elements.

Beispiele

In diesem Beispiel wird die folgende XML-Datei mit dem Namen Source.xml verwendet:

<?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>

Hinweise

Dieser Konstruktor erstellt ein Streamingelement mit den angegebenen Inhalten und Attributen.

Es gibt eine implizite Konvertierung von Zeichenfolge in XName. Die typische Verwendung dieses Konstruktors besteht darin, eine Zeichenfolge als Parameter anzugeben, anstatt einen neuen XNamezu erstellen.

Abfragen werden erst durchlaufen, wenn das XStreamingElement serialisiert ist. Dies steht im Gegensatz zur Verwendung von Abfragen für Inhalte für ein XElement, bei dem Abfragen zum Zeitpunkt der Erstellung des neuen XElementdurchlaufen werden.

Ausführliche Informationen zu den gültigen Inhalten, die an diese Funktion übergeben werden können, finden Sie unter Gültiger Inhalt von XElement- und XDocument-Objekten.

Weitere Informationen

• Übersicht über LINQ to XML