이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

XName 클래스

 

XML 요소 또는 특성의 이름을 나타냅니다.

네임스페이스:   System.Xml.Linq
어셈블리:  System.Xml.Linq(System.Xml.Linq.dll에 있음)

System.Object
  System.Xml.Linq.XName

[SerializableAttribute]
public sealed class XName : IEquatable<XName>, ISerializable

이름설명
System_CAPS_pubpropertyLocalName

이름의 로컬 (비 정규화 된) 부분을 가져옵니다.

System_CAPS_pubpropertyNamespace

정규화 된 이름의 네임 스페이스 부분을 가져옵니다.

System_CAPS_pubpropertyNamespaceName

URI를 반환 된 XNamespaceXName합니다.

이름설명
System_CAPS_pubmethodEquals(Object)

확인 여부를 지정 된 XName 이 같으면 XName합니다.(Object.Equals(Object)을(를) 재정의함)

System_CAPS_pubmethodSystem_CAPS_staticGet(String)

가져옵니다는 XName 개체에서 확장된 된 이름이 있습니다.

System_CAPS_pubmethodSystem_CAPS_staticGet(String, String)

가져옵니다는 XName 로컬 이름 및 네임 스페이스에서 개체입니다.

System_CAPS_pubmethodGetHashCode()

XName의 해시 코드를 가져옵니다.(Object.GetHashCode()을(를) 재정의함)

System_CAPS_pubmethodGetType()

현재 인스턴스의 Type을 가져옵니다.(Object에서 상속됨)

System_CAPS_pubmethodToString()

형식 확장 된 XML 이름을 반환 {namespace}localname합니다.(Object.ToString()을(를) 재정의함)

이름설명
System_CAPS_puboperatorSystem_CAPS_staticEquality(XName, XName)

XName의 두 인스턴스가 같은지를 나타내는 값을 반환합니다.

System_CAPS_puboperatorSystem_CAPS_staticImplicit(String to XName)

확장 된 XML 이름으로 서식이 지정 된 문자열 변환 (즉,{namespace}localname)에 XName 개체입니다.

System_CAPS_puboperatorSystem_CAPS_staticInequality(XName, XName)

두 인스턴스가 같은지를 나타내는 값을 반환의 XName 같지 않은 것입니다.

이름설명
System_CAPS_pubinterfaceSystem_CAPS_privmethodIEquatable<XName>.Equals(XName)

현재 XName가 지정된 XName와 같은지 여부를 나타냅니다.

System_CAPS_pubinterfaceSystem_CAPS_privmethodISerializable.GetObjectData(SerializationInfo, StreamingContext)

대상 개체를 serialize하는 데 필요한 데이터로 SerializationInfo를 채웁니다.

XML 이름에는 네임 스페이스와 로컬 이름이 포함 합니다. A 정규화 된 이름을 로컬 이름과 네임 스페이스의 조합입니다.

XName 공용 생성자를 포함 하지 않습니다. 이 클래스는 암시적 변환이 제공 하는 대신, String 만들 수 있는 한 XName합니다. 주로 여기서가이 변환을 사용 하는 요소 또는 특성을 만들 때: 첫 번째 인수는 XElement 생성자는 한 XName합니다. 문자열에 전달 하 여 이용할 있습니다 암시적으로 변환 합니다. 다음 코드 네임 스페이스에 있는 이름을 가진 요소를 만듭니다.


                XElement root = new XElement("ElementName", "content");
Console.WriteLine(root);

Visual basic에서는 XML 리터럴을 사용 하 여 더 적합 합니다.


                Dim root As XElement = <ElementName>content</ElementName>
Console.WriteLine(root)

이 예제는 다음과 같은 출력을 생성합니다.


<ElementName>content</ElementName>

문자열을 할당 한 XName 의 암시적 변환을 사용 하 여 String합니다.

Visual Basic 예제에서는 XElement XML 리터럴을 사용 합니다. XML 리터럴을 사용 하는 경우에는 XName 개체에 대해 만들어집니다는 XElement합니다.

또한를 호출할 수 있습니다는 Get 에 대 한 메서드는 XName 개체입니다. 그러나 문자열에서 암시적 변환을 사용 하는 것이 좋습니다.

XML과 마찬가지로 XName 또는 네임 스페이스, 수 없는 네임 스페이스에 있을 수 있습니다.

C#을 만들기 위한 권장 되는 방법에 대 한는 XName 를 선언 하는 네임 스페이스에는 XNamespace 개체를 만든 다음 더하기 연산자의 재정의 사용 합니다.

Visual Basic의 경우에 대 한 네임 스페이스에 XML을 만들려는 XML 리터럴 및 전역 네임 스페이스 선언을 사용 하는 것이 좋습니다.


                XNamespace aw = "http://www.adventure-works.com";
XElement root = new XElement(aw + "ElementName", "content");
Console.WriteLine(root);

이 예제는 다음과 같은 출력을 생성합니다.


<ElementName xmlns="http://www.adventure-works.com">content</ElementName>

Namespace 속성은 XName 개체는 항상 null이 아니어야 합니다. 하는 경우는 XName 어떠한 네임 스페이스에는 Namespace 속성으로 설정 됩니다 None합니다. 다음 코드에서는이 보여 줍니다.


                XElement root = new XElement("ElementName", "content");
if (root.Name.Namespace == XNamespace.None)
    Console.WriteLine("The element is in no namespace.");
else
    Console.WriteLine("The element is in a namespace.");

이 예제는 다음과 같은 출력을 생성합니다.

The element is in no namespace.

만들 수도 있습니다는 XName 양식에서 확장 된 XML 이름에서 {namespace}localname:


                XElement root = new XElement("{http://www.adventure-works.com}ElementName", "content");
Console.WriteLine(root);

이 예제는 다음과 같은 출력을 생성합니다.


<ElementName xmlns="http://www.adventure-works.com">content</ElementName>

주의 만드는 XName 확장된 된 이름을 통해는 만드는 것 보다 효율성이 떨어집니다는 XNamespace 개체 및 더하기 연산자의 재정의 사용 합니다. 전역 네임 스페이스를 가져오면 및 Visual Basic에서 XML 리터럴을 사용 하 여 보다 덜 효율적 이기도 합니다.

만드는 경우는 XName 확장된 된 이름을 사용 하 여, LINQ to XML 찾아야 네임 스페이스의 원자화 된 인스턴스. 이 작업에 대 한 확장된 된 이름이 사용 된 모든 반복 해야 합니다. 이 추가 시간을; LINQ 쿼리를 작성 하는 경우에 무시할 수 그러나 그 그다지는 대형 XML 트리를 만들 때.

XName 개체는; 원자화 되도록 보장 됩니다. 즉, 두 XName 개체 같은 네임 스페이스와 정확히 동일한 로컬 이름, 동일한 인스턴스를 공유 합니다. 같음 및 비교 연산자는이 용도로 명시적으로 제공 됩니다.

여러 가지 이점을 얻을이 기능을 사용 하면 쿼리 실행 속도가 빨라집니다. 요소 또는 특성의 이름을 필터링 하는 경우 비교 조건자로 표현 되는 id 비교가 되지 값 비교를 사용 합니다. 두 개의 참조 하려면 두 문자열을 비교 하는 보다 같은 개체를 실제로 참조 하는지 확인 하려면 훨씬 빠릅니다.

유니버설 Windows 플랫폼
8 이후 사용 가능
.NET Framework
3.5 이후 사용 가능
이식 가능한 클래스 라이브러리
이식 가능한 .NET 플랫폼 에서 지원됨
Silverlight
2.0 이후 사용 가능
Windows Phone Silverlight
7.0 이후 사용 가능
Windows Phone
8.1 이후 사용 가능

이 형식의 모든 public static(Visual Basic의 공유 Visual Basic의 경우) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전이 보장되지 않습니다.

맨 위로 이동
표시: