ResourceDictionary Klasa

Definicja

Zapewnia implementację tabeli/słownika wartości skrótu, która zawiera zasoby WPF używane przez składniki i inne elementy aplikacji 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
Dziedziczenie
ResourceDictionary
Pochodne
Atrybuty
Implementuje

Uwagi

Elementy ResourceDictionary nie są natychmiast przetwarzane, gdy kod aplikacji jest ładowany przez moduł ładujący XAMLXAML.The items in a ResourceDictionary are not immediately processed when application code is loaded by a XAMLXAML loader. Zamiast tego ResourceDictionary zachowuje się jako obiekt, a poszczególne wartości są przetwarzane tylko wtedy, gdy są one wymagane.Instead, the ResourceDictionary persists as an object, and the individual values are processed only when they are specifically requested.

Klasa ResourceDictionary nie pochodzi od DictionaryBase.The ResourceDictionary class is not derived from DictionaryBase. Zamiast tego Klasa ResourceDictionary implementuje IDictionary, ale opiera się na Hashtable wewnętrznie.Instead, the ResourceDictionary class implements IDictionary but relies on a Hashtable internally.

W Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML)Klasa ResourceDictionary jest zazwyczaj niejawnym elementem kolekcji, który jest wartością elementu obiektu kilku Resources właściwości, w przypadku podanych w składni elementu właściwości.In Extensible Application Markup Language (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. Aby uzyskać szczegółowe informacje na temat niejawnych kolekcji w XAMLXAML, zobacz Szczegóły składni XAML.For details on implicit collections in XAMLXAML, see XAML Syntax In Detail. Wyjątek polega na tym, że chcesz określić scalony słownik; Aby uzyskać szczegółowe informacje, zobacz scalone słowniki zasobów.An exception is when you want to specify a merged dictionary; for details, see Merged Resource Dictionaries.

Innym możliwym XAMLXAML użycia jest zadeklarowanie słownika zasobów jako dyskretnego pliku XAMLXAML, a następnie załadowanie go w czasie wykonywania z Load lub uwzględnienie go w projekcie (w pełni zaufanym) jako zasób lub luźny plik.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. W takim przypadku ResourceDictionary może być zadeklarowany jako element obiektu, służący jako element główny XAMLXAML.In this case, ResourceDictionary can be declared as an object element, serving as the root element of the XAMLXAML. Należy zmapować odpowiednie wartości przestrzeni nazw XML (domyślnie dla przestrzeni nazw WPFWPF i zazwyczaj x: dla przestrzeni nazw XAMLXAML) na element ResourceDictionary, jeśli zamierzasz użyć go jako elementu głównego.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. Następnie można dodać elementy podrzędne, które definiują zasoby, z których każdy ma wartość x:Key .Then you can add child elements that define the resources, each with an x:Key value.

Użycie niejawnej kolekcji języka XAMLXAML Implicit Collection Usage

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

Wartości XAMLXAML Values

resourcesPropertyresourcesProperty
Właściwość określająca element właściwości, gdzie typ wartości tej właściwości jest ResourceDictionary.A property specifying a property element, where the value type of that property is ResourceDictionary. Zwykle jest to Resources Właściwość FrameworkElement lub FrameworkContentElementlub Application w przypadku zasobów aplikacji.Typically, this is the Resources property of FrameworkElement or FrameworkContentElement, or of Application in an application resources case.

oneOrMoreResourcesoneOrMoreResources
Co najmniej jeden zasób określony jako element obiektu.One or more resources specified as object elements. Każdy określony zasób musi mieć przypisaną dyrektywę x:Key .Each resource that you specify must have an x:Key Directive assigned.

Konstruktory

ResourceDictionary()

Inicjuje nowe wystąpienie klasy ResourceDictionary.Initializes a new instance of the ResourceDictionary class.

Właściwości

Count

Pobiera liczbę wpisów w ResourceDictionarypodstawowej.Gets the number of entries in the base ResourceDictionary.

DeferrableContent

Pobiera lub ustawia zawartość odroczoną dla tego słownika zasobów.Gets or sets the deferrable content for this resource dictionary.

InvalidatesImplicitDataTemplateResources

Pobiera lub ustawia wartość wskazującą, czy unieważnienia wywołane przez obiekt ResourceDictionary powodują, że ContentPresenter obiekty do ponownej ewaluacji wybranego szablonu.Gets or sets a value that indicates whether the invalidations fired by the ResourceDictionary object cause ContentPresenter objects to reevaluate their choice of template. Unieważnienia zachodzą w przypadku zmiany niejawnego zasobu szablonu danych.The invalidations happen when an implicit data template resource changes.

IsFixedSize

Pobiera czy ten ResourceDictionary ma stały rozmiar.Gets whether this ResourceDictionary is fixed-size.

IsReadOnly

Pobiera czy ten ResourceDictionary jest tylko do odczytu.Gets whether this ResourceDictionary is read-only.

Item[Object]

Pobiera lub ustawia wartość skojarzoną z danym kluczem.Gets or sets the value associated with the given key.

Keys

Pobiera kolekcję wszystkich kluczy zawartych w tym ResourceDictionary.Gets a collection of all keys contained in this ResourceDictionary.

MergedDictionaries

Pobiera kolekcję ResourceDictionary słowników, które stanowią różne słowniki zasobów w scalonych słownikach.Gets a collection of the ResourceDictionary dictionaries that constitute the various resource dictionaries in the merged dictionaries.

Source

Pobiera lub ustawia identyfikator URI (Uniform Resource Identifier) w celu załadowania zasobów z programu.Gets or sets the uniform resource identifier (URI) to load resources from.

Values

Pobiera kolekcję wszystkich wartości skojarzonych z kluczami zawartymi w tym ResourceDictionary.Gets a collection of all values associated with keys contained in this ResourceDictionary.

Metody

Add(Object, Object)

Dodaje zasób według klucza do tego ResourceDictionary.Adds a resource by key to this ResourceDictionary.

BeginInit()

Rozpoczyna fazę inicjalizacji dla tego ResourceDictionary.Begins the initialization phase for this ResourceDictionary.

Clear()

Czyści wszystkie klucze (i wartości) w podstawowej ResourceDictionary.Clears all keys (and values) in the base ResourceDictionary. Nie spowoduje to usunięcia wszystkich scalonych elementów słownika.This does not clear any merged dictionary items.

Contains(Object)

Określa, czy ResourceDictionary zawiera element z określonym kluczem.Determines whether the ResourceDictionary contains an element with the specified key.

CopyTo(DictionaryEntry[], Int32)

Kopiuje ResourceDictionary elementy do jednowymiarowego DictionaryEntry o określonym indeksie.Copies the ResourceDictionary elements to a one-dimensional DictionaryEntry at the specified index.

EndInit()

Zamyka fazę inicjalizacji i unieważnia poprzednie drzewo, aby można było uwzględnić wszystkie zmiany w kluczach podczas fazy inicjalizacji.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)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
FindName(String)

Nieobsługiwane przez tę implementację słownika.Not supported by this Dictionary implementation.

GetEnumerator()

Zwraca IDictionaryEnumerator, których można użyć do iteracji przez ResourceDictionary.Returns an IDictionaryEnumerator that can be used to iterate through the ResourceDictionary.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Objectelementu.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnGettingValue(Object, Object, Boolean)

Występuje, gdy ResourceDictionary odbiera żądanie dla zasobu.Occurs when the ResourceDictionary receives a request for a resource.

RegisterName(String, Object)

Nieobsługiwane przez tę implementację słownika.Not supported by this Dictionary implementation.

Remove(Object)

Usuwa wpis z określonym kluczem ze słownika podstawowego.Removes the entry with the specified key from the base dictionary.

ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
UnregisterName(String)

Nieobsługiwane przez tę implementację słownika.Not supported by this Dictionary implementation.

Jawne implementacje interfejsu

ICollection.CopyTo(Array, Int32)

Aby uzyskać opis tego elementu członkowskiego, zobacz CopyTo(Array, Int32).For a description of this member, see CopyTo(Array, Int32).

ICollection.IsSynchronized

Aby uzyskać opis tego elementu członkowskiego, zobacz IsSynchronized.For a description of this member, see IsSynchronized.

ICollection.SyncRoot

Aby uzyskać opis tego elementu członkowskiego, zobacz SyncRoot.For a description of this member, see SyncRoot.

IEnumerable.GetEnumerator()

Aby uzyskać opis tego elementu członkowskiego, zobacz GetEnumerator().For a description of this member, see GetEnumerator().

IUriContext.BaseUri

Aby uzyskać opis tego elementu członkowskiego, zobacz BaseUri.For a description of this member, see BaseUri.

Metody rozszerzania

Cast<TResult>(IEnumerable)

Rzutuje elementy IEnumerable do określonego typu.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje elementy IEnumerable w oparciu o określony typ.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Włącza przetwarzanie równoległe zapytania.Enables parallelization of a query.

AsQueryable(IEnumerable)

IEnumerable KonwertujeIQueryabledo.Converts an IEnumerable to an IQueryable.

Dotyczy

Zobacz też