NameScope Класс

Определение

Реализует базовую поддержку WPF для методов INameScope, которые сохраняют или извлекают сопоставления "имя-объект" в определенную область имен XAML.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
Реализации

Комментарии

Этот класс реализует встроенную поддержку области имен XAML для WPF-обработки 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. Он также поддерживает создание областей имен XAML с помощью процессов, которые происходят вне обычной загрузки XAML элементов с помощью реализации обработчика XAML WPF.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. В большинстве случаев методы FindName, предоставляемые в FrameworkElement и FrameworkContentElement, являются более подходящими методами для поиска элементов по имени, определенному 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. Свойства Name, предоставляемые FrameworkElement и FrameworkContentElement, являются более подходящими свойствами, которые используются для задания начального имени в качестве атрибутов разметки.The Name properties exposed by FrameworkElement and FrameworkContentElement are more appropriate properties to use to set the initial name as markup attributes.

Различные методы NameScope используются базовыми элементами и другими классами, которые поддерживают области имен XAML для поддержки RegisterName и FindName.The various methods of NameScope are used by base elements and other classes that maintain XAML namescopes in order to support RegisterName and FindName. Обычно API используется в классе NameScope только в том случае, если вы заменяете или дополняете поведение базового элемента для обработки областей видимости имен XAML для корневых элементов страницы XAML и как часть шаблонов (которая использует отдельную область имен XAML из оставшейся части страницы).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 NameScope предоставляет реализации интерфейса коллекции таким способом, что можно получить доступ к коллекциям имен, которые хранятся в области имен XAML, включая добавление в него посредством вызовов метода Add.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 см. в разделе области имен XAML WPF.For more information on XAML namescope concepts, see WPF XAML Namescopes.

Имена в области имен XAML должны использовать определенную грамматику, которая ограничит строки, которые можно использовать для входных данных API NameScope.Names in a XAML namescope must use a particular grammar that restricts the strings you might use for inputs of NameScope API. См. раздел грамматика имяxaml.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)

Возвращает соответствующий объект в области имен XAML, поддерживаемой данным NameScope, на основании заданной строки имени.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)

Предоставляет метод доступа get присоединенного свойства для присоединенного свойства NameScope.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)

Предоставляет метод доступа set присоединенного свойства для присоединенного свойства NameScope.Provides the attached property set accessor for the NameScope attached property.

ToString()

Возвращает строку, представляющую текущий объект.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)
TryAdd<TKey,TValue>(IDictionary<TKey,TValue>, TKey, TValue)
CopyToDataTable<T>(IEnumerable<T>)

Возвращает объект DataTable, содержащий копии объектов DataRow при заданном входном объекте IEnumerable<T> и универсальном параметре 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)

Копирует объекты DataRow в указанный объект DataTable с заданным входным объектом IEnumerable<T>, где универсальный параметр 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)

Копирует объекты DataRow в указанный объект DataTable с заданным входным объектом IEnumerable<T>, где универсальный параметр 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)

Преобразовывает коллекцию IEnumerable в объект IQueryable.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.

Применяется к

Дополнительно