NameScope Clase

Definición

Implementa compatibilidad base con WPF para los métodos INameScope que almacenan o recuperan asignaciones de nombre y objeto en un ámbito de nombres XAML determinado.Implements base WPF support for the INameScope methods that store or retrieve name-object mappings into a particular XAML namescope. Agrega compatibilidad con propiedades asociadas para que sea más fácil obtener o establecer nombres de ámbito de nombres XAML dinámicamente en el nivel del 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
Herencia
NameScope
Implementaciones

Comentarios

Esta clase implementa la compatibilidad integrada con el ámbito de nombres XAML para el tratamiento de WPF de XAML.This class implements built-in XAML namescope support for WPF treatment of XAML. NameScope ayuda en la creación de ámbitos de código XAML iniciales basados en el análisis de XAML, como al crear instancias de estilos y plantillas.NameScope assists in creation of initial XAML namescopes based on parsing XAML, such as when instantiating styles and templates. También admite la creación de ámbitos de código XAML mediante procesos que se producen fuera de la carga de XAML normal de elementos por parte de la implementación del procesador XAML de 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 suele estar dedicado a proporcionar una infraestructura que para escenarios de código de usuario comunes que implican trabajar con un ámbito de nombres XAML.NameScope is generally more devoted to supplying infrastructure than for common user code scenarios that involve working with a XAML namescope. En la mayoría de los escenarios, los métodos FindName que se exponen en FrameworkElement y FrameworkContentElement son métodos más adecuados para llamar a para buscar elementos mediante el nombre definido por 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. Las propiedades Name expuestas por FrameworkElement y FrameworkContentElement son propiedades más adecuadas que se pueden usar para establecer el nombre inicial como atributos de marcado.The Name properties exposed by FrameworkElement and FrameworkContentElement are more appropriate properties to use to set the initial name as markup attributes.

Los elementos base y otras clases que mantienen ámbitos de código XAML usan los distintos métodos de NameScope para admitir RegisterName y 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. Normalmente se usa la API en la clase NameScope solo si se reemplaza o aumenta el comportamiento del elemento base en el modo en que procesa ámbitos de nombres XAML para los elementos raíz de una página XAML y como parte de las plantillas (que usan un ámbito de nombres XAML independiente del resto de la 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).

En .NET Framework 4.NET Framework 4, NameScope proporciona implementaciones de interfaz de colección, de modo que puede tener acceso a las colecciones de nombres que se encuentran en un ámbito de nombres XAML, incluida la adición a ella a través de llamadas a un 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 obtener más información sobre los conceptos del ámbito de nombres XAML, vea ámbitos de nombres XAML de WPF.For more information on XAML namescope concepts, see WPF XAML Namescopes.

Los nombres de un ámbito de nombres XAML deben usar una gramática concreta que restrinja las cadenas que se pueden usar para las entradas de la API NameScope.Names in a XAML namescope must use a particular grammar that restricts the strings you might use for inputs of NameScope API. Consulte gramática de XamlName.See XamlName Grammar.

Constructores

NameScope()

Inicializa una nueva instancia de la clase NameScope.Initializes a new instance of the NameScope class.

Campos

NameScopeProperty

Identifica la propiedad adjunta NameScope.Identifies the NameScope attached property.

Propiedades

Count

Devuelve el número de elementos de la colección de nombres asignados de esta clase NameScope.Returns the number of items in the collection of mapped names in this NameScope.

IsReadOnly

Obtiene un valor que indica si la colección es de solo lectura.Gets a value indicating whether the collection is read-only.

Item[String]

Obtiene o establece el elemento con la clave especificada.Gets or sets the item with the specified key.

Keys

Obtiene una colección de las claves del diccionario de NameScope.Gets a collection of the keys in the NameScope dictionary.

Values

Obtiene una colección de los valores del diccionario de NameScope.Gets a collection of the values in the NameScope dictionary.

Propiedades adjuntas

NameScope

Obtiene o establece instancias de NameScope dinámicamente asociadas.Gets or sets dynamically attached NameScope instances.

Métodos

Add(KeyValuePair<String,Object>)

Agrega un elemento a la colección.Adds an item to the collection.

Add(String, Object)

Agrega un elemento a la colección.Adds an item to the collection.

Clear()

Quita todos los elementos de la colección.Removes all items from the collection.

Contains(KeyValuePair<String,Object>)

Determina si la colección contiene el elemento especificado.Determines whether the collection contains a specified item.

ContainsKey(String)

Devuelve un valor que indica si el nombre proporcionado ya existe en esta clase NameScope.Returns whether a provided name already exists in this NameScope.

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

Copia los elementos de la colección en una matriz a partir de un índice de matriz concreto.Copies the elements of the collection to an array, starting at a particular array index.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
FindName(String)

Devuelve el objeto correspondiente del ámbito de nombres XAML que mantiene este elemento NameScope, según una cadena de nombre proporcionada.Returns the corresponding object in the XAML namescope maintained by this NameScope, based on a provided name string.

GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetNameScope(DependencyObject)

Proporciona el descriptor de acceso get de la propiedad adjunta para la propiedad adjunta NameScope.Provides the attached property get accessor for the NameScope attached property.

GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
RegisterName(String, Object)

Registra un nuevo par de nombre y objeto en el ámbito de nombres XAML actual.Registers a new name-object pair into the current XAML namescope.

Remove(KeyValuePair<String,Object>)

Quita el objeto especificado de la colección.Removes the specific object from the collection.

Remove(String)

Quita de la colección una asignación del nombre especificado.Removes a mapping for a specified name from the collection.

SetNameScope(DependencyObject, INameScope)

Proporciona el descriptor de acceso set de la propiedad adjunta para la propiedad adjunta NameScope.Provides the attached property set accessor for the NameScope attached property.

ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)
TryGetValue(String, Object)

Obtiene el valor asociado a la clave especificada.Gets the value associated with the specified key.

UnregisterName(String)

Quita una asignación del objeto de nombre del ámbito de nombres XAML.Removes a name-object mapping from the XAML namescope.

Implementaciones de interfaz explícitas

IEnumerable.GetEnumerator()

Devuelve un enumerador que recorre en iteración una colección.Returns an enumerator that iterates through a collection.

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

Devuelve un enumerador que recorre en iteración una colección.Returns an enumerator that iterates through a collection.

Métodos de extensión

Remove<TKey,TValue>(IDictionary<TKey,TValue>, TKey, TValue)
TryAdd<TKey,TValue>(IDictionary<TKey,TValue>, TKey, TValue)
CopyToDataTable<T>(IEnumerable<T>)

Devuelve un objeto DataTable que contiene copias de los objetos DataRow, dado un objeto IEnumerable<T> de entrada donde el parámetro T genérico es 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 en el objeto DataTable especificado, dado un objeto IEnumerable<T> de entrada donde el parámetro T genérico es 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 en el objeto DataTable especificado, dado un objeto IEnumerable<T> de entrada donde el parámetro T genérico es DataRow.Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Ancestors<T>(IEnumerable<T>)

Devuelve una colección de elementos que contiene los antecesores de todos los nodos de la colección de origen.Returns a collection of elements that contains the ancestors of every node in the source collection.

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

Devuelve una colección de elementos filtrada que contiene los antecesores de todos los nodos de la colección de origen.Returns a filtered collection of elements that contains the ancestors of every node in the source collection. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.Only elements that have a matching XName are included in the collection.

DescendantNodes<T>(IEnumerable<T>)

Devuelve una colección de los nodos descendientes de todos los documentos y elementos de la colección de origen.Returns a collection of the descendant nodes of every document and element in the source collection.

Descendants<T>(IEnumerable<T>)

Devuelve una colección de elementos que contiene los elementos descendientes de todos los elementos y documentos de la colección de origen.Returns a collection of elements that contains the descendant elements of every element and document in the source collection.

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

Devuelve una colección filtrada de elementos que contiene los elementos descendientes de todos los elementos y documentos de la colección de origen.Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.Only elements that have a matching XName are included in the collection.

Elements<T>(IEnumerable<T>)

Devuelve una colección de los elementos secundarios de todos los elementos y documentos de la colección de origen.Returns a collection of the child elements of every element and document in the source collection.

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

Devuelve una colección filtrada de los elementos secundarios de todos los elementos y documentos de la colección de origen.Returns a filtered collection of the child elements of every element and document in the source collection. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.Only elements that have a matching XName are included in the collection.

InDocumentOrder<T>(IEnumerable<T>)

Devuelve una colección de nodos que contiene todos los nodos de la colección de origen, clasificados por documento.Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.

Nodes<T>(IEnumerable<T>)

Devuelve una colección de los nodos secundarios de todos los documentos y elementos de la colección de origen.Returns a collection of the child nodes of every document and element in the source collection.

Remove<T>(IEnumerable<T>)

Quita todos los nodos de la colección de origen de su nodo primario.Removes every node in the source collection from its parent node.

Se aplica a

Consulte también: