XElement Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Reprezentuje element XML. Zobacz omówienie klasy XElement i sekcję Uwagi na tej stronie, aby uzyskać informacje o użyciu i przykłady.
public ref class XElement : System::Xml::Linq::XContainer, System::Xml::Serialization::IXmlSerializable
public ref class XElement : System::Xml::Linq::XContainer
public class XElement : System.Xml.Linq.XContainer, System.Xml.Serialization.IXmlSerializable
public class XElement : System.Xml.Linq.XContainer
type XElement = class
inherit XContainer
interface IXmlSerializable
type XElement = class
inherit XContainer
Public Class XElement
Inherits XContainer
Implements IXmlSerializable
Public Class XElement
Inherits XContainer
- Dziedziczenie
- Implementuje
Przykłady
Poniższy przykład tworzy drzewo XML. Zawartość nowego elementu pochodzi z zapytania LINQ.
XElement xmlTree1 = new XElement("Root",
new XElement("Child1", 1),
new XElement("Child2", 2),
new XElement("Child3", 3),
new XElement("Child4", 4),
new XElement("Child5", 5),
new XElement("Child6", 6)
);
XElement xmlTree2 = new XElement("Root",
from el in xmlTree1.Elements()
where((int)el >= 3 && (int)el <= 5)
select el
);
Console.WriteLine(xmlTree2);
Dim xmlTree1 As XElement = _
<Root>
<Child1>1</Child1>
<Child2>2</Child2>
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
<Child6>6</Child6>
</Root>
Dim xmlTree2 As XElement = _
<Root>
<%= From el In xmlTree1.Elements() _
Where el.Value >= 3 And el.Value <= 5 _
Select el %>
</Root>
Console.WriteLine(xmlTree2)
Ten przykład generuje następujące wyniki:
<Root>
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
</Root>
Poniżej przedstawiono ten sam przykład, ale w tym przypadku kod XML znajduje się w przestrzeni nazw. Aby uzyskać więcej informacji, zobacz Praca z przestrzeniami nazw XML.
XNamespace aw = "http://www.adventure-works.com";
XElement xmlTree1 = new XElement(aw + "Root",
new XElement(aw + "Child1", 1),
new XElement(aw + "Child2", 2),
new XElement(aw + "Child3", 3),
new XElement(aw + "Child4", 4),
new XElement(aw + "Child5", 5),
new XElement(aw + "Child6", 6)
);
XElement xmlTree2 = new XElement(aw + "Root",
from el in xmlTree1.Elements()
where((int)el >= 3 && (int)el <= 5)
select el
);
Console.WriteLine(xmlTree2);
Imports <xmlns="http://www.adventure-works.com">
Module Module1
Sub Main()
Dim xmlTree1 As XElement = _
<Root>
<Child1>1</Child1>
<Child2>2</Child2>
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
<Child6>6</Child6>
</Root>
Dim xmlTree2 As XElement = _
<Root>
<%= From el In xmlTree1.Elements() _
Where el.Value >= 3 And el.Value <= 5 _
Select el %>
</Root>
Console.WriteLine(xmlTree2)
End SUb
End Module
Ten przykład generuje następujące wyniki:
<Root xmlns="http://www.adventure-works.com">
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
</Root>
Uwagi
Ta klasa reprezentuje element XML, podstawową konstrukcję XML. Zobacz XElement Class Overview (Omówienie klasy XElement ), aby uzyskać inne informacje o użyciu.
Element ma XNameelement , opcjonalnie co najmniej jeden atrybut i może opcjonalnie zawierać zawartość (aby uzyskać więcej informacji, zobacz Nodes).
Element XElement może zawierać następujące typy zawartości:
Aby uzyskać szczegółowe informacje o prawidłowej zawartości elementu XElement, zobacz Prawidłowa zawartość elementów XElement i obiektów XDocument.
XElement pochodzi z XContainerelementu , który pochodzi z XNode.
Niektóre XElement metody mogą być używane z języka XAML. Aby uzyskać więcej informacji, zobacz LINQ to XML Dynamic Properties (Właściwości dynamiczne LINQ to XML).
Konstruktory
XElement(XElement) |
Inicjuje XElement nowe wystąpienie klasy z innego XElement obiektu. |
XElement(XName) |
Inicjuje XElement nowe wystąpienie klasy o określonej nazwie. |
XElement(XName, Object) |
Inicjuje XElement nowe wystąpienie klasy o określonej nazwie i zawartości. |
XElement(XName, Object[]) |
Inicjuje XElement nowe wystąpienie klasy o określonej nazwie i zawartości. |
XElement(XStreamingElement) |
Inicjuje XElement nowe wystąpienie klasy z XStreamingElement obiektu. |
Właściwości
BaseUri |
Pobiera podstawowy identyfikator URI dla tego XObjectelementu . (Odziedziczone po XObject) |
Document |
Pobiera element XDocument dla tego pliku XObject. (Odziedziczone po XObject) |
EmptySequence |
Pobiera pustą kolekcję elementów. |
FirstAttribute |
Pobiera pierwszy atrybut tego elementu. |
FirstNode |
Pobiera pierwszy węzeł podrzędny tego węzła. (Odziedziczone po XContainer) |
HasAttributes |
Pobiera wartość wskazującą, czy ten element ma co najmniej jeden atrybut. |
HasElements |
Pobiera wartość wskazującą, czy ten element ma co najmniej jeden element podrzędny. |
IsEmpty |
Pobiera wartość wskazującą, czy ten element nie zawiera zawartości. |
LastAttribute |
Pobiera ostatni atrybut tego elementu. |
LastNode |
Pobiera ostatni węzeł podrzędny tego węzła. (Odziedziczone po XContainer) |
Name |
Pobiera lub ustawia nazwę tego elementu. |
NextNode |
Pobiera następny węzeł równorzędny tego węzła. (Odziedziczone po XNode) |
NodeType |
Pobiera typ węzła dla tego węzła. |
Parent |
Pobiera element nadrzędny XElement tego XObjectelementu . (Odziedziczone po XObject) |
PreviousNode |
Pobiera poprzedni węzeł równorzędny tego węzła. (Odziedziczone po XNode) |
Value |
Pobiera lub ustawia połączoną zawartość tekstu tego elementu. |
Metody
Add(Object) |
Dodaje określoną zawartość jako elementy podrzędne tego XContainerelementu . (Odziedziczone po XContainer) |
Add(Object[]) |
Dodaje określoną zawartość jako elementy podrzędne tego XContainerelementu . (Odziedziczone po XContainer) |
AddAfterSelf(Object) |
Dodaje określoną zawartość bezpośrednio po tym węźle. (Odziedziczone po XNode) |
AddAfterSelf(Object[]) |
Dodaje określoną zawartość bezpośrednio po tym węźle. (Odziedziczone po XNode) |
AddAnnotation(Object) |
Dodaje obiekt do listy adnotacji tego XObjectelementu . (Odziedziczone po XObject) |
AddBeforeSelf(Object) |
Dodaje określoną zawartość bezpośrednio przed tym węzłem. (Odziedziczone po XNode) |
AddBeforeSelf(Object[]) |
Dodaje określoną zawartość bezpośrednio przed tym węzłem. (Odziedziczone po XNode) |
AddFirst(Object) |
Dodaje określoną zawartość jako pierwsze elementy podrzędne tego dokumentu lub elementu. (Odziedziczone po XContainer) |
AddFirst(Object[]) |
Dodaje określoną zawartość jako pierwsze elementy podrzędne tego dokumentu lub elementu. (Odziedziczone po XContainer) |
Ancestors() |
Zwraca kolekcję elementów modułu ancestor tego węzła. (Odziedziczone po XNode) |
Ancestors(XName) |
Zwraca odfiltrowaną kolekcję elementów modułu ancestor tego węzła. W kolekcji znajdują się tylko elementy, które mają dopasowanie XName . (Odziedziczone po XNode) |
AncestorsAndSelf() |
Zwraca kolekcję elementów, które zawierają ten element, oraz elementy będące elementami przodków tego elementu. |
AncestorsAndSelf(XName) |
Zwraca przefiltrowaną kolekcję elementów, które zawierają ten element, oraz elementów podrzędnych tego elementu. W kolekcji znajdują się tylko elementy, które mają dopasowanie XName . |
Annotation(Type) |
Pobiera pierwszy obiekt adnotacji określonego typu z tego XObjecttypu . (Odziedziczone po XObject) |
Annotation<T>() |
Pobiera pierwszy obiekt adnotacji określonego typu z tego XObjecttypu . (Odziedziczone po XObject) |
Annotations(Type) |
Pobiera kolekcję adnotacji określonego typu dla tego typu XObject. (Odziedziczone po XObject) |
Annotations<T>() |
Pobiera kolekcję adnotacji określonego typu dla tego typu XObject. (Odziedziczone po XObject) |
Attribute(XName) |
Zwraca wartość XAttribute , XElement która ma określony element XName. |
Attributes() |
Zwraca kolekcję atrybutów tego elementu. |
Attributes(XName) |
Zwraca filtrowaną kolekcję atrybutów tego elementu. W kolekcji są uwzględniane tylko atrybuty, które mają dopasowanie XName . |
CreateReader() |
Tworzy obiekt XmlReader dla tego węzła. (Odziedziczone po XNode) |
CreateReader(ReaderOptions) |
Tworzy element XmlReader z opcjami określonymi przez |
CreateWriter() |
Tworzy element XmlWriter , który może służyć do dodawania węzłów do elementu XContainer. (Odziedziczone po XContainer) |
DescendantNodes() |
Zwraca kolekcję węzłów podrzędnych dla tego dokumentu lub elementu w kolejności dokumentu. (Odziedziczone po XContainer) |
DescendantNodesAndSelf() |
Zwraca kolekcję węzłów, które zawierają ten element, oraz wszystkie węzły podrzędne tego elementu w kolejności dokumentu. |
Descendants() |
Zwraca kolekcję elementów podrzędnych dla tego dokumentu lub elementu w kolejności dokumentu. (Odziedziczone po XContainer) |
Descendants(XName) |
Zwraca filtrowaną kolekcję elementów podrzędnych dla tego dokumentu lub elementu w kolejności dokumentu. W kolekcji znajdują się tylko elementy, które mają dopasowanie XName . (Odziedziczone po XContainer) |
DescendantsAndSelf() |
Zwraca kolekcję elementów, które zawierają ten element, oraz wszystkie elementy podrzędne tego elementu w kolejności dokumentu. |
DescendantsAndSelf(XName) |
Zwraca filtrowaną kolekcję elementów, które zawierają ten element, oraz wszystkie elementy podrzędne tego elementu w kolejności dokumentu. W kolekcji znajdują się tylko elementy, które mają dopasowanie XName . |
Element(XName) |
Pobiera pierwszy element podrzędny (w kolejności dokumentu) z określonym XNameelementem . (Odziedziczone po XContainer) |
Elements() |
Zwraca kolekcję elementów podrzędnych tego elementu lub dokumentu w kolejności dokumentu. (Odziedziczone po XContainer) |
Elements(XName) |
Zwraca odfiltrowaną kolekcję elementów podrzędnych tego elementu lub dokumentu w kolejności dokumentu. W kolekcji znajdują się tylko elementy, które mają dopasowanie XName . (Odziedziczone po XContainer) |
ElementsAfterSelf() |
Zwraca kolekcję elementów równorzędnych po tym węźle w kolejności dokumentu. (Odziedziczone po XNode) |
ElementsAfterSelf(XName) |
Zwraca odfiltrowaną kolekcję elementów równorzędnych po tym węźle w kolejności dokumentu. W kolekcji znajdują się tylko elementy, które mają dopasowanie XName . (Odziedziczone po XNode) |
ElementsBeforeSelf() |
Zwraca kolekcję elementów równorzędnych przed tym węzłem w kolejności dokumentu. (Odziedziczone po XNode) |
ElementsBeforeSelf(XName) |
Zwraca odfiltrowaną kolekcję elementów równorzędnych przed tym węzłem w kolejności dokumentu. W kolekcji znajdują się tylko elementy, które mają dopasowanie XName . (Odziedziczone po XNode) |
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
GetDefaultNamespace() |
Pobiera wartość domyślną XNamespace tego XElementelementu . |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetNamespaceOfPrefix(String) |
Pobiera przestrzeń nazw skojarzona z określonym prefiksem dla tego XElementelementu . |
GetPrefixOfNamespace(XNamespace) |
Pobiera prefiks skojarzony z przestrzenią nazw dla tego elementu XElement. |
GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
IsAfter(XNode) |
Określa, czy bieżący węzeł pojawia się po określonym węźle w zakresie kolejności dokumentów. (Odziedziczone po XNode) |
IsBefore(XNode) |
Określa, czy bieżący węzeł pojawia się przed określonym węzłem pod względem kolejności dokumentów. (Odziedziczone po XNode) |
Load(Stream) |
Tworzy nowe XElement wystąpienie przy użyciu określonego strumienia. |
Load(Stream, LoadOptions) |
Tworzy nowe XElement wystąpienie przy użyciu określonego strumienia, opcjonalnie zachowując biały znak, ustawiając podstawowy identyfikator URI i zachowując informacje o wierszu. |
Load(String) |
Ładuje element XElement z pliku. |
Load(String, LoadOptions) |
Ładuje element XElement z pliku, opcjonalnie zachowując biały znak, ustawiając podstawowy identyfikator URI i zachowując informacje o wierszu. |
Load(TextReader) |
Ładuje element XElement z elementu TextReader. |
Load(TextReader, LoadOptions) |
Ładuje element XElement z TextReaderobiektu , opcjonalnie zachowując białe znaki i zachowując informacje o wierszu. |
Load(XmlReader) | |
Load(XmlReader, LoadOptions) |
Ładuje element XElement z XmlReaderobiektu , opcjonalnie zachowując biały znak, ustawiając podstawowy identyfikator URI i zachowując informacje o wierszu. |
LoadAsync(Stream, LoadOptions, CancellationToken) |
Asynchronicznie tworzy nowe XElement i inicjuje bazowe drzewo XML przy użyciu określonego strumienia, opcjonalnie zachowując biały znak. |
LoadAsync(TextReader, LoadOptions, CancellationToken) |
Asynchronicznie tworzy nowe XElement i inicjuje bazowe drzewo XML przy użyciu określonego czytnika tekstu, opcjonalnie zachowując biały znak. |
LoadAsync(XmlReader, LoadOptions, CancellationToken) |
Asynchronicznie tworzy nowe XElement i inicjuje bazowe drzewo XML przy użyciu określonego czytnika XML, opcjonalnie zachowując biały znak. |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
Nodes() |
Zwraca kolekcję węzłów podrzędnych tego elementu lub dokumentu w kolejności dokumentu. (Odziedziczone po XContainer) |
NodesAfterSelf() |
Zwraca kolekcję węzłów równorzędnych po tym węźle w kolejności dokumentu. (Odziedziczone po XNode) |
NodesBeforeSelf() |
Zwraca kolekcję węzłów równorzędnych przed tym węzłem w kolejności dokumentu. (Odziedziczone po XNode) |
Parse(String) |
Załaduj element XElement z ciągu zawierającego kod XML. |
Parse(String, LoadOptions) |
Załaduj element XElement z ciągu zawierającego kod XML, opcjonalnie zachowując biały znak i zachowując informacje o wierszu. |
Remove() |
Usuwa ten węzeł ze swojego węzła nadrzędnego. (Odziedziczone po XNode) |
RemoveAll() |
Usuwa węzły i atrybuty z tego XElementelementu . |
RemoveAnnotations(Type) |
Usuwa adnotacje określonego typu z tego XObjecttypu . (Odziedziczone po XObject) |
RemoveAnnotations<T>() |
Usuwa adnotacje określonego typu z tego XObjecttypu . (Odziedziczone po XObject) |
RemoveAttributes() |
Usuwa atrybuty tego XElementelementu . |
RemoveNodes() |
Usuwa węzły podrzędne z tego dokumentu lub elementu. (Odziedziczone po XContainer) |
ReplaceAll(Object) |
Zastępuje węzły podrzędne i atrybuty tego elementu określoną zawartością. |
ReplaceAll(Object[]) |
Zastępuje węzły podrzędne i atrybuty tego elementu określoną zawartością. |
ReplaceAttributes(Object) |
Zastępuje atrybuty tego elementu określoną zawartością. |
ReplaceAttributes(Object[]) |
Zastępuje atrybuty tego elementu określoną zawartością. |
ReplaceNodes(Object) |
Zamienia węzły podrzędne tego dokumentu lub elementu na określoną zawartość. (Odziedziczone po XContainer) |
ReplaceNodes(Object[]) |
Zamienia węzły podrzędne tego dokumentu lub elementu na określoną zawartość. (Odziedziczone po XContainer) |
ReplaceWith(Object) |
Zastępuje ten węzeł określoną zawartością. (Odziedziczone po XNode) |
ReplaceWith(Object[]) |
Zastępuje ten węzeł określoną zawartością. (Odziedziczone po XNode) |
Save(Stream) | |
Save(Stream, SaveOptions) |
Zwraca tę XElement wartość do określonego Streamelementu , opcjonalnie określając zachowanie formatowania. |
Save(String) |
Serializuj ten element do pliku. |
Save(String, SaveOptions) |
Serializuj ten element do pliku, opcjonalnie wyłączając formatowanie. |
Save(TextWriter) |
Serializuj ten element do elementu TextWriter. |
Save(TextWriter, SaveOptions) |
Serializuj ten element na TextWriterwartość , opcjonalnie wyłączając formatowanie. |
Save(XmlWriter) |
Serializuj ten element do elementu XmlWriter. |
SaveAsync(Stream, SaveOptions, CancellationToken) |
Asynchronicznie zwraca tę wartość XElement do elementu Stream. |
SaveAsync(TextWriter, SaveOptions, CancellationToken) |
Asynchronicznie zwraca tę wartość XElement do elementu TextWriter. |
SaveAsync(XmlWriter, CancellationToken) | |
SetAttributeValue(XName, Object) |
Ustawia wartość atrybutu, dodaje atrybut lub usuwa atrybut. |
SetElementValue(XName, Object) |
Ustawia wartość elementu podrzędnego, dodaje element podrzędny lub usuwa element podrzędny. |
SetValue(Object) |
Ustawia wartość tego elementu. |
ToString() |
Zwraca wcięty kod XML dla tego węzła. (Odziedziczone po XNode) |
ToString(SaveOptions) |
Zwraca kod XML dla tego węzła, opcjonalnie wyłączając formatowanie. (Odziedziczone po XNode) |
WriteTo(XmlWriter) |
Napisz ten element do elementu XmlWriter. |
WriteToAsync(XmlWriter, CancellationToken) |
Asynchronicznie zapisuje to XElement do określonego składnika zapisywania. |
WriteToAsync(XmlWriter, CancellationToken) |
Zapisuje bieżący węzeł w obiekcie XmlWriter. (Odziedziczone po XNode) |
Operatory
Zdarzenia
Changed |
Podniesione, gdy to XObject lub którykolwiek z jego elementów potomnych uległy zmianie. (Odziedziczone po XObject) |
Changing |
Podniesione, gdy ten XObject lub którykolwiek z jego elementów potomnych ma ulec zmianie. (Odziedziczone po XObject) |
Jawne implementacje interfejsu
IXmlLineInfo.HasLineInfo() |
Pobiera wartość wskazującą, czy ma to XObject informacje w wierszu. (Odziedziczone po XObject) |
IXmlLineInfo.LineNumber |
Pobiera numer wiersza, który jest XmlReader zgłaszany dla tego pliku XObject. (Odziedziczone po XObject) |
IXmlLineInfo.LinePosition |
Pobiera pozycję wiersza, która jest zgłaszana jako podstawowa XmlReader dla tego XObjectelementu . (Odziedziczone po XObject) |
IXmlSerializable.GetSchema() |
Pobiera definicję schematu XML, która opisuje reprezentację XML tego obiektu. |
IXmlSerializable.ReadXml(XmlReader) |
Generuje obiekt na podstawie reprezentacji XML. |
IXmlSerializable.WriteXml(XmlWriter) |
Konwertuje obiekt na reprezentację XML. |
Metody rozszerzania
GetSchemaInfo(XElement) |
Pobiera zestaw informacji po weryfikacji schematu (PSVI) zweryfikowanego elementu. |
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler) |
Ta metoda sprawdza, czy XElement drzewo podrzędne jest zgodne z określonym XmlSchemaObject i .XmlSchemaSet |
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean) |
Sprawdza, czy XElement drzewo podrzędne jest zgodne z określonym XmlSchemaObjectXmlSchemaSeti , opcjonalnie wypełnia drzewo XML przy użyciu zestawu informacji po weryfikacji schematu (PSVI). |
CreateNavigator(XNode) |
Tworzy element XPathNavigator dla elementu XNode. |
CreateNavigator(XNode, XmlNameTable) |
Tworzy element XPathNavigator dla elementu XNode. Umożliwia XmlNameTable bardziej wydajne przetwarzanie wyrażeń XPath. |
XPathEvaluate(XNode, String) |
Oblicza wyrażenie XPath. |
XPathEvaluate(XNode, String, IXmlNamespaceResolver) |
Oblicza wyrażenie XPath, rozpoznawanie prefiksów przestrzeni nazw przy użyciu określonego IXmlNamespaceResolverelementu . |
XPathSelectElement(XNode, String) |
XElement Wybiera przy użyciu wyrażenia XPath. |
XPathSelectElement(XNode, String, IXmlNamespaceResolver) |
XElement Wybiera przy użyciu wyrażenia XPath rozpoznawanie prefiksów przestrzeni nazw przy użyciu określonego IXmlNamespaceResolverelementu . |
XPathSelectElements(XNode, String) |
Wybiera kolekcję elementów przy użyciu wyrażenia XPath. |
XPathSelectElements(XNode, String, IXmlNamespaceResolver) |
Wybiera kolekcję elementów przy użyciu wyrażenia XPath, rozpoznawania prefiksów przestrzeni nazw przy użyciu określonego IXmlNamespaceResolverelementu . |
ToXPathNavigable(XNode) |
Zwraca metodę dostępu, która umożliwia nawigowanie i edytowanie określonego XNodeelementu . |