FrameworkElement.Resources FrameworkElement.Resources FrameworkElement.Resources FrameworkElement.Resources Property

Definición

Obtiene o establece el diccionario de recursos definido localmente.Gets or sets the locally-defined resource dictionary.

public:
 property System::Windows::ResourceDictionary ^ Resources { System::Windows::ResourceDictionary ^ get(); void set(System::Windows::ResourceDictionary ^ value); };
[System.Windows.Markup.Ambient]
public System.Windows.ResourceDictionary Resources { get; set; }
member this.Resources : System.Windows.ResourceDictionary with get, set
Public Property Resources As ResourceDictionary

Valor de propiedad

El diccionario de recursos actual definido localmente, donde se puede obtener acceso a cada recurso por clave.The current locally-defined dictionary of resources, where each resource can be accessed by key.

Comentarios

Los diccionarios de recursos que se pueden definir completamente o Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML) parcialmente en se crean normalmente como un elemento de propiedad y suelen estar en el elemento raíz de cualquier página individual o de la aplicación.Resource dictionaries that can be defined completely or partially in Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML) are typically created as a property element, and are typically on the root element for any individual page or for the application. La colocación del Diccionario de recursos en este nivel facilita la búsqueda de elementos secundarios individuales en la página (o desde cualquier página, en el caso de la aplicación).Placing the resource dictionary at this level makes it easier to find from individual child elements in the page (or from any page, in the application case). En la mayoría de los escenarios de aplicación, recomendamos que los estilos se definan como elementos de objeto dentro de un diccionario de recursos, o que se definan como recursos externos para que todo el recurso de estilo pueda ser autónomo (este enfoque ayuda al diseñador independiente responsabilidades de las responsabilidades del desarrollador mediante la separación de los archivos físicos que es necesario editar).In most application scenarios, we recommend that styles be defined as object elements within a resource dictionary, or be defined as external resources so that the entire style resource can be self-contained (this approach helps separate designer responsibilities from developer responsibilities by separating the physical files that need to be edited).

Tenga en cuenta que esta propiedad solo devuelve el Diccionario de recursos declarado directamente dentro de ese elemento.Note that this property returns only the resource dictionary declared directly within that element. Esto es diferente del proceso de búsqueda de recursos real, en el que un elemento secundario puede tener acceso a cualquiera de los recursos definidos en cada elemento primario, buscando hacia arriba de forma recursiva.This is different than the actual resource lookup process, where a child element can access any of the resources defined in each parent element, searching recursively upwards.

También se puede hacer referencia a los recursos mediante código desde dentro de la colección, pero tenga en cuenta XAMLXAML que los recursos creados en no serán Loaded accesibles hasta que el elemento que declara el diccionario no pueda acceder a ellos.Resources can also be referenced by code from within the collection, but be aware that resources created in XAMLXAML will definitely not be accessible until after Loaded is raised by the element that declares the dictionary. De hecho, los recursos se analizan de forma asincrónica y Loaded no incluso el evento es una garantía de que XAMLXAML se puede hacer referencia a un recurso definido.In fact, resources are parsed asynchronously and not even the Loaded event is an assurance that you can reference a XAMLXAML defined resource. Por esta razón, normalmente solo debería tener XAMLXAML acceso a los recursos definidos como parte del código en tiempo de ejecución XAMLXAML o a través de otras técnicas, como estilos o referencias de extensión de recursos para los valores de atributo.For this reason you should generally only access XAMLXAML defined resources as part of run-time code, or through other XAMLXAML techniques such as styles or resource extension references for attribute values. Al tener acceso a los recursos a través del código, es esencialmente equivalente a una referencia XAMLXAMLDynamicResource realizada desde.When you access resources through code, it is essentially equivalent to a DynamicResource reference made from XAMLXAML.

El subyacente ResourceDictionary admite los métodos necesarios para agregar, quitar o consultar recursos de dentro de la colección mediante el uso de código.The underlying ResourceDictionary supports the methods required to add, remove or query resources from within the collection by using code. La Resources propiedad se puede establecer para admitir el escenario de reemplazo completo de la colección de recursos de un elemento para que sea ResourceDictionaryun nuevo o diferente.The Resources property is settable to support the scenario of completely replacing the resources collection of an element to be a new or different ResourceDictionary.

Observe que la XAMLXAML sintaxis mostrada no incluye un elemento ResourceDictionarypara.Notice that the XAMLXAML syntax shown does not include an element for the ResourceDictionary. Este es un ejemplo de sintaxis de colección implícita; se puede omitir una etiqueta que representa el elemento de la colección.This is an example of implicit collection syntax; a tag representing the collection element can be omitted. En su lugar, se especifican los elementos que se agregan como elementos a la colección.The elements that are added as items to the collection are specified instead. Para obtener más información sobre las colecciones XAMLXAMLimplícitas y, vea la Sintaxis de XAML en detalle.For more information about implicit collections and XAMLXAML, see XAML Syntax In Detail. Un caso en ResourceDictionary el que todavía se especifica explícitamente como un elemento es si se está introduciendo un diccionario combinado, en cuyo caso no suele haber elementos secundarios para ResourceDictionaryeso.One case where a ResourceDictionary is still specified explicitly as an element is if you are introducing a merged dictionary, in which case there are typically no child elements for that ResourceDictionary. Para obtener más información, consulte diccionarios de recursos combinados.For details, see Merged Resource Dictionaries.

Uso de elementos de propiedad XAMLXAML Property Element Usage

<object>  
  <object.Resources>  
    oneOrMoreResourceElements  
  </object.Resources>  
</object>  

Valores XAMLXAML Values

oneOrMoreResourceElementsoneOrMoreResourceElements
Uno o más elementos de objeto, cada uno de los cuales define un recurso.One or more object elements, each of which defines a resource. Cada elemento de propiedad de recurso ResourceDictionary de cada debe tener un valor único para la Directiva x:Key, que actúa como clave única cuando los valores ResourceDictionaryse recuperan de.Each resource property element within each ResourceDictionary must have a unique value for the x:Key Directive, which serves as the unique key when values are retrieved from the ResourceDictionary.

Se aplica a

Consulte también: