FrameworkElement.Resources Propriedade

Definição

Obtém ou define o dicionário 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 da propriedade

O dicionário atual de recursos definido localmente, em que cada recurso pode ser acessado por chave.The current locally-defined dictionary of resources, where each resource can be accessed by key.

Implementações

System.Windows.Markup.IHaveResources.Resources
Atributos

Comentários

Os dicionários de recursos que podem ser definidos de forma completa ou parcial em XAML (linguagem XAML)Extensible Application Markup Language (XAML) normalmente são criados como um elemento de propriedade e normalmente estão no elemento raiz para qualquer página individual ou para o aplicativo.Resource dictionaries that can be defined completely or partially in XAML (linguagem XAML)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. Colocar o dicionário de recursos nesse nível facilita a localização de elementos filho individuais na página (ou de qualquer página, no caso do aplicativo).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). Na maioria dos cenários de aplicativo, recomendamos que os estilos sejam definidos como elementos de objeto dentro de um dicionário de recursos ou sejam definidos como recursos externos para que todo o recurso de estilo possa ser independente (essa abordagem ajuda o designer separado responsabilidades de responsabilidades de desenvolvedor, separando os arquivos físicos que precisam ser editados).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).

Observe que essa propriedade retorna apenas o dicionário de recursos declarado diretamente dentro desse elemento.Note that this property returns only the resource dictionary declared directly within that element. Isso é diferente do processo de pesquisa de recurso real, em que um elemento filho pode acessar qualquer um dos recursos definidos em cada elemento pai, Pesquisando recursivamente em cima.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.

Os recursos também podem ser referenciados pelo código de dentro da coleção, mas lembre-se de que os recursos criados no XAMLXAML definitivamente não estarão acessíveis até que o Loaded seja gerado pelo elemento que declara o dicionário.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. Na verdade, os recursos são analisados de forma assíncrona e nem mesmo o evento Loaded é uma garantia de que você pode referenciar um recurso XAMLXAML 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 esse motivo, geralmente você só deve acessar XAMLXAML recursos definidos como parte do código em tempo de execução, ou por meio de outras técnicas de XAMLXAML, como estilos ou referências de extensão de recurso para 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. Quando você acessa recursos por meio de código, ele é essencialmente equivalente a uma referência DynamicResource feita a partir de XAMLXAML.When you access resources through code, it is essentially equivalent to a DynamicResource reference made from XAMLXAML.

O ResourceDictionary subjacente dá suporte aos métodos necessários para adicionar, remover ou consultar recursos de dentro da coleção usando código.The underlying ResourceDictionary supports the methods required to add, remove or query resources from within the collection by using code. A propriedade Resources é configurável para dar suporte ao cenário de substituir completamente a coleção de recursos de um elemento para ser uma ResourceDictionarynova ou 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 a sintaxe de XAMLXAML mostrada não inclui um elemento para o ResourceDictionary.Notice that the XAMLXAML syntax shown does not include an element for the ResourceDictionary. Este é um exemplo de sintaxe de coleção implícita; uma marca que representa o elemento de coleção pode ser omitida.This is an example of implicit collection syntax; a tag representing the collection element can be omitted. Em vez disso, os elementos adicionados como itens à coleção são especificados.The elements that are added as items to the collection are specified instead. Para obter mais informações sobre coleções e XAMLXAMLimplícitas, consulte sintaxe XAML em detalhes.For more information about implicit collections and XAMLXAML, see XAML Syntax In Detail. Um caso em que um ResourceDictionary ainda é especificado explicitamente como um elemento é se você estiver introduzindo um dicionário mesclado; nesse caso, normalmente não há nenhum elemento filho para esse ResourceDictionary.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 obter detalhes, consulte dicionários de Recursos mesclados.For details, see Merged Resource Dictionaries.

Uso do elemento propriedade XAMLXAML Property Element Usage

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

Valores XAMLXAML Values

oneOrMoreResourceElementsoneOrMoreResourceElements
Um ou mais elementos de objeto, cada um deles define um recurso.One or more object elements, each of which defines a resource. Cada elemento de propriedade de recurso dentro de cada ResourceDictionary deve ter um valor exclusivo para a diretiva x:Key, que serve como a chave exclusiva quando os valores são recuperados do ResourceDictionary.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.

Aplica-se a

Veja também