XElement Klasa

Definicja

Przestrzeń nazw:

System.Xml.Linq

Zestaw:

System.Xml.XDocument.dll

Źródło:

XElement.cs

Reprezentuje element XML. Zobacz omówienie klasy XElement i sekcję Uwagi na tej stronie, aby uzyskać informacje o użyciu i przykłady.

C#

public class XElement : System.Xml.Linq.XContainer, System.Xml.Serialization.IXmlSerializable

Dziedziczenie

Object

XObject

XNode

XContainer

XElement

Implementuje

IXmlSerializable

Przykłady

Poniższy przykład tworzy drzewo XML. Zawartość nowego elementu pochodzi z zapytania LINQ.

C#

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

Ten przykład generuje następujące wyniki:

XML

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

C#

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

Ten przykład generuje następujące wyniki:

XML

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

• XElement

• XComment

• XProcessingInstruction

• XText

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 readerOptions parametr . (Odziedziczone po XNode)
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)	Ładuje element XElement z elementu 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)	Zwraca tę wartość XElement do określonego Streamelementu .
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)	Asynchronicznie zwraca to XElement do elementu XmlWriter.
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.

Operatory

Explicit(XElement to Boolean)	Rzutuj wartość tej XElement wartości na wartość Boolean.
Explicit(XElement to DateTime)	Rzutuj wartość tej XElement wartości na wartość DateTime.
Explicit(XElement to DateTimeOffset)	Rzutuj wartość tej XAttribute wartości na wartość DateTimeOffset.
Explicit(XElement to Decimal)	Rzutuj wartość tej XElement wartości na wartość Decimal.
Explicit(XElement to Double)	Rzutuj wartość tej XElement wartości na wartość Double.
Explicit(XElement to Guid)	Rzutuj wartość tej XElement wartości na wartość Guid.
Explicit(XElement to Int32)	Rzutuj wartość tej XElement wartości na wartość Int32.
Explicit(XElement to Int64)	Rzutuj wartość tej XElement wartości na wartość Int64.
Explicit(XElement to Nullable<Boolean>)	Rzutuj wartość tej XElement wartości na wartość typu Nullable<T>Boolean.
Explicit(XElement to Nullable<DateTime>)	Rzutuj wartość tej XElement wartości na wartość typu Nullable<T>DateTime.
Explicit(XElement to Nullable<DateTimeOffset>)	Rzutuj wartość tej XElement wartości na wartość typu Nullable<T>DateTimeOffset.
Explicit(XElement to Nullable<Decimal>)	Rzutuj wartość tej XElement wartości na wartość typu Nullable<T>Decimal.
Explicit(XElement to Nullable<Double>)	Rzutuj wartość tej XElement wartości na wartość typu Nullable<T>Double.
Explicit(XElement to Nullable<Guid>)	Rzutuj wartość tej XElement wartości na wartość typu Nullable<T>Guid.
Explicit(XElement to Nullable<Int32>)	Rzutuj wartość tej XElement wartości na wartość typu Nullable<T>Int32.
Explicit(XElement to Nullable<Int64>)	Rzutuj wartość tej XElement wartości na wartość typu Nullable<T>Int64.
Explicit(XElement to Nullable<Single>)	Rzutuj wartość tej XElement wartości na wartość typu Nullable<T>Single.
Explicit(XElement to Nullable<TimeSpan>)	Rzutuj wartość tej XElement wartości na wartość typu Nullable<T>TimeSpan.
Explicit(XElement to Nullable<UInt32>)	Rzutuj wartość tej XElement wartości na wartość typu Nullable<T>UInt32.
Explicit(XElement to Nullable<UInt64>)	Rzutuj wartość tej XElement wartości na wartość typu Nullable<T>UInt64.
Explicit(XElement to Single)	Rzutuj wartość tej XElement wartości na wartość Single.
Explicit(XElement to String)	Rzutuj wartość tej XElement wartości na wartość String.
Explicit(XElement to TimeSpan)	Rzutuj wartość tej XElement wartości na wartość TimeSpan.
Explicit(XElement to UInt32)	Rzutuj wartość tej XElement wartości na wartość UInt32.
Explicit(XElement to UInt64)	Rzutuj wartość tej XElement wartości na wartość UInt64.

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 .

Dotyczy

Zobacz też

• LINQ to XML — przegląd
• Właściwości dynamiczne LINQ to XML