NameScope 클래스

정의

이름-개체 매핑을 특정 XAML 이름 범위에 저장하거나 검색하는 INameScope 메서드에 대한 기본 WPF 지원을 구현합니다.Implements base WPF support for the INameScope methods that store or retrieve name-object mappings into a particular XAML namescope. 요소 수준에서 더 간단하게 XAML 이름 범위 이름을 동적으로 가져오거나 설정할 수 있도록 연결된 속성 지원을 추가합니다.Adds attached property support to make it simpler to get or set XAML namescope names dynamically at the element level.

public ref class NameScope : System::Collections::Generic::ICollection<System::Collections::Generic::KeyValuePair<System::String ^, System::Object ^>>, System::Collections::Generic::IDictionary<System::String ^, System::Object ^>, System::Collections::Generic::IEnumerable<System::Collections::Generic::KeyValuePair<System::String ^, System::Object ^>>, System::Windows::Markup::INameScopeDictionary
public class NameScope : System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<string,object>>, System.Collections.Generic.IDictionary<string,object>, System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<string,object>>, System.Windows.Markup.INameScopeDictionary
type NameScope = class
    interface INameScopeDictionary
    interface INameScope
    interface IDictionary<string, obj>
    interface ICollection<KeyValuePair<string, obj>>
    interface seq<KeyValuePair<string, obj>>
    interface IEnumerable
Public Class NameScope
Implements ICollection(Of KeyValuePair(Of String, Object)), IDictionary(Of String, Object), IEnumerable(Of KeyValuePair(Of String, Object)), INameScopeDictionary
상속
NameScope
구현

설명

이 클래스는 WPF XAML 처리에 대 한 기본 제공 XAML 이름 범위 지원을 구현합니다.This class implements built-in XAML namescope support for WPF treatment of XAML. NameScope는 스타일 및 템플릿을 인스턴스화할 때와 같이 XAML 구문 분석에 따라 초기 XAML 이름 범위를 만드는 데 도움이 됩니다.NameScope assists in creation of initial XAML namescopes based on parsing XAML, such as when instantiating styles and templates. 또한 WPF XAML 프로세서 구현에서 일반 XAML 로드 요소 외부에서 발생 하는 프로세스에서 XAML 이름 범위 생성을 지원 합니다.It also supports creation of XAML namescopes by processes that occur outside of normal XAML loading of elements by the WPF XAML processor implementation.

NameScope은 일반적으로 XAML 이름 범위 작업과 관련 된 일반적인 사용자 코드 시나리오 보다 인프라를 제공 하기 위한 것입니다.NameScope is generally more devoted to supplying infrastructure than for common user code scenarios that involve working with a XAML namescope. 대부분의 시나리오에서 FrameworkElementFrameworkContentElement에 노출 되는 FindName 메서드는 XAML 정의 이름으로 요소를 검색 하기 위해 호출 하는 더 적절 한 메서드입니다.For most scenarios, the FindName methods exposed on FrameworkElement and FrameworkContentElement are more appropriate methods to call to search for elements by XAML-defined name. FrameworkElementFrameworkContentElement에서 노출 하는 Name 속성은 초기 이름을 태그 특성으로 설정 하는 데 사용할 수 있는 더 적절 한 속성입니다.The Name properties exposed by FrameworkElement and FrameworkContentElement are more appropriate properties to use to set the initial name as markup attributes.

NameScope의 다양 한 메서드는 RegisterNameFindName를 지원 하기 위해 XAML 이름 범위를 유지 하는 기본 요소 및 다른 클래스에서 사용 됩니다.The various methods of NameScope are used by base elements and other classes that maintain XAML namescopes in order to support RegisterName and FindName. 일반적으로 XAML 페이지의 루트 요소에 대해 XAML 이름 범위를 처리 하는 방법 및 템플릿의 일부로 (페이지의 나머지 부분에서 별도의 XAML 이름 범위를 사용 하는) 기본 요소 동작을 교체 하거나 확대 하는 경우에만 NameScope 클래스에서 API를 사용 합니다.You generally use the API in the NameScope class only if you are replacing or augmenting the base element behavior for how they process XAML namescopes for root elements of a XAML page, and as part of templates (which use a separate XAML namescope from the rest of the page).

.NET Framework 4.NET Framework 4에서 NameScopeAdd 메서드를 호출 하 여 XAML 이름 범위가 보유 하 고 있는 이름의 컬렉션에 액세스할 수 있도록 컬렉션 인터페이스 구현을 제공 합니다.In .NET Framework 4.NET Framework 4, NameScope provides collection interface implementations such that you can access the collections of names that are held by a XAML namescope, including adding to it through calls to an Add method.

XAML 이름 범위 개념에 대 한 자세한 내용은 WPF XAML 이름 범위를 참조 하세요.For more information on XAML namescope concepts, see WPF XAML Namescopes.

XAML 이름 범위에서 이름은 NameScope API 입력에 사용할 수 있는 문자열을 제한 하는 특정 문법을 사용 해야 합니다.Names in a XAML namescope must use a particular grammar that restricts the strings you might use for inputs of NameScope API. XamlName 문법을참조 하세요.See XamlName Grammar.

생성자

NameScope()

NameScope 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the NameScope class.

필드

NameScopeProperty

NameScope 연결된 속성을 식별합니다.Identifies the NameScope attached property.

속성

Count

NameScope의 매핑된 이름 컬렉션에 있는 항목 수를 반환합니다.Returns the number of items in the collection of mapped names in this NameScope.

IsReadOnly

컬렉션이 읽기 전용인지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the collection is read-only.

Item[String]

지정된 키를 가진 항목을 가져오거나 설정합니다.Gets or sets the item with the specified key.

Keys

NameScope 사전에 있는 키의 컬렉션을 가져옵니다.Gets a collection of the keys in the NameScope dictionary.

Values

NameScope 사전에 있는 값의 컬렉션을 가져옵니다.Gets a collection of the values in the NameScope dictionary.

연결된 속성

NameScope

동적으로 연결된 NameScope 인스턴스를 가져오거나 설정합니다.Gets or sets dynamically attached NameScope instances.

메서드

Add(KeyValuePair<String,Object>)

컬렉션에 항목을 추가합니다.Adds an item to the collection.

Add(String, Object)

컬렉션에 항목을 추가합니다.Adds an item to the collection.

Clear()

컬렉션에서 모든 항목을 제거합니다.Removes all items from the collection.

Contains(KeyValuePair<String,Object>)

컬렉션에 지정된 항목이 포함되는지 여부를 확인합니다.Determines whether the collection contains a specified item.

ContainsKey(String)

제공된 이름이 이 NameScope에 이미 존재하는지 여부를 반환합니다.Returns whether a provided name already exists in this NameScope.

CopyTo(KeyValuePair<String,Object>[], Int32)

특정 배열 인덱스에서 시작하여 컬렉션의 요소를 배열에 복사합니다.Copies the elements of the collection to an array, starting at a particular array index.

Equals(Object)

지정한 개체가 현재 개체와 같은지를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
FindName(String)

제공된 이름 문자열을 기준으로 이 NameScope에 의해 유지되는 XAML 이름 범위의 해당 개체를 반환합니다.Returns the corresponding object in the XAML namescope maintained by this NameScope, based on a provided name string.

GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetNameScope(DependencyObject)

NameScope 연결된 속성에 대한 연결된 속성의 get 접근자를 제공합니다.Provides the attached property get accessor for the NameScope attached property.

GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
RegisterName(String, Object)

현재 XAML 이름 범위에 새 이름-개체 쌍을 등록합니다.Registers a new name-object pair into the current XAML namescope.

Remove(KeyValuePair<String,Object>)

컬렉션에서 특정 개체를 제거합니다.Removes the specific object from the collection.

Remove(String)

컬렉션에서 지정된 이름의 매핑을 제거합니다.Removes a mapping for a specified name from the collection.

SetNameScope(DependencyObject, INameScope)

NameScope 연결된 속성에 대한 연결된 속성의 set 접근자를 제공합니다.Provides the attached property set accessor for the NameScope attached property.

ToString()

현재 개체를 나타내는 string을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)
TryGetValue(String, Object)

지정된 키와 연결된 값을 가져옵니다.Gets the value associated with the specified key.

UnregisterName(String)

XAML 이름 범위에서 이름-개체 매핑을 제거합니다.Removes a name-object mapping from the XAML namescope.

명시적 인터페이스 구현

IEnumerable.GetEnumerator()

컬렉션 전체를 반복하는 열거자를 반환합니다.Returns an enumerator that iterates through a collection.

IEnumerable<KeyValuePair<String,Object>>.GetEnumerator()

컬렉션 전체를 반복하는 열거자를 반환합니다.Returns an enumerator that iterates through a collection.

확장 메서드

Remove<TKey,TValue>(IDictionary<TKey,TValue>, TKey, TValue)

key에서 지정된 dictionary을(를) 사용하여 값 제거하려고 시도합니다.Tries to remove the value with the specified key from the dictionary.

TryAdd<TKey,TValue>(IDictionary<TKey,TValue>, TKey, TValue)

지정된 keyvalue을(를) dictionary에 추가하려고 시도합니다.Tries to add the specified key and value to the dictionary.

CopyToDataTable<T>(IEnumerable<T>)

제네릭 매개 변수 TDataTable인 지정된 입력 DataRow 개체를 사용하여 IEnumerable<T> 개체의 복사본이 들어 있는 DataRow을 반환합니다.Returns a DataTable that contains copies of the DataRow objects, given an input IEnumerable<T> object where the generic parameter T is DataRow.

CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption)

제네릭 매개 변수 TDataRow인 지정된 입력 DataTable 개체를 사용하여 IEnumerable<T> 개체를 지정된 DataRow에 복사합니다.Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler)

제네릭 매개 변수 TDataRow인 지정된 입력 DataTable 개체를 사용하여 IEnumerable<T> 개체를 지정된 DataRow에 복사합니다.Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

Cast<TResult>(IEnumerable)

IEnumerable의 요소를 지정된 형식으로 캐스팅합니다.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

지정된 형식에 따라 IEnumerable의 요소를 필터링합니다.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

쿼리를 병렬화할 수 있도록 합니다.Enables parallelization of a query.

AsQueryable(IEnumerable)

IEnumerableIQueryable로 변환합니다.Converts an IEnumerable to an IQueryable.

Ancestors<T>(IEnumerable<T>)

소스 컬렉션에 있는 모든 노드의 상위 항목을 포함 하는 요소의 컬렉션을 반환 합니다.Returns a collection of elements that contains the ancestors of every node in the source collection.

Ancestors<T>(IEnumerable<T>, XName)

소스 컬렉션에 있는 모든 노드의 상위 항목이 들어 있는 필터링 된 요소 컬렉션을 반환 합니다.Returns a filtered collection of elements that contains the ancestors of every node in the source collection. 일치하는 XName이 있는 요소만 컬렉션에 포함됩니다.Only elements that have a matching XName are included in the collection.

DescendantNodes<T>(IEnumerable<T>)

소스 컬렉션에 있는 모든 문서 및 요소의 하위 노드의 컬렉션을 반환합니다.Returns a collection of the descendant nodes of every document and element in the source collection.

Descendants<T>(IEnumerable<T>)

소스 컬렉션에 있는 모든 요소 및 문서의 하위 요소가 들어 있는 요소 컬렉션을 반환합니다.Returns a collection of elements that contains the descendant elements of every element and document in the source collection.

Descendants<T>(IEnumerable<T>, XName)

소스 컬렉션에 있는 모든 요소 및 문서의 하위 요소가 들어 있는 필터링된 요소 컬렉션을 반환합니다.Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. 일치하는 XName이 있는 요소만 컬렉션에 포함됩니다.Only elements that have a matching XName are included in the collection.

Elements<T>(IEnumerable<T>)

소스 컬렉션에 있는 자식 컬렉션의 모든 요소 및 문서의 요소를 반환합니다.Returns a collection of the child elements of every element and document in the source collection.

Elements<T>(IEnumerable<T>, XName)

소스 컬렉션의 필터링 된 자식 컬렉션을 모든 요소 및 문서의 요소를 반환합니다.Returns a filtered collection of the child elements of every element and document in the source collection. 일치하는 XName이 있는 요소만 컬렉션에 포함됩니다.Only elements that have a matching XName are included in the collection.

InDocumentOrder<T>(IEnumerable<T>)

모든 노드가 문서 순으로 정렬 된 소스 컬렉션에 포함 된 노드의 컬렉션을 반환 합니다.Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.

Nodes<T>(IEnumerable<T>)

소스 컬렉션에 있는 자식 컬렉션의 모든 문서 및 요소의 노드를 반환합니다.Returns a collection of the child nodes of every document and element in the source collection.

Remove<T>(IEnumerable<T>)

부모 노드에서 소스 컬렉션에 있는 모든 노드를 제거합니다.Removes every node in the source collection from its parent node.

적용 대상

추가 정보