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 동적 속성을 참조하세요.
생성자
XElement(XElement) | |
XElement(XName) |
지정된 이름을 사용하여 XElement 클래스의 새 인스턴스를 초기화합니다. |
XElement(XName, Object) |
지정된 이름 및 콘텐츠를 사용하여 XElement 클래스의 새 인스턴스를 초기화합니다. |
XElement(XName, Object[]) |
지정된 이름 및 콘텐츠를 사용하여 XElement 클래스의 새 인스턴스를 초기화합니다. |
XElement(XStreamingElement) |
XElement 개체를 사용하여 XStreamingElement 클래스의 새 인스턴스를 초기화합니다. |
속성
BaseUri |
이 XObject의 기본 URI를 가져옵니다. (다음에서 상속됨 XObject) |
Document | (다음에서 상속됨 XObject) |
EmptySequence |
요소의 빈 컬렉션을 가져옵니다. |
FirstAttribute |
이 요소의 첫 번째 특성을 가져옵니다. |
FirstNode |
이 노드의 첫 번째 자식 노드를 가져옵니다. (다음에서 상속됨 XContainer) |
HasAttributes |
이 요소에 특성이 하나 이상 있는지를 나타내는 값을 가져옵니다. |
HasElements |
이 요소에 자식 요소가 최소한 하나 있는지 여부를 나타내는 값을 가져옵니다. |
IsEmpty |
이 요소에 콘텐츠가 없는지 여부를 나타내는 값을 가져옵니다. |
LastAttribute |
이 요소의 마지막 특성을 가져옵니다. |
LastNode |
이 노드의 마지막 자식 노드를 가져옵니다. (다음에서 상속됨 XContainer) |
Name |
이 요소의 이름을 가져오거나 설정합니다. |
NextNode |
이 노드의 다음 형제 노드를 가져옵니다. (다음에서 상속됨 XNode) |
NodeType |
이 노드에 대한 노드 형식을 가져옵니다. |
Parent |
이 XElement의 부모 XObject를 가져옵니다. (다음에서 상속됨 XObject) |
PreviousNode |
이 노드의 이전 형제 노드를 가져옵니다. (다음에서 상속됨 XNode) |
Value |
이 요소의 연결된 텍스트 콘텐츠를 가져오거나 설정합니다. |
메서드
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) |
지정된 XAttribute이 있는 이 XElement의 XName를 반환합니다. |
Attributes() |
이 요소의 특성 컬렉션을 반환합니다. |
Attributes(XName) |
이 요소의 필터링된 특성 컬렉션을 반환합니다. 일치하는 XName이 있는 특성만 컬렉션에 포함됩니다. |
CreateReader() |
이 노드에 대한 XmlReader를 만듭니다. (다음에서 상속됨 XNode) |
CreateReader(ReaderOptions) |
|
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) |
지정된 스트림을 사용하여 새 XElement 인스턴스를 만듭니다. |
Load(Stream, LoadOptions) |
지정된 스트림을 사용하여 새 XElement 인스턴스를 만들고, 선택적으로 공백 및 줄 정보를 유지하고 기본 URI를 설정합니다. |
Load(String) |
파일에서 XElement를 로드합니다. |
Load(String, LoadOptions) |
파일에서 XElement를 로드하고, 선택적으로 공백 및 줄 정보를 유지하고 기본 URI를 설정합니다. |
Load(TextReader) |
XElement에서 TextReader를 로드합니다. |
Load(TextReader, LoadOptions) |
XElement에서 TextReader를 로드하고, 선택적으로 공백 및 줄 정보를 유지합니다. |
Load(XmlReader) | |
Load(XmlReader, LoadOptions) |
XElement에서 XmlReader를 로드하고, 선택적으로 공백 및 줄 정보를 유지하고 기본 URI를 설정합니다. |
LoadAsync(Stream, LoadOptions, CancellationToken) |
새 XElement를 비동기적으로 만들고 지정된 스트림을 사용하여 기본 XML 트리를 초기화하고 필요에 따라 공백을 유지합니다. |
LoadAsync(TextReader, LoadOptions, CancellationToken) |
새 XElement를 비동기적으로 만들고 지정된 텍스트 판독기를 사용하여 기본 XML 트리를 초기화하고 필요에 따라 공백을 유지합니다. |
LoadAsync(XmlReader, LoadOptions, CancellationToken) |
새 XElement를 비동기적으로 만들고 지정된 XML 판독기를 사용하여 기본 XML 트리를 초기화하고 필요에 따라 공백을 유지합니다. |
MemberwiseClone() |
현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object) |
Nodes() |
이 요소 또는 문서의 자식 노드가 문서순으로 들어 있는 컬렉션을 반환합니다. (다음에서 상속됨 XContainer) |
NodesAfterSelf() |
이 노드 뒤에 있는 형제 노드의 컬렉션을 문서 순으로 반환합니다. (다음에서 상속됨 XNode) |
NodesBeforeSelf() |
이 노드 앞에 있는 형제 노드의 컬렉션을 문서 순으로 반환합니다. (다음에서 상속됨 XNode) |
Parse(String) |
XML이 들어 있는 문자열에서 XElement를 로드합니다. |
Parse(String, LoadOptions) |
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) | |
Save(Stream, SaveOptions) | |
Save(String) |
이 요소를 파일로 serialize합니다. |
Save(String, SaveOptions) |
이 요소를 파일로 serialize하고, 선택적으로 형식 지정을 해제합니다. |
Save(TextWriter) |
이 요소를 TextWriter로 serialize합니다. |
Save(TextWriter, SaveOptions) |
이 요소를 TextWriter로 serialize하고, 선택적으로 형식 지정을 해제합니다. |
Save(XmlWriter) |
이 요소를 XmlWriter로 serialize합니다. |
SaveAsync(Stream, SaveOptions, CancellationToken) | |
SaveAsync(TextWriter, SaveOptions, CancellationToken) |
이 XElement를 TextWriter에 비동기적으로 출력합니다. |
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를 지정된 기록기에 비동기적으로 씁니다. |
WriteToAsync(XmlWriter, CancellationToken) |
현재 노드를 XmlWriter에 씁니다. (다음에서 상속됨 XNode) |
연산자
이벤트
Changed |
이 XObject 또는 해당 하위 항목이 변경될 때 발생합니다. (다음에서 상속됨 XObject) |
Changing |
이 XObject 또는 해당 하위 항목이 변경되기 직전에 발생합니다. (다음에서 상속됨 XObject) |
명시적 인터페이스 구현
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 표현으로 변환합니다. |
확장 메서드
적용 대상
추가 정보
.NET