XElement 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
XML 요소를 나타냅니다. 사용량 정보 및 예제는 이 페이지의 XElement 클래스 개요 및 주의 섹션을 참조하세요.
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
- 상속
- 구현
예제
다음 예제에서는 XML 트리를 만듭니다. 새 요소의 콘텐츠는 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)
이 예제는 다음과 같은 출력을 생성합니다.
<Root>
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
</Root>
다음은 동일한 예제이지만 이 경우 XML은 네임스페이스에 있습니다. 자세한 내용은 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
이 예제는 다음과 같은 출력을 생성합니다.
<Root xmlns="http://www.adventure-works.com">
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
</Root>
설명
이 클래스는 XML 요소, 기본 XML 구문을 나타냅니다. 다른 사용 정보는 XElement 클래스 개요 를 참조하세요.
요소에는 XName필요에 따라 하나 이상의 특성이 있으며 필요에 따라 콘텐츠를 포함할 수 있습니다(자세한 내용은 참조 Nodes).
다음 XElement 유형의 콘텐츠를 포함할 수 있습니다.
유효한 콘텐츠 XElement에 대한 자세한 내용은 XElement 및 XDocument 개체의 유효한 콘텐츠를 참조하세요.
XElement에서 파생되는 .에서 XContainerXNode파생됩니다.
일부 XElement 메서드는 XAML에서 사용할 수 있습니다. 자세한 내용은 LINQ to XML 동적 속성을 참조하세요.
생성자
| Name | Description |
|---|---|
| XElement(XElement) | |
| XElement(XName, Object) |
지정된 이름과 콘텐츠를 사용하여 클래스의 XElement 새 인스턴스를 초기화합니다. |
| XElement(XName, Object[]) |
지정된 이름과 콘텐츠를 사용하여 클래스의 XElement 새 인스턴스를 초기화합니다. |
| XElement(XName) |
지정된 이름을 사용하여 클래스의 XElement 새 인스턴스를 초기화합니다. |
| XElement(XStreamingElement) |
개체에서 클래스의 새 인스턴스를 XElementXStreamingElement 초기화합니다. |
속성
| Name | Description |
|---|---|
| BaseUri |
이 XObject에 대한 기본 URI를 가져옵니다. (다음에서 상속됨 XObject) |
| Document |
에 XDocument대한 값을 XObject 가져옵니다. (다음에서 상속됨 XObject) |
| EmptySequence |
요소의 빈 컬렉션을 가져옵니다. |
| FirstAttribute |
이 요소의 첫 번째 특성을 가져옵니다. |
| FirstNode |
이 노드의 첫 번째 자식 노드를 가져옵니다. (다음에서 상속됨 XContainer) |
| HasAttributes |
이 요소에 하나 이상의 특성이 있는지 여부를 나타내는 값을 가져옵니다. |
| HasElements |
이 요소에 하나 이상의 자식 요소가 있는지 여부를 나타내는 값을 가져옵니다. |
| IsEmpty |
이 요소에 콘텐츠가 없는지 여부를 나타내는 값을 가져옵니다. |
| LastAttribute |
이 요소의 마지막 특성을 가져옵니다. |
| LastNode |
이 노드의 마지막 자식 노드를 가져옵니다. (다음에서 상속됨 XContainer) |
| Name |
이 요소의 이름을 가져오거나 설정합니다. |
| NextNode |
이 노드의 다음 형제 노드를 가져옵니다. (다음에서 상속됨 XNode) |
| NodeType |
이 노드의 노드 형식을 가져옵니다. |
| Parent |
이 XElement항목의 부모를 XObject 가져옵니다. (다음에서 상속됨 XObject) |
| PreviousNode |
이 노드의 이전 형제 노드를 가져옵니다. (다음에서 상속됨 XNode) |
| Value |
이 요소의 연결된 텍스트 내용을 가져오거나 설정합니다. |
메서드
| Name | Description |
|---|---|
| Add(Object) |
지정된 콘텐츠를 이 XContainer내용의 자식으로 추가합니다. (다음에서 상속됨 XContainer) |
| Add(Object[]) |
지정된 콘텐츠를 이 XContainer내용의 자식으로 추가합니다. (다음에서 상속됨 XContainer) |
| AddAfterSelf(Object) |
이 노드 바로 다음에 지정된 콘텐츠를 추가합니다. (다음에서 상속됨 XNode) |
| AddAfterSelf(Object[]) |
이 노드 바로 다음에 지정된 콘텐츠를 추가합니다. (다음에서 상속됨 XNode) |
| AddAnnotation(Object) |
이 XObject주석 목록에 개체를 추가합니다. (다음에서 상속됨 XObject) |
| AddBeforeSelf(Object) |
이 노드 바로 앞에 지정된 콘텐츠를 추가합니다. (다음에서 상속됨 XNode) |
| AddBeforeSelf(Object[]) |
이 노드 바로 앞에 지정된 콘텐츠를 추가합니다. (다음에서 상속됨 XNode) |
| AddFirst(Object) |
지정한 내용을 이 문서 또는 요소의 첫 번째 자식으로 추가합니다. (다음에서 상속됨 XContainer) |
| AddFirst(Object[]) |
지정한 내용을 이 문서 또는 요소의 첫 번째 자식으로 추가합니다. (다음에서 상속됨 XContainer) |
| Ancestors() |
이 노드의 상위 요소 컬렉션을 반환합니다. (다음에서 상속됨 XNode) |
| Ancestors(XName) |
이 노드의 상위 요소에 대한 필터링된 컬렉션을 반환합니다. 일치하는 XName 있는 요소만 컬렉션에 포함됩니다. (다음에서 상속됨 XNode) |
| AncestorsAndSelf() |
이 요소를 포함하는 요소의 컬렉션과 이 요소의 상위 항목을 반환합니다. |
| AncestorsAndSelf(XName) |
이 요소를 포함하는 요소의 필터링된 컬렉션과 이 요소의 상위 항목을 반환합니다. 일치하는 XName 있는 요소만 컬렉션에 포함됩니다. |
| Annotation(Type) |
지정된 형식의 첫 번째 주석 개체를 이 XObject주석에서 가져옵니다. (다음에서 상속됨 XObject) |
| Annotation<T>() |
지정된 형식의 첫 번째 주석 개체를 이 XObject주석에서 가져옵니다. (다음에서 상속됨 XObject) |
| Annotations(Type) |
이 XObject항목에 대해 지정된 형식의 주석 컬렉션을 가져옵니다. (다음에서 상속됨 XObject) |
| Annotations<T>() |
이 XObject항목에 대해 지정된 형식의 주석 컬렉션을 가져옵니다. (다음에서 상속됨 XObject) |
| Attribute(XName) |
지정된 XName이 XAttribute 값을 XElement 반환합니다. |
| Attributes() |
이 요소의 특성 컬렉션을 반환합니다. |
| Attributes(XName) |
이 요소의 필터링된 특성 컬렉션을 반환합니다. 일치하는 XName 특성만 컬렉션에 포함됩니다. |
| CreateReader() |
이 노드에 대한 항목을 XmlReader 만듭니다. (다음에서 상속됨 XNode) |
| CreateReader(ReaderOptions) |
매개 변수로 XmlReader 지정된 |
| CreateWriter() |
노드를 XmlWriter 추가하는 데 사용할 수 있는 노드를 XContainer만듭니다. (다음에서 상속됨 XContainer) |
| DescendantNodes() |
이 문서 또는 요소의 하위 노드 컬렉션을 문서 순서대로 반환합니다. (다음에서 상속됨 XContainer) |
| DescendantNodesAndSelf() |
이 요소를 포함하는 노드의 컬렉션과 이 요소의 모든 하위 노드를 문서 순서대로 반환합니다. |
| Descendants() |
이 문서 또는 요소의 하위 요소 컬렉션을 문서 순서대로 반환합니다. (다음에서 상속됨 XContainer) |
| Descendants(XName) |
이 문서 또는 요소에 대한 하위 요소의 필터링된 컬렉션을 문서 순서대로 반환합니다. 일치하는 XName 있는 요소만 컬렉션에 포함됩니다. (다음에서 상속됨 XContainer) |
| DescendantsAndSelf() |
이 요소를 포함하는 요소의 컬렉션과 이 요소의 모든 하위 요소를 문서 순서대로 반환합니다. |
| DescendantsAndSelf(XName) |
이 요소를 포함하는 요소의 필터링된 컬렉션과 이 요소의 모든 하위 요소를 문서 순서대로 반환합니다. 일치하는 XName 있는 요소만 컬렉션에 포함됩니다. |
| Element(XName) |
지정 XName한 자식 요소를 문서 순서대로 가져옵니다. (다음에서 상속됨 XContainer) |
| Elements() |
이 요소 또는 문서의 자식 요소 컬렉션을 문서 순서대로 반환합니다. (다음에서 상속됨 XContainer) |
| Elements(XName) |
이 요소 또는 문서의 자식 요소의 필터링된 컬렉션을 문서 순서대로 반환합니다. 일치하는 XName 있는 요소만 컬렉션에 포함됩니다. (다음에서 상속됨 XContainer) |
| ElementsAfterSelf() |
이 노드 뒤의 형제 요소 컬렉션을 문서 순서대로 반환합니다. (다음에서 상속됨 XNode) |
| ElementsAfterSelf(XName) |
이 노드 뒤의 형제 요소의 필터링된 컬렉션을 문서 순서대로 반환합니다. 일치하는 XName 있는 요소만 컬렉션에 포함됩니다. (다음에서 상속됨 XNode) |
| ElementsBeforeSelf() |
이 노드 앞에 있는 형제 요소의 컬렉션을 문서 순서대로 반환합니다. (다음에서 상속됨 XNode) |
| ElementsBeforeSelf(XName) |
이 노드 앞에 있는 형제 요소의 필터링된 컬렉션을 문서 순서대로 반환합니다. 일치하는 XName 있는 요소만 컬렉션에 포함됩니다. (다음에서 상속됨 XNode) |
| Equals(Object) |
지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object) |
| GetDefaultNamespace() |
이 XNamespace기본값 XElement 을 가져옵니다. |
| GetHashCode() |
기본 해시 함수로 사용됩니다. (다음에서 상속됨 Object) |
| GetNamespaceOfPrefix(String) |
이에 대한 특정 접두사와 연결된 네임스페이 XElement스를 가져옵니다. |
| GetPrefixOfNamespace(XNamespace) |
이 XElement네임스페이스와 연결된 접두사를 가져옵니다. |
| GetType() |
현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object) |
| IsAfter(XNode) |
문서 순서를 기준으로 현재 노드가 지정된 노드 다음에 표시되는지 여부를 확인합니다. (다음에서 상속됨 XNode) |
| IsBefore(XNode) |
문서 순서를 기준으로 현재 노드가 지정된 노드 앞에 표시되는지 여부를 확인합니다. (다음에서 상속됨 XNode) |
| Load(Stream, LoadOptions) |
지정된 스트림을 사용하고, 필요에 따라 공백을 유지하고, 기본 URI를 설정하고, 줄 정보를 유지하여 새 XElement 인스턴스를 만듭니다. |
| Load(Stream) |
지정된 스트림을 사용하여 새 XElement 인스턴스를 만듭니다. |
| Load(String, LoadOptions) |
파일에서 로드하고 XElement , 필요에 따라 공백을 유지하고, 기본 URI를 설정하고, 줄 정보를 유지합니다. |
| Load(String) |
파일에서 로드합니다 XElement . |
| Load(TextReader, LoadOptions) |
XElement 선택적으로 공백을 보존하고 줄 정보를 보존하는 위치에서 TextReader로드합니다. |
| Load(TextReader) |
에서 로드 XElement 합니다 TextReader. |
| Load(XmlReader, LoadOptions) |
XElement XmlReader필요에 따라 공백 유지, 기본 URI 설정 및 줄 정보 유지에서 로드합니다. |
| Load(XmlReader) | |
| LoadAsync(Stream, LoadOptions, CancellationToken) |
필요에 따라 공백을 유지하면서 지정된 스트림을 사용하여 새 XElement XML 트리를 비동기적으로 만들고 기본 XML 트리를 초기화합니다. |
| LoadAsync(TextReader, LoadOptions, CancellationToken) |
필요에 따라 공백을 유지하면서 지정된 텍스트 판독기를 사용하여 새 XElement 항목을 만들고 기본 XML 트리를 초기화합니다. |
| LoadAsync(XmlReader, LoadOptions, CancellationToken) |
필요에 따라 공백을 유지하면서 지정된 XML 판독기를 사용하여 새 XElement XML 트리를 비동기적으로 만들고 기본 XML 트리를 초기화합니다. |
| MemberwiseClone() |
현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object) |
| Nodes() |
이 요소 또는 문서의 자식 노드 컬렉션을 문서 순서대로 반환합니다. (다음에서 상속됨 XContainer) |
| NodesAfterSelf() |
이 노드 뒤의 형제 노드 컬렉션을 문서 순서대로 반환합니다. (다음에서 상속됨 XNode) |
| NodesBeforeSelf() |
이 노드 앞에 있는 형제 노드의 컬렉션을 문서 순서대로 반환합니다. (다음에서 상속됨 XNode) |
| Parse(String, LoadOptions) |
XElement 필요에 따라 공백을 유지하고 줄 정보를 유지하는 XML이 포함된 문자열에서 로드합니다. |
| Parse(String) |
XML이 XElement 포함된 문자열에서 로드합니다. |
| Remove() |
부모에서 이 노드를 제거합니다. (다음에서 상속됨 XNode) |
| RemoveAll() |
이 XElement에서 노드 및 특성을 제거합니다. |
| RemoveAnnotations(Type) |
지정된 형식의 주석을 이 XObject주석에서 제거합니다. (다음에서 상속됨 XObject) |
| RemoveAnnotations<T>() |
지정된 형식의 주석을 이 XObject주석에서 제거합니다. (다음에서 상속됨 XObject) |
| RemoveAttributes() |
의 XElement특성을 제거합니다. |
| RemoveNodes() |
이 문서 또는 요소에서 자식 노드를 제거합니다. (다음에서 상속됨 XContainer) |
| ReplaceAll(Object) |
자식 노드와 이 요소의 특성을 지정된 콘텐츠로 바꿉니다. |
| ReplaceAll(Object[]) |
자식 노드와 이 요소의 특성을 지정된 콘텐츠로 바꿉니다. |
| ReplaceAttributes(Object) |
이 요소의 특성을 지정된 콘텐츠로 바꿉니다. |
| ReplaceAttributes(Object[]) |
이 요소의 특성을 지정된 콘텐츠로 바꿉니다. |
| ReplaceNodes(Object) |
이 문서 또는 요소의 자식 노드를 지정된 콘텐츠로 바꿉니다. (다음에서 상속됨 XContainer) |
| ReplaceNodes(Object[]) |
이 문서 또는 요소의 자식 노드를 지정된 콘텐츠로 바꿉니다. (다음에서 상속됨 XContainer) |
| ReplaceWith(Object) |
이 노드를 지정된 콘텐츠로 바꿉니다. (다음에서 상속됨 XNode) |
| ReplaceWith(Object[]) |
이 노드를 지정된 콘텐츠로 바꿉니다. (다음에서 상속됨 XNode) |
| Save(Stream, SaveOptions) | |
| Save(Stream) | |
| Save(String, SaveOptions) |
필요에 따라 서식을 사용하지 않도록 설정하여 이 요소를 파일로 직렬화합니다. |
| Save(String) |
이 요소를 파일로 직렬화합니다. |
| Save(TextWriter, SaveOptions) |
필요에 따라 서식을 TextWriter사용하지 않도록 설정하여 이 요소를 직렬화합니다. |
| Save(TextWriter) |
이 요소를 .에 직렬화합니다 TextWriter. |
| Save(XmlWriter) |
이 요소를 .에 직렬화합니다 XmlWriter. |
| SaveAsync(Stream, SaveOptions, CancellationToken) | |
| SaveAsync(TextWriter, SaveOptions, CancellationToken) |
이를 비동기적으로 출력합니다 XElementTextWriter. |
| SaveAsync(XmlWriter, CancellationToken) | |
| SetAttributeValue(XName, Object) |
특성 값을 설정하거나, 특성을 추가하거나, 특성을 제거합니다. |
| SetElementValue(XName, Object) |
자식 요소의 값을 설정하거나, 자식 요소를 추가하거나, 자식 요소를 제거합니다. |
| SetValue(Object) |
이 요소의 값을 설정합니다. |
| ToString() |
이 노드에 대해 들여쓰기된 XML을 반환합니다. (다음에서 상속됨 XNode) |
| ToString(SaveOptions) |
필요에 따라 서식을 사용하지 않도록 설정하여 이 노드에 대한 XML을 반환합니다. (다음에서 상속됨 XNode) |
| WriteTo(XmlWriter) |
에 이 요소를 XmlWriter씁니다. |
| WriteToAsync(XmlWriter, CancellationToken) |
지정된 작성기에 XElement 비동기적으로 씁니다. |
연산자
이벤트
| Name | Description |
|---|---|
| Changed |
이 XObject 항목 또는 해당 하위 항목이 변경되었을 때 발생합니다. (다음에서 상속됨 XObject) |
| Changing |
이 XObject 항목 또는 해당 하위 항목이 변경하려고 할 때 발생합니다. (다음에서 상속됨 XObject) |
명시적 인터페이스 구현
| Name | Description |
|---|---|
| IXmlLineInfo.HasLineInfo() |
줄 정보가 있는지 여부를 XObject 나타내는 값을 가져옵니다. (다음에서 상속됨 XObject) |
| IXmlLineInfo.LineNumber |
이 항목에 대해 XmlReader내부에서 보고한 XObject 줄 번호를 가져옵니다. (다음에서 상속됨 XObject) |
| IXmlLineInfo.LinePosition |
기본에서 보고XmlReader한 XObject 줄 위치를 가져옵니다. (다음에서 상속됨 XObject) |
| IXmlSerializable.GetSchema() |
이 개체의 XML 표현을 설명하는 XML 스키마 정의를 가져옵니다. |
| IXmlSerializable.ReadXml(XmlReader) |
XML 표현에서 개체를 생성합니다. |
| IXmlSerializable.WriteXml(XmlWriter) |
개체를 XML 표현으로 변환합니다. |