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 bir 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üretilen 'den XNodetüretilir.
Bazı XElement yöntemler XAML'den kullanılabilir. Daha fazla bilgi için bkz. LINQ to XML Dinamik Özellikleri.
Oluşturucular
XElement(XElement) |
Sınıfın XElement yeni bir örneğini başka bir XElement nesneden başlatır. |
XElement(XName) |
Belirtilen adla 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, Object[]) |
Belirtilen ad ve içerikle sınıfının yeni bir örneğini XElement başlatır. |
XElement(XStreamingElement) |
Bir nesneden sınıfının yeni bir XStreamingElement örneğini XElement başlatır. |
Özellikler
BaseUri |
Bu XObjectiçin temel URI'yi alır. (Devralındığı yer: XObject) |
Document |
Bunun XObjectiçin öğesini XDocument 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 bir sonraki eşdüzey düğümünü alır. (Devralındığı yer: XNode) |
NodeType |
Bu düğümün düğüm türünü alır. |
Parent |
Bu XObjectöğesinin üst XElement öğesini 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
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 XObjectöğesinin ek 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ş bir koleksiyonunu döndürür. Yalnızca eşleştirmesi XName olan öğeler koleksiyona dahil edilir. (Devralındığı yer: XNode) |
AncestorsAndSelf() |
Bu öğeyi içeren öğelerin bir koleksiyonunu ve bu öğenin üst öğelerini döndürür. |
AncestorsAndSelf(XName) |
Bu öğeyi ve bu öğenin üst öğelerini içeren filtrelenmiş bir öğe koleksiyonunu döndürür. Yalnızca eşleştirmesi XName olan öğ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ürdeki ek açıklamaların koleksiyonunu alır. (Devralındığı yer: XObject) |
Annotations<T>() |
Bu XObjectiçin belirtilen türdeki ek açıklamaların koleksiyonunu 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 dahil edilir. |
CreateReader() |
Bu düğüm için bir XmlReader oluşturur. (Devralındığı yer: XNode) |
CreateReader(ReaderOptions) |
parametresi tarafından |
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 içeren düğümlerden oluşan bir koleksiyon ve bu öğenin tüm alt düğümlerini 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ştirmesi XName olan öğeler koleksiyona dahil edilir. (Devralındığı yer: XContainer) |
DescendantsAndSelf() |
Bu öğeyi içeren bir öğe koleksiyonunu ve bu öğenin tüm alt öğelerini belge sırasına göre döndürür. |
DescendantsAndSelf(XName) |
Bu öğeyi içeren ve bu öğenin tüm alt öğelerini belge sırasına göre filtrelenmiş bir öğe koleksiyonunu döndürür. Yalnızca eşleştirmesi XName olan öğeler koleksiyona dahil edilir. |
Element(XName) |
Belirtilen XNameöğesine sahip 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ştirmesi XName olan öğeler koleksiyona dahil edilir. (Devralındığı yer: XContainer) |
ElementsAfterSelf() |
Bu düğümden sonraki eşdüzey öğelerin bir koleksiyonunu 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ştirmesi XName olan öğ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ş bir koleksiyonunu belge sırasına göre döndürür. Yalnızca eşleştirmesi XName olan öğ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 XElementöğesinin varsayılanını XNamespace 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şkili ön eki alır. |
GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
IsAfter(XNode) |
Geçerli düğümün belirtilen bir düğümden sonra belge sırası açısından görüntülenip görüntülenmediğ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) |
Belirtilen akışı kullanarak yeni XElement bir örnek oluşturur. |
Load(Stream, LoadOptions) |
Belirtilen akışı kullanarak, isteğe bağlı olarak boşluğu koruyarak, temel URI'yi ayarlayarak ve satır bilgilerini koruyarak yeni XElement bir örnek oluşturur. |
Load(String) |
Dosyadan bir XElement yükler. |
Load(String, LoadOptions) |
İsteğe bağlı olarak boşluğu koruyarak, temel URI'yi ayarlayarak ve satır bilgilerini koruyarak dosyadan bir XElement yükler. |
Load(TextReader) |
bir 'den yükler XElementTextReader. |
Load(TextReader, LoadOptions) |
bir 'den TextReaderbir XElement yükler, isteğe bağlı olarak boşluğu korur ve satır bilgilerini korur. |
Load(XmlReader) | |
Load(XmlReader, LoadOptions) |
bir 'den XmlReaderyüklerXElement, isteğe bağlı olarak boşluğu korur, temel URI'yi ayarlar ve satır bilgilerini korur. |
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şluğu 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 okuyucuyu kullanarak temel alınan XML ağacını başlatır ve isteğe bağlı olarak boşluğu korur. |
MemberwiseClone() |
Geçerli Objectöğesinin sığ 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üğümlerin bir koleksiyonunu 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) |
XML içeren bir dizeden bir XElement yükleyin. |
Parse(String, LoadOptions) |
XML içeren bir dizeden, isteğe bağlı olarak boşluğu koruyarak ve satır bilgilerini koruyarak bir XElement 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) | |
Save(Stream, SaveOptions) |
Bunu XElement , isteğe bağlı olarak biçimlendirme davranışını belirterek belirtilen Streamöğesine aktarır. |
Save(String) |
Bu öğeyi bir dosyaya serileştirin. |
Save(String, SaveOptions) |
Bu öğeyi bir dosyaya seri hale getirerek isteğe bağlı olarak biçimlendirmeyi devre dışı bırak. |
Save(TextWriter) |
Bu öğeyi bir TextWriterolarak serileştirin. |
Save(TextWriter, SaveOptions) |
Bu öğeyi olarak TextWriterseri hale getirerek isteğe bağlı olarak biçimlendirmeyi devre dışı bırak. |
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 bir ö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. |
WriteToAsync(XmlWriter, CancellationToken) |
Geçerli düğümü bir XmlWriteröğesine yazar. (Devralındığı yer: XNode) |
İşleçler
Ekinlikler
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ı
IXmlLineInfo.HasLineInfo() |
Bunun XObject satır bilgilerine sahip olup olmadığını belirten bir değer alır. (Devralındığı yer: XObject) |
IXmlLineInfo.LineNumber |
Temel alınanın XmlReader bu XObjectiçin bildirdiği satır numarasını alır. (Devralındığı yer: XObject) |
IXmlLineInfo.LinePosition |
Temel alınanın XmlReader 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ı
GetSchemaInfo(XElement) |
Doğrulanmış bir öğenin şema doğrulama sonrası bilgi kümesini (PSVI) alır. |
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler) |
Bu yöntem, bir XElement alt ağacın belirtilen XmlSchemaObject ve XmlSchemaSetile uyumlu olduğunu doğrular. |
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. |
CreateNavigator(XNode) |
için bir XPathNavigatorXNodeoluşturur. |
CreateNavigator(XNode, XmlNameTable) |
için bir XPathNavigatorXNodeoluşturur. , XmlNameTable daha verimli XPath ifade işlemeyi etkinleştirir. |
XPathEvaluate(XNode, String) |
XPath ifadesini değerlendirir. |
XPathEvaluate(XNode, String, IXmlNamespaceResolver) |
Belirtilen IXmlNamespaceResolverkullanarak ad alanı ön eklerini çözerek bir XPath ifadesini değerlendirir. |
XPathSelectElement(XNode, String) |
XPath ifadesi kullanarak bir XElement ifade seçer. |
XPathSelectElement(XNode, String, IXmlNamespaceResolver) |
Belirtilen IXmlNamespaceResolverkullanarak ad alanı ön eklerini çözümleyerek bir XPath ifadesi kullanarak bir XElement seçer. |
XPathSelectElements(XNode, String) |
XPath ifadesi kullanarak bir öğe koleksiyonu seçer. |
XPathSelectElements(XNode, String, IXmlNamespaceResolver) |
Belirtilen IXmlNamespaceResolverkullanarak ad alanı ön eklerini çözümleyerek XPath ifadesi kullanan bir öğe koleksiyonu seçer. |
ToXPathNavigable(XNode) |
Belirtilen XNodeöğesine gitmenize ve bunları düzenlemenize olanak tanıyan bir erişimci döndürür. |