NameScope Classe

Definição

Implementa suporte básico WPF para os métodos INameScope que armazenam ou recuperam os mapeamentos nome-objeto em um namescope XAML específico.Implements base WPF support for the INameScope methods that store or retrieve name-object mappings into a particular XAML namescope. Adiciona o suporte à propriedade anexada para simplificar a obtenção ou definição de nomes de namescopes XAML dinamicamente no nível de elemento.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
Herança
NameScope
Implementações

Comentários

Essa classe implementa o suporte ao namescope XAML interno para o tratamento WPF de XAML.This class implements built-in XAML namescope support for WPF treatment of XAML. NameScope ajuda na criação de namescopes de XAML iniciais com base na análise de XAML, como ao instanciar estilos e modelos.NameScope assists in creation of initial XAML namescopes based on parsing XAML, such as when instantiating styles and templates. Ele também dá suporte à criação de namescopes XAML por processos que ocorrem fora do carregamento XAML normal de elementos pela implementação do processador XAML do 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.

em geral, o NameScope é mais dedicado a fornecer infraestrutura do que para cenários de código de usuário comuns que envolvem trabalhar com um namescope XAML.NameScope is generally more devoted to supplying infrastructure than for common user code scenarios that involve working with a XAML namescope. Para a maioria dos cenários, os métodos de FindName expostos em FrameworkElement e FrameworkContentElement são métodos mais apropriados para chamar a pesquisa de elementos por nome definido pelo 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. As propriedades Name expostas por FrameworkElement e FrameworkContentElement são propriedades mais apropriadas a serem usadas para definir o nome inicial como atributos de marcação.The Name properties exposed by FrameworkElement and FrameworkContentElement are more appropriate properties to use to set the initial name as markup attributes.

Os vários métodos de NameScope são usados por elementos base e outras classes que mantêm namescopes XAML para dar suporte a RegisterName e 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. Você geralmente usa a API na classe NameScope somente se você estiver substituindo ou aumentando o comportamento do elemento base para como eles processam namescopes XAML para elementos raiz de uma página XAML e como parte dos modelos (que usam um namescope XAML separado do resto da página).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).

Em .NET Framework 4.NET Framework 4, NameScope fornece implementações de interface de coleção, de modo que você pode acessar as coleções de nomes mantidas por um namescope XAML, incluindo a adição a ela por meio de chamadas para um método 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.

Para obter mais informações sobre conceitos de namescope XAML, consulte WPF XAML namescopes.For more information on XAML namescope concepts, see WPF XAML Namescopes.

Nomes em um namescope XAML devem usar uma gramática específica que restringe as cadeias de caracteres que você pode usar para entradas de NameScope API.Names in a XAML namescope must use a particular grammar that restricts the strings you might use for inputs of NameScope API. Consulte XamlName gramática.See XamlName Grammar.

Construtores

NameScope()

Inicializa uma nova instância da classe NameScope.Initializes a new instance of the NameScope class.

Campos

NameScopeProperty

Identifica a propriedade NameScope anexada.Identifies the NameScope attached property.

Propriedades

Count

Retorna o número de itens na coleção de nomes mapeados neste NameScope.Returns the number of items in the collection of mapped names in this NameScope.

IsReadOnly

Obtém um valor que indica se a coleção é somente leitura.Gets a value indicating whether the collection is read-only.

Item[String]

Obtém ou define o item com a chave especificada.Gets or sets the item with the specified key.

Keys

Obtém uma coleção das chaves no dicionário NameScope.Gets a collection of the keys in the NameScope dictionary.

Values

Obtém uma coleção dos valores no dicionário NameScope.Gets a collection of the values in the NameScope dictionary.

Propriedades Anexadas

NameScope

Obtém ou define instâncias NameScope dinamicamente anexadas.Gets or sets dynamically attached NameScope instances.

Métodos

Add(KeyValuePair<String,Object>)

Adiciona um item à coleção.Adds an item to the collection.

Add(String, Object)

Adiciona um item à coleção.Adds an item to the collection.

Clear()

Remove todos os itens da coleção.Removes all items from the collection.

Contains(KeyValuePair<String,Object>)

Determina se a coleção contém um item especificado.Determines whether the collection contains a specified item.

ContainsKey(String)

Retorna a informação de se um nome fornecido já existe ou não neste NameScope.Returns whether a provided name already exists in this NameScope.

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

Copia os elementos da coleção em uma matriz, começando em um índice de matriz específico.Copies the elements of the collection to an array, starting at a particular array index.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
FindName(String)

Retorna o objeto correspondente no namescope XAML mantido por este NameScope, com base em uma cadeia de caracteres de nome fornecida.Returns the corresponding object in the XAML namescope maintained by this NameScope, based on a provided name string.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetNameScope(DependencyObject)

Fornece o acessador get da propriedade anexada NameScope.Provides the attached property get accessor for the NameScope attached property.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
RegisterName(String, Object)

Registra um novo par nome/objeto dentro do namescope XAML atual.Registers a new name-object pair into the current XAML namescope.

Remove(KeyValuePair<String,Object>)

Remove o objeto específico da coleção.Removes the specific object from the collection.

Remove(String)

Remove um mapeamento para um nome especificado da coleção.Removes a mapping for a specified name from the collection.

SetNameScope(DependencyObject, INameScope)

Fornece o acessador set da propriedade anexada NameScope.Provides the attached property set accessor for the NameScope attached property.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
TryGetValue(String, Object)

Obtém o valor associado à chave especificada.Gets the value associated with the specified key.

UnregisterName(String)

Remove um mapeamento de nome-objeto do namescope XAML.Removes a name-object mapping from the XAML namescope.

Implantações explícitas de interface

IEnumerable.GetEnumerator()

Retorna um enumerador que itera em uma coleção.Returns an enumerator that iterates through a collection.

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

Retorna um enumerador que itera em uma coleção.Returns an enumerator that iterates through a collection.

Métodos de Extensão

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

Tenta remover o valor com o key especificado do dictionary.Tries to remove the value with the specified key from the dictionary.

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

Tenta adicionar o key e o value especificados ao dictionary.Tries to add the specified key and value to the dictionary.

CopyToDataTable<T>(IEnumerable<T>)

Retorna um DataTable que contém cópias dos objetos DataRow, dado um objeto IEnumerable<T> de entrada em que o parâmetro genérico 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)

Copia objetos DataRow no DataTable especificado, dado um objeto IEnumerable<T> de entrada em que o parâmetro genérico 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)

Copia objetos DataRow no DataTable especificado, dado um objeto IEnumerable<T> de entrada em que o parâmetro genérico 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)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Ancestors<T>(IEnumerable<T>)

Retorna uma coleção de elementos que contém os ancestrais de cada nó na coleção de origem.Returns a collection of elements that contains the ancestors of every node in the source collection.

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

Retorna uma coleção filtrada de elementos que contém os ancestrais de cada nó na coleção de origem.Returns a filtered collection of elements that contains the ancestors of every node in the source collection. Somente os elementos que têm um XName correspondente são incluídos na coleção.Only elements that have a matching XName are included in the collection.

DescendantNodes<T>(IEnumerable<T>)

Retorna uma coleção dos nós descendentes de todos os documentos e elementos na coleção de origem.Returns a collection of the descendant nodes of every document and element in the source collection.

Descendants<T>(IEnumerable<T>)

Retorna uma coleção de elementos que contém os elementos descendentes de cada elemento e o documento na coleção de origem.Returns a collection of elements that contains the descendant elements of every element and document in the source collection.

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

Retorna uma coleção filtrada de elementos que contém os elementos descendentes de cada elemento e o documento na coleção de origem.Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. Somente os elementos que têm um XName correspondente são incluídos na coleção.Only elements that have a matching XName are included in the collection.

Elements<T>(IEnumerable<T>)

Retorna uma coleção dos filhos elementos de cada elemento e o documento na coleção de origem.Returns a collection of the child elements of every element and document in the source collection.

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

Retorna uma coleção filtrada dos elementos filho de cada elemento e documento na coleção de origem.Returns a filtered collection of the child elements of every element and document in the source collection. Somente os elementos que têm um XName correspondente são incluídos na coleção.Only elements that have a matching XName are included in the collection.

InDocumentOrder<T>(IEnumerable<T>)

Retorna uma coleção de nós que contém todos os nós na coleção de origem, classificados em ordem segundo o documento.Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.

Nodes<T>(IEnumerable<T>)

Retorna uma coleção dos nós filhos de todos os documentos e elementos na coleção de origem.Returns a collection of the child nodes of every document and element in the source collection.

Remove<T>(IEnumerable<T>)

Remove todos os nós na coleção de origem do respectivo nó pai.Removes every node in the source collection from its parent node.

Aplica-se a

Veja também