ResourceDictionary ResourceDictionary ResourceDictionary ResourceDictionary Class

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
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
ResourceDictionaryResourceDictionaryResourceDictionaryResourceDictionary
Derivado
Atributos
Implementações

Comentários

Os itens em um ResourceDictionary não são processados imediatamente quando o código do aplicativo é XAMLXAML carregado por um carregador.The items in a ResourceDictionary are not immediately processed when application code is loaded by a XAMLXAML loader. Em vez disso ResourceDictionary , o 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 ResourceDictionary classe não é derivada de DictionaryBase.The ResourceDictionary class is not derived from DictionaryBase. Em vez disso ResourceDictionary , a IDictionary classe implementa, mas se Hashtable baseia em um internamente.Instead, the ResourceDictionary class implements IDictionary but relies on a Hashtable internally.

No XAML (linguagem XAML)Extensible Application Markup Language (XAML), a ResourceDictionary classe normalmente é um elemento de coleção implícito que é o valor do elemento Object Resources de várias propriedades, 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 XAMLXAML possível é declarar um dicionário de recursos como um arquivo 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 um arquivo solto.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 declarado como um elemento Object, servindo como o elemento raiz XAMLXAMLdo.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 (o WPFWPF padrão para o x: namespace e XAMLXAML , normalmente, para ResourceDictionary o namespace) para o elemento, 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

resourcesPropertyresourcesProperty
Uma propriedade que especifica um elemento de propriedade, em que o tipo de valor ResourceDictionarydessa propriedade é.A property specifying a property element, where the value type of that property is ResourceDictionary. Normalmente, essa é a Resources propriedade de FrameworkElement ou FrameworkContentElement, ou 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() ResourceDictionary() ResourceDictionary() ResourceDictionary()

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

Propriedades

Count Count Count Count

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

DeferrableContent DeferrableContent DeferrableContent 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 InvalidatesImplicitDataTemplateResources InvalidatesImplicitDataTemplateResources 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 IsFixedSize IsFixedSize IsFixedSize

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

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

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

Item[Object] Item[Object] Item[Object] Item[Object]

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

Keys Keys Keys Keys

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

MergedDictionaries MergedDictionaries MergedDictionaries 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 Source Source Source

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

Values Values Values 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) Add(Object, Object) Add(Object, Object) Add(Object, Object)

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

BeginInit() BeginInit() BeginInit() BeginInit()

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

Clear() Clear() Clear() 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) Contains(Object) Contains(Object) 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) CopyTo(DictionaryEntry[], Int32) CopyTo(DictionaryEntry[], Int32) 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() EndInit() EndInit() 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) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
FindName(String) FindName(String) FindName(String) FindName(String)

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

GetEnumerator() GetEnumerator() GetEnumerator() 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() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnGettingValue(Object, Object, Boolean) OnGettingValue(Object, Object, Boolean) OnGettingValue(Object, Object, Boolean) 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) RegisterName(String, Object) RegisterName(String, Object) RegisterName(String, Object)

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

Remove(Object) Remove(Object) Remove(Object) 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() ToString() ToString() ToString()

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

(Inherited from Object)
UnregisterName(String) UnregisterName(String) UnregisterName(String) 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) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32)

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

ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

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

ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

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

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

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

IUriContext.BaseUri IUriContext.BaseUri IUriContext.BaseUri IUriContext.BaseUri

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

Métodos de Extensão

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) 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) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) 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) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

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

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

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

Aplica-se a

Veja também