XElement Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
XML öğesini temsil eder. Kullanım bilgileri ve örnekler için bu sayfadaki XElement Sınıfına Genel Bakış ve Açıklamalar bölümüne bakın.
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
- Devralma
- Uygulamalar
Örnekler
Aşağıdaki örnek bir XML ağacı oluşturur. Yeni öğenin içeriği bir LINQ sorgusundan gelir.
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)
Bu örnek aşağıdaki çıkışı oluşturur:
<Root>
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
</Root>
Aşağıda aynı örnek verilmiştir, ancak bu örnekte XML bir ad alanındadır. Daha fazla bilgi için bkz. XML Ad Alanları ile çalışma.
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
Bu örnek aşağıdaki çıkışı oluşturur:
<Root xmlns="http://www.adventure-works.com">
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
</Root>
Açıklamalar
Bu sınıf, temel XML yapısı olan xml öğesini temsil eder. Diğer kullanım bilgileri için bkz . XElement Sınıfına Genel Bakış .
Bir öğenin isteğe bağlı olarak bir XNameveya daha fazla özniteliği vardır ve isteğe bağlı olarak içerik içerebilir (daha fazla bilgi için bkz Nodes. ).
aşağıdaki XElement içerik türlerini içerebilir:
bir öğesinin geçerli içeriği XElementhakkında ayrıntılı bilgi için bkz. Geçerli XElement ve XDocument Nesnelerinin İçeriği.
XElement , 'den XContainertüretilir XNode.
Bazı XElement yöntemler XAML'den kullanılabilir. Daha fazla bilgi için bkz. LINQ to XML Dinamik Özellikleri.
Oluşturucular
| Name | Description |
|---|---|
| XElement(XElement) |
Sınıfın XElement yeni bir örneğini başka bir XElement nesneden başlatır. |
| XElement(XName, Object) |
Belirtilen ad ve içerikle sınıfının yeni bir örneğini XElement başlatır. |
| XElement(XName, Object[]) |
Belirtilen ad ve içerikle sınıfının yeni bir örneğini XElement başlatır. |
| XElement(XName) |
Belirtilen adla sınıfın XElement yeni bir örneğini başlatır. |
| XElement(XStreamingElement) |
Bir nesneden sınıfının yeni bir XElement örneğini XStreamingElement başlatır. |
Özellikler
| Name | Description |
|---|---|
| BaseUri |
Bu XObjectiçin temel URI'yi alır. (Devralındığı yer: XObject) |
| Document |
bunun XDocumentiçin öğesini XObject alır. (Devralındığı yer: XObject) |
| EmptySequence |
Boş bir öğe koleksiyonu alır. |
| FirstAttribute |
Bu öğenin ilk özniteliğini alır. |
| FirstNode |
Bu düğümün ilk alt düğümünü alır. (Devralındığı yer: XContainer) |
| HasAttributes |
Bu öğenin en az bir özniteliği olup olmadığını belirten bir değer alır. |
| HasElements |
Bu öğenin en az bir alt öğesi olup olmadığını belirten bir değer alır. |
| IsEmpty |
Bu öğenin içerik içermediğini belirten bir değer alır. |
| LastAttribute |
Bu öğenin son özniteliğini alır. |
| LastNode |
Bu düğümün son alt düğümünü alır. (Devralındığı yer: XContainer) |
| Name |
Bu öğenin adını alır veya ayarlar. |
| NextNode |
Bu düğümün sonraki eşdüzey düğümünü alır. (Devralındığı yer: XNode) |
| NodeType |
Bu düğüm için düğüm türünü alır. |
| Parent |
Bu XElementöğesinin üst öğesini XObject alır. (Devralındığı yer: XObject) |
| PreviousNode |
Bu düğümün önceki eşdüzey düğümünü alır. (Devralındığı yer: XNode) |
| Value |
Bu öğenin birleştirilmiş metin içeriğini alır veya ayarlar. |
Yöntemler
| Name | Description |
|---|---|
| Add(Object) |
Belirtilen içeriği bu XContaineröğesinin alt öğeleri olarak ekler. (Devralındığı yer: XContainer) |
| Add(Object[]) |
Belirtilen içeriği bu XContaineröğesinin alt öğeleri olarak ekler. (Devralındığı yer: XContainer) |
| AddAfterSelf(Object) |
Belirtilen içeriği bu düğümden hemen sonra ekler. (Devralındığı yer: XNode) |
| AddAfterSelf(Object[]) |
Belirtilen içeriği bu düğümden hemen sonra ekler. (Devralındığı yer: XNode) |
| AddAnnotation(Object) |
Bu XObjectek açıklama listesine bir nesne ekler. (Devralındığı yer: XObject) |
| AddBeforeSelf(Object) |
Belirtilen içeriği bu düğümden hemen önce ekler. (Devralındığı yer: XNode) |
| AddBeforeSelf(Object[]) |
Belirtilen içeriği bu düğümden hemen önce ekler. (Devralındığı yer: XNode) |
| AddFirst(Object) |
Belirtilen içeriği bu belgenin veya öğenin ilk alt öğeleri olarak ekler. (Devralındığı yer: XContainer) |
| AddFirst(Object[]) |
Belirtilen içeriği bu belgenin veya öğenin ilk alt öğeleri olarak ekler. (Devralındığı yer: XContainer) |
| Ancestors() |
Bu düğümün üst öğelerinin bir koleksiyonunu döndürür. (Devralındığı yer: XNode) |
| Ancestors(XName) |
Bu düğümün üst öğelerinin filtrelenmiş koleksiyonunu döndürür. Yalnızca eşleşen XName öğeler koleksiyona dahil edilir. (Devralındığı yer: XNode) |
| AncestorsAndSelf() |
Bu öğeyi içeren bir öğe koleksiyonunu ve bu öğenin üst öğelerini döndürür. |
| AncestorsAndSelf(XName) |
Bu öğeyi ve bu öğenin üst öğelerini içeren filtrelenmiş bir öğe koleksiyonu döndürür. Yalnızca eşleşen XName öğeler koleksiyona dahil edilir. |
| Annotation(Type) |
Belirtilen türün ilk ek açıklama nesnesini bu XObjectöğesinden alır. (Devralındığı yer: XObject) |
| Annotation<T>() |
Belirtilen türün ilk ek açıklama nesnesini bu XObjectöğesinden alır. (Devralındığı yer: XObject) |
| Annotations(Type) |
Bu XObjectiçin belirtilen türde bir ek açıklama koleksiyonu alır. (Devralındığı yer: XObject) |
| Annotations<T>() |
Bu XObjectiçin belirtilen türde bir ek açıklama koleksiyonu alır. (Devralındığı yer: XObject) |
| Attribute(XName) |
XAttribute Belirtilen XNamedeğerine sahip olan öğesini XElement döndürür. |
| Attributes() |
Bu öğenin öznitelik koleksiyonunu döndürür. |
| Attributes(XName) |
Bu öğenin özniteliklerinden oluşan filtrelenmiş bir koleksiyon döndürür. Yalnızca eşleşen XName öznitelikler koleksiyona eklenir. |
| CreateReader() |
Bu düğüm için bir XmlReader oluşturur. (Devralındığı yer: XNode) |
| CreateReader(ReaderOptions) |
parametresi tarafından XmlReader belirtilen seçeneklerle bir |
| CreateWriter() |
öğesine düğüm XContainereklemek için kullanılabilecek bir XmlWriter oluşturur. (Devralındığı yer: XContainer) |
| DescendantNodes() |
Bu belge veya öğe için belge sırasına göre alt düğümlerden oluşan bir koleksiyon döndürür. (Devralındığı yer: XContainer) |
| DescendantNodesAndSelf() |
Bu öğeyi ve bu öğenin tüm alt düğümlerini içeren bir düğüm koleksiyonunu belge sırasına göre döndürür. |
| Descendants() |
Bu belge veya öğe için belge sırasına göre alt öğe koleksiyonunu döndürür. (Devralındığı yer: XContainer) |
| Descendants(XName) |
Bu belge veya öğe için, belge sırasına göre alt öğelerden oluşan filtrelenmiş bir koleksiyon döndürür. Yalnızca eşleşen XName öğeler koleksiyona dahil edilir. (Devralındığı yer: XContainer) |
| DescendantsAndSelf() |
Bu öğeyi ve bu öğenin tüm alt öğelerini içeren bir öğe koleksiyonunu belge sırasına göre döndürür. |
| DescendantsAndSelf(XName) |
Bu öğeyi ve bu öğenin tüm alt öğelerini içeren filtrelenmiş bir öğe koleksiyonunu belge sırasına göre döndürür. Yalnızca eşleşen XName öğeler koleksiyona dahil edilir. |
| Element(XName) |
Belirtilen XNameile ilk (belge sırasına göre) alt öğesini alır. (Devralındığı yer: XContainer) |
| Elements() |
Bu öğenin veya belgenin alt öğelerinin bir koleksiyonunu belge sırasına göre döndürür. (Devralındığı yer: XContainer) |
| Elements(XName) |
Bu öğenin veya belgenin alt öğelerinin filtrelenmiş koleksiyonunu belge sırasına göre döndürür. Yalnızca eşleşen XName öğeler koleksiyona dahil edilir. (Devralındığı yer: XContainer) |
| ElementsAfterSelf() |
Bu düğümden sonraki eşdüzey öğelerden oluşan bir koleksiyonu belge sırasına göre döndürür. (Devralındığı yer: XNode) |
| ElementsAfterSelf(XName) |
Bu düğümden sonraki eşdüzey öğelerin filtrelenmiş koleksiyonunu belge sırasına göre döndürür. Yalnızca eşleşen XName öğeler koleksiyona dahil edilir. (Devralındığı yer: XNode) |
| ElementsBeforeSelf() |
Bu düğümden önceki eşdüzey öğelerin bir koleksiyonunu belge sırasına göre döndürür. (Devralındığı yer: XNode) |
| ElementsBeforeSelf(XName) |
Bu düğümden önceki eşdüzey öğelerin filtrelenmiş koleksiyonunu belge sırasına göre döndürür. Yalnızca eşleşen XName öğeler koleksiyona dahil edilir. (Devralındığı yer: XNode) |
| Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
| GetDefaultNamespace() |
Bu XNamespaceöğesinin varsayılanını XElement alır. |
| GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
| GetNamespaceOfPrefix(String) |
Bu XElementiçin belirli bir ön ekle ilişkili ad alanını alır. |
| GetPrefixOfNamespace(XNamespace) |
Bu XElementiçin bir ad alanıyla ilişkilendirilmiş ön eki alır. |
| GetType() |
Geçerli örneğin Type alır. (Devralındığı yer: Object) |
| IsAfter(XNode) |
Geçerli düğümün belge sırası açısından belirtilen bir düğümden sonra görünüp görünmediğini belirler. (Devralındığı yer: XNode) |
| IsBefore(XNode) |
Geçerli düğümün belge sırası açısından belirtilen bir düğümden önce görünüp görünmediğini belirler. (Devralındığı yer: XNode) |
| Load(Stream, LoadOptions) |
Belirtilen akışı kullanarak, isteğe bağlı olarak boşluk koruyarak, temel URI'yi ayarlayarak ve satır bilgilerini koruyarak yeni XElement bir örnek oluşturur. |
| Load(Stream) |
Belirtilen akışı kullanarak yeni XElement bir örnek oluşturur. |
| Load(String, LoadOptions) |
İsteğe bağlı olarak boşluk koruyarak, temel URI'yi ayarlayarak ve satır bilgilerini koruyarak dosyadan bir XElement yükler. |
| Load(String) |
Dosyadan bir XElement yükler. |
| Load(TextReader, LoadOptions) |
' den TextReaderbir XElement yükler. İsteğe bağlı olarak boşlukları korur ve satır bilgilerini korur. |
| Load(TextReader) |
'den bir XElementTextReaderyükler. |
| Load(XmlReader, LoadOptions) |
' den XmlReaderbir XElement yükler. İsteğe bağlı olarak boşluk korur, temel URI'yi ayarlar ve satır bilgilerini korur. |
| Load(XmlReader) | |
| LoadAsync(Stream, LoadOptions, CancellationToken) |
Zaman uyumsuz olarak yeni XElement bir oluşturur ve belirtilen akışı kullanarak temel alınan XML ağacını başlatır ve isteğe bağlı olarak boşluk korur. |
| LoadAsync(TextReader, LoadOptions, CancellationToken) |
Zaman uyumsuz olarak yeni XElement bir oluşturur ve belirtilen metin okuyucuyu kullanarak temel alınan XML ağacını başlatır ve isteğe bağlı olarak boşluğu korur. |
| LoadAsync(XmlReader, LoadOptions, CancellationToken) |
Zaman uyumsuz olarak yeni XElement bir oluşturur ve belirtilen XML okuyucusunu kullanarak temel xml ağacını başlatır ve isteğe bağlı olarak boşluk korur. |
| MemberwiseClone() |
Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object) |
| Nodes() |
Bu öğenin veya belgenin alt düğümlerinin bir koleksiyonunu belge sırasına göre döndürür. (Devralındığı yer: XContainer) |
| NodesAfterSelf() |
Bu düğümden sonraki eşdüzey düğümlerden oluşan bir koleksiyonu belge sırasına göre döndürür. (Devralındığı yer: XNode) |
| NodesBeforeSelf() |
Bu düğümden önceki eşdüzey düğümlerin bir koleksiyonunu belge sırasına göre döndürür. (Devralındığı yer: XNode) |
| Parse(String, LoadOptions) |
XElement XML içeren bir dizeden, isteğe bağlı olarak boşluğu koruyarak ve satır bilgilerini koruyarak bir dizeden yükleyin. |
| Parse(String) |
XElement XML içeren bir dizeden bir yükleyin. |
| Remove() |
Bu düğümü üst öğesinden kaldırır. (Devralındığı yer: XNode) |
| RemoveAll() |
Bu XElementöğeden düğümleri ve öznitelikleri kaldırır. |
| RemoveAnnotations(Type) |
Belirtilen türün ek açıklamalarını bu XObjectiçinden kaldırır. (Devralındığı yer: XObject) |
| RemoveAnnotations<T>() |
Belirtilen türün ek açıklamalarını bu XObjectiçinden kaldırır. (Devralındığı yer: XObject) |
| RemoveAttributes() |
Bu XElementöğesinin özniteliklerini kaldırır. |
| RemoveNodes() |
Bu belgeden veya öğeden alt düğümleri kaldırır. (Devralındığı yer: XContainer) |
| ReplaceAll(Object) |
Alt düğümleri ve bu öğenin özniteliklerini belirtilen içerikle değiştirir. |
| ReplaceAll(Object[]) |
Alt düğümleri ve bu öğenin özniteliklerini belirtilen içerikle değiştirir. |
| ReplaceAttributes(Object) |
Bu öğenin özniteliklerini belirtilen içerikle değiştirir. |
| ReplaceAttributes(Object[]) |
Bu öğenin özniteliklerini belirtilen içerikle değiştirir. |
| ReplaceNodes(Object) |
Bu belgenin veya öğenin alt düğümlerini belirtilen içerikle değiştirir. (Devralındığı yer: XContainer) |
| ReplaceNodes(Object[]) |
Bu belgenin veya öğenin alt düğümlerini belirtilen içerikle değiştirir. (Devralındığı yer: XContainer) |
| ReplaceWith(Object) |
Bu düğümü belirtilen içerikle değiştirir. (Devralındığı yer: XNode) |
| ReplaceWith(Object[]) |
Bu düğümü belirtilen içerikle değiştirir. (Devralındığı yer: XNode) |
| Save(Stream, SaveOptions) |
Bunu XElement , isteğe bağlı olarak biçimlendirme davranışını belirterek belirtilen Streamöğesine aktarır. |
| Save(Stream) | |
| Save(String, SaveOptions) |
Bu öğeyi bir dosyaya seri hale getirerek isteğe bağlı olarak biçimlendirmeyi devre dışı bırak. |
| Save(String) |
Bu öğeyi bir dosyaya seri hale getirme. |
| Save(TextWriter, SaveOptions) |
Bu öğeyi bir TextWriterolarak seri hale getirerek isteğe bağlı olarak biçimlendirmeyi devre dışı bırak. |
| Save(TextWriter) |
Bu öğeyi bir TextWriterolarak serileştirin. |
| Save(XmlWriter) |
Bu öğeyi bir XmlWriterolarak serileştirin. |
| SaveAsync(Stream, SaveOptions, CancellationToken) |
Bunu XElement zaman uyumsuz olarak bir Streamöğesine aktarır. |
| SaveAsync(TextWriter, SaveOptions, CancellationToken) |
Bunu XElement zaman uyumsuz olarak bir TextWriteröğesine aktarır. |
| SaveAsync(XmlWriter, CancellationToken) |
Bunu XElement zaman uyumsuz olarak bir XmlWriteröğesine aktarır. |
| SetAttributeValue(XName, Object) |
Özniteliğin değerini ayarlar, öznitelik ekler veya özniteliği kaldırır. |
| SetElementValue(XName, Object) |
Bir alt öğenin değerini ayarlar, bir alt öğe ekler veya bir alt öğeyi kaldırır. |
| SetValue(Object) |
Bu öğenin değerini ayarlar. |
| ToString() |
Bu düğüm için girintili XML'yi döndürür. (Devralındığı yer: XNode) |
| ToString(SaveOptions) |
İsteğe bağlı olarak biçimlendirmeyi devre dışı bırakarak bu düğüm için XML döndürür. (Devralındığı yer: XNode) |
| WriteTo(XmlWriter) |
Bu öğeyi bir XmlWriteröğesine yazın. |
| WriteToAsync(XmlWriter, CancellationToken) |
Bunu XElement belirtilen yazıcıya zaman uyumsuz olarak yazar. |
İşleçler
Ekinlikler
| Name | Description |
|---|---|
| Changed |
Bu XObject veya alt öğelerinden herhangi biri değiştiğinde yükseltildi. (Devralındığı yer: XObject) |
| Changing |
Bu XObject veya alt öğelerinden herhangi biri değişmek üzereyken yükseltilir. (Devralındığı yer: XObject) |
Belirtik Arabirim Kullanımları
| Name | Description |
|---|---|
| IXmlLineInfo.HasLineInfo() |
Bunun XObject satır bilgilerine sahip olup olmadığını belirten bir değer alır. (Devralındığı yer: XObject) |
| IXmlLineInfo.LineNumber |
Temel XmlReader alınanın bu XObjectiçin bildirdiği satır numarasını alır. (Devralındığı yer: XObject) |
| IXmlLineInfo.LinePosition |
Temel XmlReader alınanın bu XObjectiçin bildirdiği satır konumunu alır. (Devralındığı yer: XObject) |
| IXmlSerializable.GetSchema() |
Bu nesnenin XML gösterimini açıklayan bir XML şema tanımı alır. |
| IXmlSerializable.ReadXml(XmlReader) |
XML gösteriminden bir nesne oluşturur. |
| IXmlSerializable.WriteXml(XmlWriter) |
Nesneyi XML gösterimine dönüştürür. |
Uzantı Metotları
| Name | Description |
|---|---|
| CreateNavigator(XNode, XmlNameTable) |
için bir XPathNavigatorXNodeoluşturur. , XmlNameTable daha verimli XPath ifade işlemeyi etkinleştirir. |
| CreateNavigator(XNode) |
için bir XPathNavigatorXNodeoluşturur. |
| GetSchemaInfo(XElement) |
Doğrulanmış bir öğenin şema doğrulama sonrası bilgi kümesini (PSVI) alır. |
| ToXPathNavigable(XNode) |
Belirtilen XNodeiçinde gezinmenizi ve düzenlemenizi sağlayan bir erişimci döndürür. |
| Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean) |
Bir XElement alt ağacın belirtilen XmlSchemaObject ve ile uyumlu olduğunu doğrular ve XmlSchemaSetisteğe bağlı olarak XML ağacını şema sonrası doğrulama bilgi kümesi (PSVI) ile doldurur. |
| Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler) |
Bu yöntem, bir XElement alt ağacın belirtilen XmlSchemaObject ve XmlSchemaSetile uyumlu olduğunu doğrular. |
| XPathEvaluate(XNode, String, IXmlNamespaceResolver) |
Belirtilen IXmlNamespaceResolverkullanarak ad alanı ön eklerini çözümleyerek bir XPath ifadesini değerlendirir. |
| XPathEvaluate(XNode, String) |
XPath ifadesini değerlendirir. |
| XPathSelectElement(XNode, String, IXmlNamespaceResolver) |
Belirtilen XElementkullanarak ad alanı ön eklerini çözümleyerek bir XPath ifadesi kullanarak bir IXmlNamespaceResolver seçer. |
| XPathSelectElement(XNode, String) |
Bir XPath ifadesi kullanarak bir XElement seçer. |
| XPathSelectElements(XNode, String, IXmlNamespaceResolver) |
Belirtilen IXmlNamespaceResolverkullanarak ad alanı ön eklerini çözümleyerek bir XPath ifadesi kullanarak bir öğe koleksiyonu seçer. |
| XPathSelectElements(XNode, String) |
XPath ifadesi kullanarak bir öğe koleksiyonu seçer. |
Şunlara uygulanır
Ayrıca bkz.
- LINQ to XML'e genel bakış
- LINQ to XML Dinamik Özellikleri