ResourceDictionary.MergedDictionaries Propriedade

public:
 property IVector<ResourceDictionary ^> ^ MergedDictionaries { IVector<ResourceDictionary ^> ^ get(); };

IVector<ResourceDictionary> MergedDictionaries();

public IList<ResourceDictionary> MergedDictionaries { get; }

var iVector = resourceDictionary.mergedDictionaries;

Public ReadOnly Property MergedDictionaries As IList(Of ResourceDictionary)

<ResourceDictionary>
  <ResourceDictionary.MergedDictionaries>
    oneOrMoreResourceDictionaryElements
  </ResourceDictionary.MergedDictionaries>
</ResourceDictionary>

Valor da propriedade

Uma coleção de listas dos dicionários ResourceDictionary que constituem os vários dicionários de recursos nos dicionários mesclados.

Exemplos

Os modelos de Microsoft Visual Studio inicial para um aplicativo SDK do Aplicativo Windows usando C++ ou C# incluem um MergedDictionaries nó no arquivo app.xaml. Isso faz referência a um ResourceDictionary XAML separado no projeto que contém algumas definições básicas de modelo de controle. Você pode modificar o XAML no ResourceDictionary para personalizar a aparência dos controles.

<Application
    ....
>
    <Application.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                <ResourceDictionary Source="Common/StandardStyles.xaml"/>
            </ResourceDictionary.MergedDictionaries>
        </ResourceDictionary>
    </Application.Resources>
</Application>

Comentários

Definir um MergedDictionaries valor permite compartilhar um arquivo XAML ResourceDictionary entre várias páginas ou também como um arquivo comum que você pode adicionar a vários projetos de aplicativo. Isso fornece uma técnica útil de fatoramento e reutilização para recursos do ponto de vista de desenvolvimento e design. Normalmente, você inclui o arquivo XAML como um item de conteúdo como parte do projeto e do manifesto do aplicativo.

Os recursos chaveados em qualquer MergedDictionaries XAML não precisam ser exclusivos versus as chaves, conforme encontrado no ResourceDictionary primário para Application.Resources ou FrameworkElement.Resources, e a ordem de pesquisa de chaves procurará primeiro no dicionário primário. Isso permite uma técnica pela qual você pode substituir qualquer valor de chave obtido em MergedDictionaries arquivos XAML, mas também pode ter os dicionários mesclados disponíveis como um fallback ou como um conjunto geral de recursos não personalizados.

Você pode incluir mais de um ResourceDictionary em um MergedDictionaries conjunto para fornecer uma sequência de fallback mesmo dentro do MergedDictionaries conjunto.

Para obter mais informações sobre como usar MergedDictionaries e a sequência de pesquisa de recursos, consulte as referências de recurso ResourceDictionary e XAML.

ThemeDictionaries é uma propriedade relacionada que também mescla fontes adicionais do XAML ResourceDictionary no conjunto geral de recursos com chave, em que o cenário é para fornecer recursos relacionados ao tema para controles.

Alterar o conteúdo da coleção de itens MergedDictionariesResourceDictionary não é um cenário comum. Geralmente, você estabelece o conteúdo da coleção em XAML e não o altera em runtime. Não há muitos cenários em que você acesse a coleção em si no código em tempo de execução. Normalmente, você depende da pesquisa de recursos interna que acontece no tempo de carregamento XAML ou consulta as coleções relevantes Application.Resources ou FrameworkElement.Resources que podem referenciar recursos por chave, incluindo os recursos mesclados.

Confira também

• ResourceDictionary e referências de recursos XAML