ResourceDictionary Classe

Definição

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.Provides a hash table / dictionary implementation that contains WPF resources used by components and other elements of a WPF application.

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)]
[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)]
public class ResourceDictionary : System.Collections.IDictionary, System.ComponentModel.ISupportInitialize, System.Windows.Markup.INameScope, System.Windows.Markup.IUriContext
type ResourceDictionary = class
    interface IDictionary
    interface ICollection
    interface IEnumerable
    interface ISupportInitialize
    interface IUriContext
    interface INameScope
Public Class ResourceDictionary
Implements IDictionary, INameScope, ISupportInitialize, IUriContext
Herança
ResourceDictionary
Derivado
Atributos
Implementações

Comentários

Os itens em uma ResourceDictionary não são processados imediatamente quando o código do aplicativo é carregado por um carregador de XAMLXAML.The items in a ResourceDictionary are not immediately processed when application code is loaded by a XAMLXAML loader. Em vez disso, a ResourceDictionary persiste como um objeto e os valores individuais são processados somente quando são solicitados especificamente.Instead, the ResourceDictionary persists as an object, and the individual values are processed only when they are specifically requested.

A classe ResourceDictionary não é derivada de DictionaryBase.The ResourceDictionary class is not derived from DictionaryBase. Em vez disso, a classe ResourceDictionary implementa IDictionary, mas se baseia em uma Hashtable internamente.Instead, the ResourceDictionary class implements IDictionary but relies on a Hashtable internally.

Em XAML (linguagem XAML)Extensible Application Markup Language (XAML), a classe ResourceDictionary normalmente é um elemento de coleção implícito que é o valor do elemento Object de várias propriedades Resources, quando fornecido na sintaxe do elemento Property.In XAML (linguagem XAML)Extensible Application Markup Language (XAML), the ResourceDictionary class is typically an implicit collection element that is the object element value of several Resources properties, when given in property element syntax. Para obter detalhes sobre coleções implícitas no XAMLXAML, consulte sintaxe XAML em detalhes.For details on implicit collections in XAMLXAML, see XAML Syntax In Detail. Uma exceção é quando você deseja especificar um dicionário mesclado; para obter detalhes, consulte dicionários de Recursos mesclados.An exception is when you want to specify a merged dictionary; for details, see Merged Resource Dictionaries.

Outro uso possível de XAMLXAML é declarar um dicionário de recursos como um arquivo de XAMLXAML discreto e carregá-lo em tempo de execução com Load ou incluí-lo em um projeto (confiança total) como um recurso ou arquivo flexível.Another possible XAMLXAML usage is to declare a resource dictionary as a discrete XAMLXAML file, and either load it at run time with Load or include it in a (full-trust) project as a resource or loose file. Nesse caso, ResourceDictionary pode ser declarada como um elemento Object, servindo como o elemento raiz da XAMLXAML.In this case, ResourceDictionary can be declared as an object element, serving as the root element of the XAMLXAML. Você deve mapear os valores apropriados do namespace XML (padrão para o namespace WPFWPF e, normalmente, x: para o namespace XAMLXAML) no elemento ResourceDictionary se você planeja usá-lo como o elemento raiz.You must map the appropriate XML namespace values (default for the WPFWPF namespace and typically x: for the XAMLXAML namespace) onto the ResourceDictionary element if you plan to use it as the root element. Em seguida, você pode adicionar elementos filho que definem os recursos, cada um com um valor de x:Key .Then you can add child elements that define the resources, each with an x:Key value.

Uso de coleção implícita XAMLXAML Implicit Collection Usage

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

Valores XAMLXAML Values

recursospropertyresourcesProperty
Uma propriedade que especifica um elemento de propriedade, em que o tipo de valor dessa propriedade é ResourceDictionary.A property specifying a property element, where the value type of that property is ResourceDictionary. Normalmente, essa é a propriedade Resources de FrameworkElement ou FrameworkContentElementou de Application em um caso de recursos do aplicativo.Typically, this is the Resources property of FrameworkElement or FrameworkContentElement, or of Application in an application resources case.

oneOrMoreResourcesoneOrMoreResources
Um ou mais recursos especificados como elementos de objeto.One or more resources specified as object elements. Cada recurso especificado deve ter uma diretiva x:Key atribuída.Each resource that you specify must have an x:Key Directive assigned.

Construtores

ResourceDictionary()

Inicia uma nova instância da classe ResourceDictionary.Initializes a new instance of the ResourceDictionary class.

Propriedades

Count

Obtém o número de entradas no ResourceDictionary de base.Gets the number of entries in the base ResourceDictionary.

DeferrableContent

Obtém ou define o conteúdo de adiável para esse dicionário de recursos.Gets or sets the deferrable content for this resource dictionary.

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.Gets or sets a value that indicates whether the invalidations fired by the ResourceDictionary object cause ContentPresenter objects to reevaluate their choice of template. As invalidações ocorrem quando um recurso de modelo de dados é alterado.The invalidations happen when an implicit data template resource changes.

IsFixedSize

Obtém se este ResourceDictionary é de tamanho fixo.Gets whether this ResourceDictionary is fixed-size.

IsReadOnly

Obtém se este ResourceDictionary é somente leitura.Gets whether this ResourceDictionary is read-only.

Item[Object]

Obtém ou define o valor associado à chave especificada.Gets or sets the value associated with the given key.

Keys

Obtém uma coleção de todas as chaves contidas neste ResourceDictionary.Gets a collection of all keys contained in this ResourceDictionary.

MergedDictionaries

Obtém uma coleção dos dicionários ResourceDictionary que constituem os vários dicionários de recursos nos dicionários mesclados.Gets a collection of the ResourceDictionary dictionaries that constitute the various resource dictionaries in the merged dictionaries.

Source

Obtém ou define o URI (Uniform Resource Identifier) do qual carregar recursos.Gets or sets the uniform resource identifier (URI) to load resources from.

Values

Obtém uma coleção de todos os valores associados às chaves contidas neste ResourceDictionary.Gets a collection of all values associated with keys contained in this ResourceDictionary.

Métodos

Add(Object, Object)

Adiciona um recurso por chave para este ResourceDictionary.Adds a resource by key to this ResourceDictionary.

BeginInit()

Começa a fase de inicialização para este ResourceDictionary.Begins the initialization phase for this ResourceDictionary.

Clear()

Limpa todas as chaves (e valores) no ResourceDictionary base.Clears all keys (and values) in the base ResourceDictionary. Isso não limpa nenhum item de dicionário mesclado.This does not clear any merged dictionary items.

Contains(Object)

Determina se o ResourceDictionary contém um elemento com a chave especificada.Determines whether the ResourceDictionary contains an element with the specified key.

CopyTo(DictionaryEntry[], Int32)

Copia os elementos ResourceDictionary para um objeto DictionaryEntry unidimensional no índice especificado.Copies the ResourceDictionary elements to a one-dimensional DictionaryEntry at the specified index.

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.Ends the initialization phase, and invalidates the previous tree such that all changes made to keys during the initialization phase can be accounted for.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
FindName(String)

Não é compatível com esta implementação de Dicionário.Not supported by this Dictionary implementation.

GetEnumerator()

Retorna um IDictionaryEnumerator que pode ser usado para iterar pelo ResourceDictionary.Returns an IDictionaryEnumerator that can be used to iterate through the ResourceDictionary.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
OnGettingValue(Object, Object, Boolean)

Ocorre quando o ResourceDictionary recebe uma solicitação para um recurso.Occurs when the ResourceDictionary receives a request for a resource.

RegisterName(String, Object)

Não é compatível com esta implementação de Dicionário.Not supported by this Dictionary implementation.

Remove(Object)

Remove a entrada com a chave especificada do dicionário de base.Removes the entry with the specified key from the base dictionary.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
UnregisterName(String)

Não é compatível com esta implementação de Dicionário.Not supported by this Dictionary implementation.

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)

Para obter uma descrição desse membro, confira CopyTo(Array, Int32).For a description of this member, see CopyTo(Array, Int32).

ICollection.IsSynchronized

Para obter uma descrição desse membro, confira IsSynchronized.For a description of this member, see IsSynchronized.

ICollection.SyncRoot

Para obter uma descrição desse membro, confira SyncRoot.For a description of this member, see SyncRoot.

IEnumerable.GetEnumerator()

Para obter uma descrição desse membro, confira GetEnumerator().For a description of this member, see GetEnumerator().

IUriContext.BaseUri

Para obter uma descrição desse membro, confira BaseUri.For a description of this member, see BaseUri.

Métodos de Extensão

Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Aplica-se a

Veja também