XmlnsPrefixAttribute 클래스

정의

네임스페이스:

System.Windows.Markup

어셈블리:

System.Xaml.dll

XAML 파일에 요소 및 특성을 쓰거나(serialization) XAML 편집 기능이 있는 디자인 환경을 조작할 때 XAML 사용을 위해 XAML 네임스페이스와 연결할 권장 접두사를 식별합니다.

public ref class XmlnsPrefixAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true)]
public sealed class XmlnsPrefixAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true)>]
type XmlnsPrefixAttribute = class
    inherit Attribute

Public NotInheritable Class XmlnsPrefixAttribute
Inherits Attribute

상속

Object

Attribute

XmlnsPrefixAttribute

특성

AttributeUsageAttribute

설명

XAML을 통합하는 XAML 프로세서 또는 프레임워크 또는 XAML serialization을 수행하는 모든 프로세스는 일반적으로 권장 접두사를 적용해야 합니다. 원래 XAML 원본의 특정 매핑의 접두사가 런타임 개체 그래프에 유지되거나 프레임워크 또는 기술에 의해 저장되지 않는 경우 접두사는 필요할 수 있습니다. 프레임워크에는 자체 어셈블리에서 권장되는 접두사를 무시하는 자체 형식을 직렬화하는 방법에 대한 특정 기본 설정이 있을 수 있습니다. 이 작업은 기본 XAML 네임스페이스를 일관되게 승격하기 위해 수행될 수 있습니다. 그러나 이러한 프레임워크는 XAML 형식의 가능한 타사 및 도구 사용에 권장되는 접두사를 계속 제공해야 합니다. 아래의 "XAML Designer 지원 또는 일반 serialization에 대한 모범 사례" 섹션을 참조하세요.

접두사는 일반적으로 XAML 네임스페이스에서 제공되는 모든 직렬화된 요소에 적용되므로 접두사에 대한 일반적인 권장 사항은 짧은 문자열을 사용하는 것입니다. 접두사 문자열 길이는 직렬화된 XAML 출력의 크기에 눈에 띄는 영향을 미칠 수 있습니다.

이전에 발견/직렬화된 다른 XAML 네임스페이스 식별자가 요청 중인 접두사를 이미 사용 중인 경우 동작은 지정되지 않습니다(동작은 각 개별 XAML 프로세서 구현에 따라 다름).

대부분의 경우 동일한 XAML 네임스페이스에 대해 어셈블리에 하나 XmlnsDefinitionAttribute 이상을 적용한 경우에만 적용 XmlnsPrefixAttribute 됩니다.

.NET Framework의 이전 버전에서는이 클래스는 WPF 관련 WindowsBase 어셈블리에 존재합니다. .NET Framework 4 XmlnsPrefixAttribute 에서 는 System.Xaml 어셈블리에 있습니다. 자세한 내용은 Types Migrated from WPF to System.Xaml을 참조하세요.

XAML Designer 지원 또는 일반 직렬화에 대한 모범 사례

연결된 XAML 네임스페이스를 프레임워크 또는 라이브러리의 대부분의 사용 사례에서 기본 XAML 네임스페이스로 설정하려는 경우에도 비어 있지 않은 문자열을 XAML 네임스페이스에 대한 권장 접두사로 지정해야 합니다. 기본 XAML 네임스페이스 정보는 개별 XAML 파일 및 XAML 노드 스트림에 전달됩니다. 기본 XAML 네임스페이스 및 지정된 XAML 원본에 정의되는 방법은 를 사용하지 XmlnsPrefixAttribute않고 대/소문자별 직렬화를 위해 쉽게 영속될 수 있습니다. 그러나 는 XmlnsPrefixAttribute XAML 작성자가 기본 XAML 네임스페이스를 다른 항목에 매핑하도록 선택한 경우에 유용합니다. 이 시나리오에서는 디자인 환경에 포함된 XAML 텍스트 편집기를 초기 XAML 네임스페이스 xmlns 매핑에 대한 힌트로 사용할 XmlnsPrefixAttribute 수 있습니다. 또는 디자인 환경에서는 도구 상자에서 시각적 디자인 화면으로 개체를 끌어와 같은 디자인 은유를 위해 지원 XAML에 Just-In-Time 매핑을 추가할 수 있습니다. 또한 디자이너가 동시에 여러 XAML 지원 프레임워크를 지원할 수 있으며 프레임워크별 직렬화가 아닌 .NET Framework XAML 서비스에 의존하는 공통 XAML 직렬 변환기가 있다고 생각할 수 있습니다. 이러한 시나리오에 대해 를 XmlnsPrefixAttribute 지정하면 디자인 도구 간에 XAML을 교환하거나 XAML 편집기와 태그 컴파일러 또는 기타 직렬화와 같은 다른 소비자 간에 왕복을 진행하는 경우 형식에 대한 XAML 사용량을 더 이식 가능하고 강력하게 만들 수 있습니다.

생성자

XmlnsPrefixAttribute(String, String)

XmlnsPrefixAttribute 클래스의 새 인스턴스를 초기화합니다.

속성

Prefix	이 특성에 연결된 권장 접두사를 가져옵니다.
TypeId	파생 클래스에서 구현된 경우 이 Attribute에 대한 고유 식별자를 가져옵니다. (다음에서 상속됨 Attribute)
XmlNamespace	이 특성에 연결된 XAML 네임스페이스 식별자를 가져옵니다.

메서드

Equals(Object)	이 인스턴스가 지정된 개체와 같은지를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute)
GetHashCode()	이 인스턴스의 해시 코드를 반환합니다. (다음에서 상속됨 Attribute)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
IsDefaultAttribute()	파생 클래스에서 재정의된 경우 이 인스턴스 값이 파생 클래스에 대한 기본값인지 여부를 표시합니다. (다음에서 상속됨 Attribute)
Match(Object)	파생 클래스에서 재정의된 경우 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

추가 정보

• 사용자 지정 형식 및 라이브러리에 대한 XAML 관련 CLR 특성
• .NET XAML 서비스에서 사용할 사용자 지정 형식 정의
• XAML 서비스