ResourceDictionary Classe

Referência

Definição

Namespace:: System.Windows

Assembly:: PresentationFramework.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece uma implementação de dicionário/tabela de hash que contém recursos WPF usados por componentes e outros elementos de um aplicativo WPF.

public ref class ResourceDictionary : System::Collections::IDictionary, System::ComponentModel::ISupportInitialize, System::Windows::Markup::INameScope, System::Windows::Markup::IUriContext

[System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)]
public class ResourceDictionary : System.Collections.IDictionary, System.ComponentModel.ISupportInitialize, System.Windows.Markup.INameScope, System.Windows.Markup.IUriContext

[System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)]
[System.Windows.Markup.Ambient]
[System.Windows.Markup.UsableDuringInitialization(true)]
public class ResourceDictionary : System.Collections.IDictionary, System.ComponentModel.ISupportInitialize, System.Windows.Markup.INameScope, System.Windows.Markup.IUriContext

[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
type ResourceDictionary = class
    interface IDictionary
    interface ICollection
    interface IEnumerable
    interface INameScope
    interface ISupportInitialize
    interface IUriContext

[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
[<System.Windows.Markup.Ambient>]
[<System.Windows.Markup.UsableDuringInitialization(true)>]
type ResourceDictionary = class
    interface IDictionary
    interface ICollection
    interface IEnumerable
    interface ISupportInitialize
    interface IUriContext
    interface INameScope

[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
[<System.Windows.Markup.Ambient>]
[<System.Windows.Markup.UsableDuringInitialization(true)>]
type ResourceDictionary = class
    interface ICollection
    interface IEnumerable
    interface IDictionary
    interface ISupportInitialize
    interface INameScope
    interface IUriContext

Public Class ResourceDictionary
Implements IDictionary, INameScope, ISupportInitialize, IUriContext

Herança: Object
ResourceDictionary

Derivado: System.Activities.Core.Presentation.Themes.DesignerStylesDictionary

Atributos: LocalizabilityAttribute AmbientAttribute UsableDuringInitializationAttribute

Implementações: ICollection IDictionary IEnumerable ISupportInitialize INameScope IUriContext

Comentários

Os itens em um ResourceDictionary não são processados imediatamente quando o código do aplicativo é carregado por um carregador XAML. Em vez disso, o ResourceDictionary persiste como um objeto e os valores individuais são processados somente quando são solicitados especificamente.

A ResourceDictionary classe não é derivada de DictionaryBase. Em vez disso, a ResourceDictionary classe implementa IDictionary , mas depende de um Hashtable internamente.

Em XAML (Extensible Application Markup Language), a ResourceDictionary classe normalmente é um elemento de coleção implícita que é o valor do elemento objeto de várias Resources propriedades, quando fornecido na sintaxe do elemento de propriedade. Para obter detalhes sobre coleções implícitas em XAML, consulte Sintaxe XAML em detalhes. Uma exceção é quando você deseja especificar um dicionário mesclado; para obter detalhes, consulte Dicionários de recursos mesclados.

Outro uso possível de XAML é declarar um dicionário de recursos como um arquivo XAML discreto e carregá-lo em tempo de execução com Load ou incluí-lo em um projeto (de confiança total) como um recurso ou arquivo solto. Nesse caso, ResourceDictionary pode ser declarado como um elemento de objeto, servindo como o elemento raiz do XAML. Você deve mapear os valores de namespace de XML apropriados (padrão para o namespace do WPF e, normalmente x: , para o namespace XAML) para o ResourceDictionary elemento se você planeja usá-lo como o elemento raiz. Em seguida, você pode adicionar elementos filho que definem os recursos, cada um com um valor x:Key .

Uso de coleção implícita XAML

<object>  
  <object.resourcesProperty>  
    oneOrMoreResources  
  </object.resourcesProperty>  
</object>

Valores XAML

resourcesProperty
Uma propriedade que especifica um elemento de propriedade, em que o tipo de valor dessa propriedade é ResourceDictionary. Normalmente, essa é a Resources propriedade de FrameworkElement ou FrameworkContentElementou de em um caso de recursos de Application aplicativo.

oneOrMoreResources
Um ou mais recursos especificados como elementos de objeto. Cada recurso especificado deve ter uma Diretiva x:Key atribuída.

Construtores

ResourceDictionary()

Inicializa uma nova instância da classe ResourceDictionary.

Propriedades

Count	Obtém o número de entradas no ResourceDictionary de base.
DeferrableContent	Obtém ou define o conteúdo de adiável para esse dicionário de recursos.
InvalidatesImplicitDataTemplateResources	Obterá ou definirá um valor que indica se as invalidações acionadas pelo objeto ResourceDictionary fizerem os objetos ContentPresenter reavaliarem sua escolha de modelo. As invalidações ocorrem quando um recurso de modelo de dados é alterado.
IsFixedSize	Obtém se este ResourceDictionary é de tamanho fixo.
IsReadOnly	Obtém se este ResourceDictionary é somente leitura.
Item[Object]	Obtém ou define o valor associado à chave especificada.
Keys	Obtém uma coleção de todas as chaves contidas neste ResourceDictionary.
MergedDictionaries	Obtém uma coleção dos dicionários ResourceDictionary que constituem os vários dicionários de recursos nos dicionários mesclados.
Source	Obtém ou define o URI (Uniform Resource Identifier) do qual carregar recursos.
Values	Obtém uma coleção de todos os valores associados às chaves contidas neste ResourceDictionary.

Métodos

Add(Object, Object)	Adiciona um recurso por chave para este ResourceDictionary.
BeginInit()	Começa a fase de inicialização para este ResourceDictionary.
Clear()	Limpa todas as chaves (e valores) no ResourceDictionary base. Isso não limpa nenhum item de dicionário mesclado.
Contains(Object)	Determina se o ResourceDictionary contém um elemento com a chave especificada.
CopyTo(DictionaryEntry[], Int32)	Copia os elementos ResourceDictionary para um objeto DictionaryEntry unidimensional no índice especificado.
EndInit()	Termina a fase de inicialização e invalida a árvore anterior de modo que todas as alterações feitas às chaves durante a fase de inicialização podem ser consideradas.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindName(String)	Não é compatível com esta implementação de Dicionário.
GetEnumerator()	Retorna um IDictionaryEnumerator que pode ser usado para iterar pelo ResourceDictionary.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnGettingValue(Object, Object, Boolean)	Ocorre quando o ResourceDictionary recebe uma solicitação para um recurso.
RegisterName(String, Object)	Não é compatível com esta implementação de Dicionário.
Remove(Object)	Remove a entrada com a chave especificada do dicionário de base.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
UnregisterName(String)	Não é compatível com esta implementação de Dicionário.

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)	Para obter uma descrição desse membro, confira CopyTo(Array, Int32).
ICollection.IsSynchronized	Para obter uma descrição desse membro, confira IsSynchronized.
ICollection.SyncRoot	Para obter uma descrição desse membro, confira SyncRoot.
IEnumerable.GetEnumerator()	Para obter uma descrição desse membro, confira GetEnumerator().
IUriContext.BaseUri	Para obter uma descrição desse membro, confira BaseUri.

Métodos de Extensão

Cast<TResult>(IEnumerable)	Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.

Aplica-se a

Compartilhar via