ResourceDictionary Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece uma implementação de tabela hash / dicionário que contém recursos WPF usados por componentes e outros elementos de uma aplicação 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 INameScopePublic Class ResourceDictionary
Implements IDictionary, INameScope, ISupportInitialize, IUriContext- Herança
-
ResourceDictionary
- Derivado
- Atributos
- Implementações
Observações
Os itens em um ResourceDictionary não são processados imediatamente quando o código da aplicação é carregado por um carregador XAML. Em vez disso, o ResourceDictionary persiste como objeto, e os valores individuais são processados apenas quando são especificamente solicitados.
A ResourceDictionary classe não é derivada de DictionaryBase. Em vez disso, a ResourceDictionary classe implementa IDictionary , mas depende de um Hashtable internamente.
Na Extensible Application Markup Language (XAML), a ResourceDictionary classe é tipicamente um elemento de coleção implícita que é o valor do elemento objeto de várias Resources propriedades, quando apresentado na sintaxe dos elementos de propriedade. Para detalhes sobre coleções implícitas em XAML, veja XAML Syntax In Detail. Uma exceção é quando se quer especificar um dicionário fundido; para detalhes, consulte Dicionários de Recursos Mergados.
Outra possível utilização do XAML é declarar um dicionário de recursos como um ficheiro XAML discreto, e carregá-lo em tempo de execução ou Load incluí-lo num projeto (full-trust) como recurso ou ficheiro solto. Neste caso, ResourceDictionary pode ser declarado como elemento objeto, servindo como elemento raiz do XAML. Deve mapear os valores apropriados do espaço de nomes XML (por defeito para o espaço WPF e tipicamente x: para o espaço XAML) para o elemento ResourceDictionary se planeia usá-lo como elemento raiz. Depois podes adicionar elementos filhos que definem os recursos, cada um com um valor x:Key .
Utilização da Coleção Implícita XAML
<object>
<object.resourcesProperty>
oneOrMoreResources
</object.resourcesProperty>
</object>
Valores XAML
Recursos Propriedade Uma propriedade que especifica um elemento de propriedade, onde o tipo de valor dessa propriedade é ResourceDictionary. Normalmente, esta é propriedade Resources de FrameworkElement ou FrameworkContentElement, ou de Application num caso de recursos de aplicação.
umOuMaisRecursosT Um ou mais recursos especificados como elementos de objeto. Cada recurso que especificar deve ter uma Diretiva x:Key atribuída.
Construtores
| Name | Description |
|---|---|
| ResourceDictionary() |
Inicializa uma nova instância da ResourceDictionary classe. |
Propriedades
| Name | Description |
|---|---|
| Count |
Obtém o número de entradas na base ResourceDictionary. |
| DeferrableContent |
Obtém ou define o conteúdo adiável para este dicionário de recursos. |
| InvalidatesImplicitDataTemplateResources |
Recebe ou define um valor que indica se as invalidações feitas pelo ResourceDictionary objeto fazem com que ContentPresenter os objetos reavaliem a escolha do modelo. As invalidações acontecem quando um recurso implícito de template de dados muda. |
| IsFixedSize |
Percebe se isto ResourceDictionary é de tamanho fixo. |
| IsReadOnly |
Percebe se isto ResourceDictionary é só de leitura. |
| Item[Object] |
Recebe ou define o valor associado à chave dada. |
| Keys |
Obtém uma coleção de todas as chaves contidas neste ResourceDictionary. |
| MergedDictionaries |
Obtém uma coleção dos ResourceDictionary dicionários que constituem os vários dicionários de referência nos dicionários fundidos. |
| Source |
Obtém ou define o identificador uniforme de recurso (URI) para carregar os recursos. |
| Values |
Obtém uma coleção de todos os valores associados às chaves contidas neste ResourceDictionary. |
Métodos
| Name | Description |
|---|---|
| Add(Object, Object) |
Adiciona um recurso por chave a este ResourceDictionary. |
| BeginInit() |
Inicia a fase de inicialização para este ResourceDictionary. |
| Clear() |
Limpa todas as chaves (e valores) na base ResourceDictionary. Isto não elimina nenhum item do dicionário fundido. |
| Contains(Object) |
Determina se o ResourceDictionary contém um elemento com a chave especificada. |
| CopyTo(DictionaryEntry[], Int32) |
Copia os ResourceDictionary elementos para um índice unidimensional DictionaryEntry 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 possam ser contabilizadas. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| FindName(String) |
Não é suportado por esta implementação do Dicionário. |
| GetEnumerator() |
Devolve e IDictionaryEnumerator que pode ser usado para iterar através do ResourceDictionary. |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnGettingValue(Object, Object, Boolean) |
Ocorre quando recebe ResourceDictionary um pedido para um recurso. |
| RegisterName(String, Object) |
Não é suportado por esta implementação do Dicionário. |
| Remove(Object) |
Remove a entrada com a chave especificada do dicionário base. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| UnregisterName(String) |
Não é suportado por esta implementação do Dicionário. |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| ICollection.CopyTo(Array, Int32) |
Para uma descrição deste elemento, veja CopyTo(Array, Int32). |
| ICollection.IsSynchronized |
Para uma descrição deste elemento, veja IsSynchronized. |
| ICollection.SyncRoot |
Para uma descrição deste elemento, veja SyncRoot. |
| IEnumerable.GetEnumerator() |
Para uma descrição deste elemento, veja GetEnumerator(). |
| IUriContext.BaseUri |
Para uma descrição deste elemento, veja BaseUri. |
Métodos da Extensão
| Name | Description |
|---|---|
| AsParallel(IEnumerable) |
Permite a paralelização de uma consulta. |
| AsQueryable(IEnumerable) |
Converte um IEnumerable para um IQueryable. |
| Cast<TResult>(IEnumerable) |
Conjura os elementos de an IEnumerable para o tipo especificado. |
| OfType<TResult>(IEnumerable) |
Filtra os elementos de um IEnumerable com base num tipo especificado. |