ResourceDictionary ResourceDictionary ResourceDictionary ResourceDictionary Class

Определение

Предоставляет реализацию хэш-таблицы или словаря, содержащую ресурсы WPF, которые используются компонентами и другими элементами приложения 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
Наследование
ResourceDictionaryResourceDictionaryResourceDictionaryResourceDictionary
Производный
Атрибуты
Реализации

Комментарии

Элементы в ResourceDictionary не обрабатываются немедленно при загрузке XAMLXAML кода приложения загрузчиком.The items in a ResourceDictionary are not immediately processed when application code is loaded by a XAMLXAML loader. Вместо этого объект сохраняется в виде объекта, а отдельные значения обрабатываются только при их специальном запросе. ResourceDictionaryInstead, the ResourceDictionary persists as an object, and the individual values are processed only when they are specifically requested.

Класс не является производным от DictionaryBase. ResourceDictionaryThe ResourceDictionary class is not derived from DictionaryBase. Вместо этого IDictionary класс реализуется, но зависит от Hashtable внутреннего. ResourceDictionaryInstead, the ResourceDictionary class implements IDictionary but relies on a Hashtable internally.

В Язык XAMLExtensible Application Markup Language (XAML)класс обычно является неявным элементом коллекции, который является значением элемента объекта для нескольких Resources свойств при указании в синтаксисе элемента свойства. ResourceDictionaryIn Язык XAMLExtensible 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. Дополнительные сведения о неявных XAMLXAMLколлекциях в см. в разделе Подробное описание синтаксиса XAML.For details on implicit collections in XAMLXAML, see XAML Syntax In Detail. Исключением является необходимость указать Объединенный словарь; Дополнительные сведения см. в разделе Объединенные словари ресурсов.An exception is when you want to specify a merged dictionary; for details, see Merged Resource Dictionaries.

Другим возможным XAMLXAML вариантом использования является объявление словаря ресурсов как отдельного XAMLXAML файла и загрузка его во время выполнения с помощью или включения Load в проект (с полным доверием) в качестве ресурса или свободного файла.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. В этом случае ResourceDictionary может быть объявлен как объектный элемент, служащий корневым элементом XAMLXAML.In this case, ResourceDictionary can be declared as an object element, serving as the root element of the XAMLXAML. Необходимо сопоставлять соответствующие значения пространства имен XML (по умолчанию для WPFWPF пространства имен и x: , как XAMLXAML правило, для пространства ResourceDictionary имен) с элементом, если вы планируете использовать его в качестве корневого элемента.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. Затем можно добавить дочерние элементы, определяющие ресурсы, каждый из которых имеет значение x:Key .Then you can add child elements that define the resources, each with an x:Key value.

Неявное использование коллекции XAMLXAML Implicit Collection Usage

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

Значения XAMLXAML Values

ресаурцеспропертиresourcesProperty
Свойство, указывающее элемент свойства, где тип значения этого свойства — ResourceDictionary.A property specifying a property element, where the value type of that property is ResourceDictionary. Как Resources правило, это свойство класса FrameworkElement или FrameworkContentElement, или Application , в случае ресурсов приложения.Typically, this is the Resources property of FrameworkElement or FrameworkContentElement, or of Application in an application resources case.

онеорморересаурцесoneOrMoreResources
Один или несколько ресурсов, указанных как элементы объекта.One or more resources specified as object elements. Каждому указанному ресурсу должна быть назначена Директива x:Key .Each resource that you specify must have an x:Key Directive assigned.

Конструкторы

ResourceDictionary() ResourceDictionary() ResourceDictionary() ResourceDictionary()

Инициализирует новый экземпляр класса ResourceDictionary.Initializes a new instance of the ResourceDictionary class.

Свойства

Count Count Count Count

Возвращает количество записей в базовом словаре ResourceDictionary.Gets the number of entries in the base ResourceDictionary.

DeferrableContent DeferrableContent DeferrableContent DeferrableContent

Получает или задает содержимое, допускающее задержку, для этого словаря ресурсов.Gets or sets the deferrable content for this resource dictionary.

InvalidatesImplicitDataTemplateResources InvalidatesImplicitDataTemplateResources InvalidatesImplicitDataTemplateResources InvalidatesImplicitDataTemplateResources

Получает или задает значение, указывающее, приводят ли недействительности, инициируемые объектом ContentPresenter, к перепроверке выбранного шаблона объектами ResourceDictionary.Gets or sets a value that indicates whether the invalidations fired by the ResourceDictionary object cause ContentPresenter objects to reevaluate their choice of template. Недействительности возникают при неявном изменении ресурса шаблона данных.The invalidations happen when an implicit data template resource changes.

IsFixedSize IsFixedSize IsFixedSize IsFixedSize

Возвращает значение, которое показывает, имеет ли словарь ResourceDictionary фиксированный размер.Gets whether this ResourceDictionary is fixed-size.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Возвращает значение, которое показывает, доступен ли словарь ResourceDictionary только для чтения.Gets whether this ResourceDictionary is read-only.

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

Возвращает или задает значение, связанное с данным ключом.Gets or sets the value associated with the given key.

Keys Keys Keys Keys

Возвращает коллекцию всех ключей, содержащихся в данном объекте ResourceDictionary.Gets a collection of all keys contained in this ResourceDictionary.

MergedDictionaries MergedDictionaries MergedDictionaries MergedDictionaries

Получает коллекцию словарей ResourceDictionary, представляющих собой различные словари ресурсов в объединенных словарях.Gets a collection of the ResourceDictionary dictionaries that constitute the various resource dictionaries in the merged dictionaries.

Source Source Source Source

Возвращает или задает uniform resource identifier (URI), откуда должны загружаться ресурсы.Gets or sets the uniform resource identifier (URI) to load resources from.

Values Values Values Values

Возвращает коллекцию всех значений, связанных с ключами в данном словаре ResourceDictionary.Gets a collection of all values associated with keys contained in this ResourceDictionary.

Методы

Add(Object, Object) Add(Object, Object) Add(Object, Object) Add(Object, Object)

Добавляет ресурс по ключу для данного класса ResourceDictionary.Adds a resource by key to this ResourceDictionary.

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

Начинается этап инициализации для данного объекта ResourceDictionary.Begins the initialization phase for this ResourceDictionary.

Clear() Clear() Clear() Clear()

Удаляет все ключи (и значения) в базовом объекте ResourceDictionary.Clears all keys (and values) in the base ResourceDictionary. Это не приводит к удалению элементов объединенного словаря.This does not clear any merged dictionary items.

Contains(Object) Contains(Object) Contains(Object) Contains(Object)

Определяет, содержится ли элемент с указанным ключом в ResourceDictionary.Determines whether the ResourceDictionary contains an element with the specified key.

CopyTo(DictionaryEntry[], Int32) CopyTo(DictionaryEntry[], Int32) CopyTo(DictionaryEntry[], Int32) CopyTo(DictionaryEntry[], Int32)

Копирует элементы класса ResourceDictionary в одномерный массив класса DictionaryEntry с указанного индекса.Copies the ResourceDictionary elements to a one-dimensional DictionaryEntry at the specified index.

EndInit() EndInit() EndInit() EndInit()

Завершается этап инициализации, что делает недействительным предыдущее дерево. Это позволяет учесть все изменения ключей, выполненные во время этапа инициализации.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)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

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

Не поддерживается этой реализацией словаря.Not supported by this Dictionary implementation.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Возвращает объект IDictionaryEnumerator, который может использоваться выполнения итерации по элементам словаря ResourceDictionary.Returns an IDictionaryEnumerator that can be used to iterate through the ResourceDictionary.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

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

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

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

Создает неполную копию текущего объекта Object.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)

Возникает, когда ResourceDictionary получает запрос на ресурс.Occurs when the ResourceDictionary receives a request for a resource.

RegisterName(String, Object) RegisterName(String, Object) RegisterName(String, Object) RegisterName(String, Object)

Не поддерживается этой реализацией словаря.Not supported by this Dictionary implementation.

Remove(Object) Remove(Object) Remove(Object) Remove(Object)

Удаляет запись с указанным ключом из базового словаря.Removes the entry with the specified key from the base dictionary.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
UnregisterName(String) UnregisterName(String) UnregisterName(String) UnregisterName(String)

Не поддерживается этой реализацией словаря.Not supported by this Dictionary implementation.

Явные реализации интерфейса

ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32)

Описание этого члена см. в разделе CopyTo(Array, Int32).For a description of this member, see CopyTo(Array, Int32).

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

Описание этого члена см. в разделе IsSynchronized.For a description of this member, see IsSynchronized.

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

Описание этого члена см. в разделе SyncRoot.For a description of this member, see SyncRoot.

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

Описание этого члена см. в разделе GetEnumerator().For a description of this member, see GetEnumerator().

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

Описание этого члена см. в разделе BaseUri.For a description of this member, see BaseUri.

Методы расширения

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

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

Преобразовывает коллекцию IEnumerable в объект IQueryable.Converts an IEnumerable to an IQueryable.

Применяется к

Дополнительно