Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы CoreData ссылка класса NSPersistentStoreCoordinator

Опции
Развертывание Target:

На этой странице
Язык:

NSPersistentStoreCoordinator

Экземпляры NSPersistentStoreCoordinator свяжите персистентные хранилища (типом) с моделью (или более точно, конфигурация модели) и служите для посредничества между персистентным хранилищем или хранилищами и контекстом управляемого объекта или контекстами. Экземпляры NSManagedObjectContext используйте координатора, чтобы сохранить графы объектов к персистентному хранению и получить информацию модели. Контекст без координатора не полностью функционален, поскольку он не может получить доступ к модели кроме через координатора. Координатор разработан для представления фасада контекстам управляемого объекта, таким образом, что группа персистентных хранилищ появляется как совокупное хранилище. Контекст управляемого объекта может тогда создать граф объектов на основе объединения всех хранилищ данных покрытия координатора.

Координаторы делают противоположность обеспечения параллелизма — €” они сериализируют операции. Если Вы хотите использовать многократные потоки для различных операций записи, Вы используете многократных координаторов. Обратите внимание на то, что, если многократные потоки работают непосредственно с координатором, они должны заблокировать и разблокировать его явно.

Каждый координатор (и таким образом контейнер) может использовать различные копии, и следовательно различные версии, модели управляемого объекта. Это позволяет Вам чисто иметь дело с управлением версиями файла.

Координатор предоставляет доступ к его хранилищам основного объекта. Можно получить объектно-ориентированную память, когда Вы сначала добавляете один (использование addPersistentStoreWithType:configuration:URL:options:error:), или при помощи persistentStoreForURL: или persistentStores. Это позволяет Вам определить, например, было ли хранилище уже добавлено, или прибывают ли два объекта из того же хранилища.

  • Вы перемещаете хранилище от одного расположения до другого или изменяете тип хранилища, с помощью migratePersistentStore:toURL:options:withType:error:.

  • Можно установить метаданные для данного хранилища с помощью персистентного координатора хранилища (setMetadata:forPersistentStore:).

Для получения дополнительной информации об этих задачах, посмотрите Используя Персистентные Хранилища в Базовом Руководстве по программированию Данных.

Наследование


Соответствует


Оператор импорта


Swift

import CoreData

Objective C

@import CoreData;

Доступность


Доступный в OS X v10.4 и позже.
  • Возвращает словарь зарегистрированных типов хранилища.

    Объявление

    Swift

    class func registeredStoreTypes() -> [NSObject : AnyObject]

    Objective C

    + (NSDictionary *)registeredStoreTypes

    Возвращаемое значение

    Словарь зарегистрированных типов хранилища — ключи являются строками типа хранилища, и значения NSPersistentStore подклассы.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.5 и позже.

  • Регистрирует данный NSPersistentStore подкласс для данного хранилища вводит строку.

    Объявление

    Swift

    class func registerStoreClass(_ storeClass: AnyClass?, forStoreType storeType: String)

    Objective C

    + (void)registerStoreClass:(Class)storeClass forStoreType:(NSString *)storeType

    Параметры

    storeClass

    NSPersistentStore разделите на подклассы для использования для хранилища типа storeType.

    storeType

    Уникальная строка, идентифицирующая тип хранилища.

    Обсуждение

    Необходимо вызвать этот метод перед пользовательским подклассом NSPersistentStore может быть загружен в персистентного координатора хранилища.

    Можно передать nil для storeClass не зарегистрировать тип хранилища.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.5 и позже.

  • init (managedObjectModel:) - initWithManagedObjectModel: Определяемый инициализатор

    Инициализирует получатель с моделью управляемого объекта.

    Объявление

    Swift

    init(managedObjectModel model: NSManagedObjectModel)

    Objective C

    - (instancetype)initWithManagedObjectModel:(NSManagedObjectModel *)model

    Параметры

    model

    Модель управляемого объекта.

    Возвращаемое значение

    Получатель, инициализированный с model.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.4 и позже.

  • Модель управляемого объекта получателя. (только для чтения)

    Объявление

    Swift

    var managedObjectModel: NSManagedObjectModel { get }

    Objective C

    @property(readonly, strong) NSManagedObjectModel *managedObjectModel

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.4 и позже.

  • Добавляет новое персистентное хранилище указанного типа в данном расположении и возвращает новое хранилище.

    Объявление

    Swift

    func addPersistentStoreWithType(_ storeType: String, configuration configuration: String?, URL storeURL: NSURL?, options options: [NSObject : AnyObject]?, error error: NSErrorPointer) -> NSPersistentStore?

    Objective C

    - (NSPersistentStore *)addPersistentStoreWithType:(NSString *)storeType configuration:(NSString *)configuration URL:(NSURL *)storeURL options:(NSDictionary *)options error:(NSError **)error

    Параметры

    storeType

    Строковая константа (такой как NSSQLiteStoreType) это указывает, что тип хранилища — видит Типы Хранилища для возможных значений.

    configuration

    Имя конфигурации в модели управляемого объекта получателя, которая будет использоваться новым хранилищем. Конфигурация может быть nil, когда не позволяются никакие другие конфигурации.

    storeURL

    Расположение файла персистентного хранилища.

    options

    Словарь, содержащий пары ключ/значение, указывающие, должно ли хранилище быть только для чтения, и должен ли (для хранилища XML) XML-файл быть проверен против DTD, прежде чем это будет считано. Для ключевых определений посмотрите “Store Options” и “Migration Options”. Это значение может быть nil.

    error

    Если новое хранилище не может быть создано, по возврату содержит экземпляр NSError это описывает проблему

    Возвращаемое значение

    Недавно создаваемое хранилище или, если ошибка происходит, nil.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.4 и позже.

  • Устанавливает URL для данного персистентного хранилища.

    Объявление

    Swift

    func setURL(_ url: NSURL, forPersistentStore store: NSPersistentStore) -> Bool

    Objective C

    - (BOOL)setURL:(NSURL *)url forPersistentStore:(NSPersistentStore *)store

    Параметры

    url

    Новое расположение для store.

    store

    Персистентное хранилище связалось с получателем.

    Возвращаемое значение

    YEStrue если хранилище было перемещено, иначе NOfalse.

    Обсуждение

    Для атомарных хранилищ этот метод изменяет расположение, в которое следующая работа сохранения запишет файл; для неатомарных хранилищ, вызывая этот метод оставит существующее соединение и создаст новое в указанном URL. (Для неатомарных хранилищ хранилище должно уже существовать в целевом URL; новое хранилище не будет создаваться.)

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.5 и позже.

  • Удаляет данное персистентное хранилище.

    Объявление

    Swift

    func removePersistentStore(_ store: NSPersistentStore, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)removePersistentStore:(NSPersistentStore *)store error:(NSError **)error

    Параметры

    store

    Персистентное хранилище.

    error

    Если ошибка происходит, по возврату содержит экземпляр NSError это описывает проблему.

    Возвращаемое значение

    YEStrue если хранилище удалено, иначе NOfalse.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.4 и позже.

  • Перемещает персистентное хранилище в новое расположение, изменяя тип хранения при необходимости.

    Объявление

    Swift

    func migratePersistentStore(_ store: NSPersistentStore, toURL URL: NSURL, options options: [NSObject : AnyObject]?, withType storeType: String, error error: NSErrorPointer) -> NSPersistentStore?

    Objective C

    - (NSPersistentStore *)migratePersistentStore:(NSPersistentStore *)store toURL:(NSURL *)URL options:(NSDictionary *)options withType:(NSString *)storeType error:(NSError **)error

    Параметры

    store

    Персистентное хранилище.

    URL

    Объект URL, указывающий расположение для нового хранилища.

    options

    Словарь, содержащий пары ключ/значение, указывающие, должно ли хранилище быть только для чтения, и должен ли (для хранилища XML) XML-файл быть проверен против DTD, прежде чем это будет считано. Для ключевых определений посмотрите Опции Хранилища.

    storeType

    Строковая константа (такой как NSSQLiteStoreType) это указывает, что тип нового хранилища — видит Типы Хранилища.

    error

    Если ошибка происходит, по возврату содержит экземпляр NSError это описывает проблему.

    Возвращаемое значение

    Если миграция успешна, новое хранилище, иначе nil.

    Обсуждение

    Этот метод обычно используется для, “Сохраняют Как” € операции. Производительность может варьироваться в зависимости от типа старого и нового хранилища. Для получения дополнительной информации действия этого метода, посмотрите Персистентные Функции Хранилища в Базовом Руководстве по программированию Данных.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.4 и позже.

  • Персистентные хранилища связались с получателем. (только для чтения)

    Объявление

    Swift

    var persistentStores: [AnyObject] { get }

    Objective C

    @property(readonly, strong) NSArray *persistentStores

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.4 и позже.

  • Возвращает персистентное хранилище для указанного URL.

    Объявление

    Swift

    func persistentStoreForURL(_ URL: NSURL) -> NSPersistentStore?

    Objective C

    - (NSPersistentStore *)persistentStoreForURL:(NSURL *)URL

    Параметры

    URL

    Объект URL, указывающий расположение персистентного хранилища.

    Возвращаемое значение

    Персистентное хранилище в расположении, указанном URL.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.4 и позже.

  • Возвращает URL для данного персистентного хранилища.

    Объявление

    Swift

    func URLForPersistentStore(_ store: NSPersistentStore) -> NSURL

    Objective C

    - (NSURL *)URLForPersistentStore:(NSPersistentStore *)store

    Параметры

    store

    Персистентное хранилище.

    Возвращаемое значение

    URL для store.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.4 и позже.

  • Удаляет все повсеместное содержание для всех коллег для персистентного хранилища в данном URL, и также удалите локальный файл хранилища.

    Объявление

    Swift

    class func removeUbiquitousContentAndPersistentStoreAtURL(_ storeURL: NSURL, options options: [NSObject : AnyObject]?, error error: NSErrorPointer) -> Bool

    Objective C

    + (BOOL)removeUbiquitousContentAndPersistentStoreAtURL:(NSURL *)storeURL options:(NSDictionary *)options error:(NSError **)error

    Параметры

    storeURL

    URL хранилища для удаления.

    options

    Словарь, содержащий опции обычно, передавал addPersistentStoreWithType:configuration:URL:options:error:.

    error

    Если сбои работы, по возврату содержит NSError объект, описывающий проблему.

    Возвращаемое значение

    YEStrue если хранилище было удалено, иначе NOfalse.

    Обсуждение

    Ошибки могут быть возвращены в результате файлового ввода-вывода, сети iCloud или проблем учетной записи iCloud.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.9 и позже.

  • Отправляет запрос ко всем персистентным хранилищам, связанным с получателем.

    Объявление

    Swift

    func executeRequest(_ request: NSPersistentStoreRequest, withContext context: NSManagedObjectContext, error error: NSErrorPointer) -> AnyObject?

    Objective C

    - (id)executeRequest:(NSPersistentStoreRequest *)request withContext:(NSManagedObjectContext *)context error:(NSError **)error

    Параметры

    request

    Выборка или сохраняет запрос.

    context

    Контекст тот, против который request должен быть выполнен.

    error

    Если ошибка происходит, по возврату содержит объект NSError, описывающий проблему.

    Возвращаемое значение

    Массив, содержащий управляемые объекты, управляемый объект IDs или словари как подходящие для запроса выборки; пустой массив, если request запрос сохранения, или nil если произошла ошибка.

    Определяемые пользователем возвращаемые массивы запросов массивов, где вложенный массив является результатом, возвратились из единственного хранилища.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.7 и позже.

  • Попытки получить блокировку.

    Объявление

    Swift

    func lock()

    Objective C

    - (void)lock

    Обсуждение

    Этот метод блокирует поток’ €™ s выполнение, пока не может быть получена блокировка. Приложение защищает критический раздел кода, требуя, чтобы поток получил блокировку прежде, чем выполнить код. Как только критический раздел проходит, поток оставляет блокировку вызовом, разблокировали.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.4 и позже.

    Осуждаемый в OS X v10.10.

  • tryLock () - tryLock (OS X v10.10)

    Попытки получить блокировку.

    Объявление

    Swift

    func tryLock() -> Bool

    Objective C

    - (BOOL)tryLock

    Возвращаемое значение

    YEStrue в случае успеха, иначе NOfalse.

    Обсуждение

    Возвраты сразу — контрастируют блокирующую блокировку.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.4 и позже.

    Осуждаемый в OS X v10.10.

  • Оставляет ранее полученную блокировку.

    Объявление

    Swift

    func unlock()

    Objective C

    - (void)unlock

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.4 и позже.

    Осуждаемый в OS X v10.10.

  • Возвращает словарь, содержащий метаданные, сохраненные в персистентном хранилище в указанном расположении.

    Оператор осуждения

    Использовать metadataForPersistentStoreOfType:URL:error: вместо этого.

    Объявление

    Objective C

    + (NSDictionary *)metadataForPersistentStoreWithURL:(NSURL *)url error:(NSError **)error

    Параметры

    url

    Объект URL, указывающий расположение персистентного хранилища.

    error

    Если никакое хранилище не найдено в url или если существует проблема, получающая доступ к ее содержанию, по возврату содержит экземпляр NSError это описывает проблему.

    Возвращаемое значение

    Словарь, содержащий метаданные для персистентного хранилища в url. Если никакое хранилище не найдено, или существует проблема, получающая доступ к ее содержанию, возвратам nil.

    Ключи, которые, как гарантируют, будут в этом словаре, NSStoreTypeKey и NSStoreUUIDKey.

    Обсуждение

    Этот метод позволяет Вам получать доступ к метаданным в персистентном хранилище, не инициализируя Базовый Стек данных.

    Оператор импорта

    Objective C

    @import CoreData;

    Доступность

    Доступный в OS X v10.4 и позже.

    Осуждаемый в OS X v10.5.

  • Возвращает словарь, содержащий метаданные, в настоящее время сохраненные или сохраненные будущим образом в данном персистентном хранилище.

    Объявление

    Swift

    func metadataForPersistentStore(_ store: NSPersistentStore) -> [NSObject : AnyObject]

    Objective C

    - (NSDictionary *)metadataForPersistentStore:(NSPersistentStore *)store

    Параметры

    store

    Персистентное хранилище.

    Возвращаемое значение

    Словарь, содержащий метаданные, в настоящее время сохраненные или сохраненные будущим образом в store.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.4 и позже.

  • Устанавливает метаданные, сохраненные в персистентном хранилище во время следующей работы сохранения, выполняемой на нем к metadata.

    Объявление

    Swift

    func setMetadata(_ metadata: [NSObject : AnyObject]?, forPersistentStore store: NSPersistentStore)

    Objective C

    - (void)setMetadata:(NSDictionary *)metadata forPersistentStore:(NSPersistentStore *)store

    Параметры

    metadata

    Словарь, содержащий метаданные для хранилища.

    store

    Персистентное хранилище.

    Обсуждение

    Тип хранилища и UUID (NSStoreTypeKey и NSStoreUUIDKey) всегда добавляются автоматически, однако NSStoreUUIDKey только добавляется, если это не установлено вручную как часть параметра словаря.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.4 и позже.

  • Устанавливает метаданные для данного хранилища.

    Объявление

    Swift

    class func setMetadata(_ metadata: [NSObject : AnyObject]?, forPersistentStoreOfType storeType: String?, URL url: NSURL, error error: NSErrorPointer) -> Bool

    Objective C

    + (BOOL)setMetadata:(NSDictionary *)metadata forPersistentStoreOfType:(NSString *)storeType URL:(NSURL *)url error:(NSError **)error

    Параметры

    metadata

    Словарь, содержащий метаданные для хранилища.

    storeType

    Тип хранилища в url. Если это значение nil, Базовые Данные определят, какой класс хранилища должен использоваться, чтобы получить или установить метаданные файла хранилища путем проверки содержания файла.

    url

    Расположение персистентного хранилища.

    error

    Если никакое хранилище не найдено в url или если существует проблема, устанавливающая ее метаданные, по возврату содержит NSError объект, описывающий проблему.

    Возвращаемое значение

    YEStrue если метаданные были установлены правильно, иначе NOfalse.

    Обсуждение

    Можно использовать этот метод для установки метаданных для хранилища без издержек создания Базового Стека данных.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает словарь, содержащий метаданные, сохраненные в персистентном хранилище в данном URL.

    Объявление

    Swift

    class func metadataForPersistentStoreOfType(_ storeType: String?, URL url: NSURL, error error: NSErrorPointer) -> [NSObject : AnyObject]?

    Objective C

    + (NSDictionary *)metadataForPersistentStoreOfType:(NSString *)storeType URL:(NSURL *)url error:(NSError **)error

    Параметры

    storeType

    Тип хранилища в url. Если это значение nil, Базовые Данные определяют, какой класс хранилища должен использоваться, чтобы получить или установить метаданные файла хранилища путем проверки содержания файла.

    url

    Расположение персистентного хранилища.

    error

    Если никакое хранилище не найдено в url или если существует проблема, получающая доступ к ее содержанию, по возврату содержит NSError объект, описывающий проблему.

    Возвращаемое значение

    Словарь, содержащий метаданные, сохраненные в персистентном хранилище в url, или nil если существует проблема, получающая доступ к ее содержанию, если хранилище не может быть открыто или.

    Ключи, которые, как гарантируют, будут в этом словаре, NSStoreTypeKey и NSStoreUUIDKey.

    Обсуждение

    Можно использовать этот метод для получения метаданных от хранилища без издержек создания Базового Стека данных.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.5 и позже.

  • Возвращает словарь, содержащий проанализированные элементы, полученные из Центра внимания внешний рекордный файл, указанный данным URL.

    Объявление

    Swift

    class func elementsDerivedFromExternalRecordURL(_ fileURL: NSURL) -> [NSObject : AnyObject]

    Objective C

    + (NSDictionary *)elementsDerivedFromExternalRecordURL:(NSURL *)fileURL

    Параметры

    fileURL

    Файл URL, указывающий расположение Центра внимания внешний рекордный файл.

    Возвращаемое значение

    Словарь, содержащий проанализированные элементы, произошел из файла поддержки Центра внимания, указанного fileURL.

    Обсуждение

    Ключи словаря и соответствующие значения описаны в Центре внимания Внешние Рекордные Элементы.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.6 и позже.

  • Создает и заполняет хранилище с внешними записями, найденными в данном URL.

    Объявление

    Swift

    func importStoreWithIdentifier(_ storeIdentifier: String?, fromExternalRecordsDirectory externalRecordsURL: NSURL, toURL destinationURL: NSURL, options options: [NSObject : AnyObject]?, withType storeType: String, error error: NSErrorPointer) -> NSPersistentStore?

    Objective C

    - (NSPersistentStore *)importStoreWithIdentifier:(NSString *)storeIdentifier fromExternalRecordsDirectory:(NSURL *)externalRecordsURL toURL:(NSURL *)destinationURL options:(NSDictionary *)options withType:(NSString *)storeType error:(NSError **)error

    Параметры

    storeIdentifier

    Идентификатор для хранилища.

    Если это значение nil тогда метод импортирует записи для первого найденного хранилища.

    externalRecordsURL

    Расположение каталога, содержащего внешние записи.

    destinationURL

    Объект URL, указывающий расположение для нового хранилища.

    Не должно быть никакого существующего хранилища в этом расположении, поскольку хранилище будет создаваться с нуля (добавляющий к существующему хранилищу, не позволяется).

    options

    Словарь, содержащий пары ключ/значение, указывающие, должно ли хранилище быть только для чтения, и должен ли (для хранилища XML) XML-файл быть проверен против DTD, прежде чем это будет считано. Для ключевых определений посмотрите Опции Хранилища.

    storeType

    Строковая константа (такой как NSSQLiteStoreType) это указывает, что тип нового хранилища — видит Типы Хранилища.

    error

    Если ошибка происходит, по возврату содержит экземпляр NSError это описывает проблему.

    Возвращаемое значение

    Объект, представляющий недавно создаваемое хранилище.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.6 и позже.

  • Если соответствующее хранилище доступно, или, возвращает идентификатор объекта для указанного представления URI идентификатора объекта nil если не может быть найдено соответствующее хранилище.

    Объявление

    Swift

    func managedObjectIDForURIRepresentation(_ URL: NSURL) -> NSManagedObjectID?

    Objective C

    - (NSManagedObjectID *)managedObjectIDForURIRepresentation:(NSURL *)URL

    Параметры

    URL

    Объект URL, содержащий URI, указывающий управляемый объект.

    Возвращаемое значение

    Идентификатор объекта для объекта, указанного URL.

    Обсуждение

    Представление URI содержит UUID хранилища, из которого прибывает ID, и координатор может соответствовать его против хранилищ, добавленных к нему.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.4 и позже.

    См. также

    URIRepresentation (NSManagedObjectID)
    objectWithID: (NSManagedObjectContext)

  • Типы персистентного хранилища.

    Объявление

    Swift

    let NSSQLiteStoreType: NSString! let NSXMLStoreType: NSString! let NSBinaryStoreType: NSString! let NSInMemoryStoreType: NSString!

    Objective C

    NSString * const NSSQLiteStoreType; NSString * const NSXMLStoreType; NSString * const NSBinaryStoreType; NSString * const NSInMemoryStoreType;

    Константы

    • NSSQLiteStoreType

      NSSQLiteStoreType

      База данных SQLite хранит тип.

      Доступный в OS X v10.4 и позже.

    • NSXMLStoreType

      NSXMLStoreType

      XML хранят тип.

      Доступный в OS X v10.4 и позже.

    • NSBinaryStoreType

      NSBinaryStoreType

      Двоичный тип хранилища.

      Доступный в OS X v10.4 и позже.

    • NSInMemoryStoreType

      NSInMemoryStoreType

      Тип хранилища в памяти.

      Доступный в OS X v10.4 и позже.

  • Ключи, используемые в хранилище’ €™ s словарь метаданных.

    Объявление

    Swift

    let NSStoreTypeKey: NSString! let NSStoreUUIDKey: NSString!

    Objective C

    NSString * const NSStoreTypeKey; NSString * const NSStoreUUIDKey;

    Константы

    • NSStoreTypeKey

      NSStoreTypeKey

      Ключ в словаре метаданных для идентификации типа хранилища.

      Доступный в OS X v10.4 и позже.

    • NSStoreUUIDKey

      NSStoreUUIDKey

      Ключ в словаре метаданных для идентификации хранилища UUID.

      UUID хранилища полезен для идентификации хранилищ через представления URI, но он, как гарантируют, не будет уникален. UUID, сгенерированный для новых хранилищ, уникален — пользователи могут свободно скопировать файлы и таким образом UUID, сохраненный внутри — поэтому, если Вы отслеживаете или ссылочные хранилища явно, необходимо знать о двойном UUIDs и потенциально переопределять UUID, когда новое хранилище добавляется к списку известных хранилищ в приложении.

      Доступный в OS X v10.4 и позже.

  • NSPersistentStoreCoordinatorStoresDidChangeNotification уведомление отправляется каждый раз, когда персистентные хранилища добавлены к или удалены от персистентного координатора хранилища, или когда изменяется хранилище UUIDs. userInfo словарь содержит информацию о хранилищах, добавленных или удаливших использование этих ключей.

    Объявление

    Swift

    let NSAddedPersistentStoresKey: NSString! let NSRemovedPersistentStoresKey: NSString! let NSUUIDChangedPersistentStoresKey: NSString! let NSPersistentStoreUbiquitousTransitionTypeKey: NSString!

    Objective C

    NSString * const NSAddedPersistentStoresKey; NSString * const NSRemovedPersistentStoresKey; NSString * const NSUUIDChangedPersistentStoresKey; NSString * const NSPersistentStoreUbiquitousTransitionTypeKey;

    Константы

    • NSAddedPersistentStoresKey

      NSAddedPersistentStoresKey

      Ключ для массива добавленных хранилищ.

      Доступный в OS X v10.4 и позже.

    • NSRemovedPersistentStoresKey

      NSRemovedPersistentStoresKey

      Ключ для массива удаленных хранилищ.

      Доступный в OS X v10.4 и позже.

    • NSUUIDChangedPersistentStoresKey

      NSUUIDChangedPersistentStoresKey

      Ключ для массива, содержащего старые и новые хранилища.

      Объект в индексе 0 старый экземпляр хранилища и объект в индексе 1 новое. Когда миграция происходит, массив содержит третий объект (в индексе 2) это - массив, содержащий новый objectIDs для всех перемещенных объектов.

      Доступный в OS X v10.4 и позже.

    • NSPersistentStoreUbiquitousTransitionTypeKey

      NSPersistentStoreUbiquitousTransitionTypeKey

      В NSPersistentStoreCoordinatorStoresWillChangeNotification и NSPersistentStoreCoordinatorStoresDidChangeNotification словари userInfo, это идентифицирует тип события. Соответствующее значение является одним из значений перечисления NSPersistentStoreUbiquitousTransitionType как NSNumber объект.

      Доступный в OS X v10.9 и позже.

  • Объявление

    Swift

    let NSReadOnlyPersistentStoreOption: NSString! let NSValidateXMLStoreOption: NSString! let NSPersistentStoreTimeoutOption: NSString! let NSSQLitePragmasOption: NSString! let NSSQLiteAnalyzeOption: NSString! let NSSQLiteManualVacuumOption: NSString! let NSExternalRecordsDirectoryOption: NSString! let NSExternalRecordExtensionOption: NSString! let NSExternalRecordsFileFormatOption: NSString! let NSPersistentStoreUbiquitousContentNameKey: NSString! let NSPersistentStoreUbiquitousContentURLKey: NSString! let NSPersistentStoreUbiquitousPeerTokenOption: NSString! let NSPersistentStoreRemoveUbiquitousMetadataOption: NSString! let NSPersistentStoreUbiquitousContainerIdentifierKey: NSString! let NSPersistentStoreRebuildFromUbiquitousContentOption: NSString!

    Objective C

    NSString * const NSReadOnlyPersistentStoreOption; NSString * const NSValidateXMLStoreOption; NSString * const NSPersistentStoreTimeoutOption; NSString * const NSSQLitePragmasOption; NSString * const NSSQLiteAnalyzeOption; NSString * const NSSQLiteManualVacuumOption; NSString * const NSExternalRecordsDirectoryOption; NSString * const NSExternalRecordExtensionOption; NSString * const NSExternalRecordsFileFormatOption; NSString * const NSPersistentStoreUbiquitousContentNameKey; NSString * const NSPersistentStoreUbiquitousContentURLKey; NSString * const NSPersistentStoreUbiquitousPeerTokenOption; NSString * const NSPersistentStoreRemoveUbiquitousMetadataOption; NSString * const NSPersistentStoreUbiquitousContainerIdentifierKey; NSString * const NSPersistentStoreRebuildFromUbiquitousContentOption;

    Константы

    • NSReadOnlyPersistentStoreOption

      NSReadOnlyPersistentStoreOption

      Флаг, указывающий, обрабатывается ли хранилище как только для чтения или нет.

      Значение по умолчанию NOfalse.

      Доступный в OS X v10.4 и позже.

    • NSValidateXMLStoreOption

      NSValidateXMLStoreOption

      Флаг, указывающий, должен ли XML-файл быть проверен с DTD при открытии.

      Значение по умолчанию NOfalse.

      Доступный в OS X v10.4 и позже.

    • NSPersistentStoreTimeoutOption

      NSPersistentStoreTimeoutOption

      Ключ Options, указывающий тайм-аут соединения для Базовых Хранилищ данных.

      Соответствующее значение NSNumber объект, представляющий продолжительность в секундах, что Базовые Данные будут ожидать при попытке создать соединение с персистентным хранилищем. Если соединение, не может быть сделан в течение того периода времени, работа прерывается, и ошибка возвращается.

      Доступный в OS X v10.5 и позже.

    • NSSQLitePragmasOption

      NSSQLitePragmasOption

      Ключ Options для словаря настроек прагмы SQLite со значениями прагмы, индексированными прагмой, называет как ключи.

      Все значения прагмы должны быть указаны как NSString объекты. fullfsync и synchronous прагмы управляют компромиссом между производительностью записи (запишите в скорость диска и использование кэша), и длительность (чувствительность ущерба/повреждения данных к прерыванию подачи питания). Для получения дополнительной информации о настройках прагмы посмотрите http://sqlite .org/pragma.html.

      Доступный в OS X v10.5 и позже.

    • NSSQLiteAnalyzeOption

      NSSQLiteAnalyzeOption

      Функциональная клавиша для выполнения анализа данных хранилища для оптимизации индексов на основе статистической информации, когда хранилище добавляется к координатору.

      Это вызывает SQLite's ANALYZE команда. Это проигнорировано хранилищами кроме хранилища SQLite.

      Доступный в OS X v10.5 и позже.

    • NSSQLiteManualVacuumOption

      NSSQLiteManualVacuumOption

      Функциональная клавиша для восстановления файла хранилища, вызывая базу данных широкая дефрагментация, когда хранилище добавляется к координатору.

      Это вызывает SQLite's VACUUM команда. Это проигнорировано хранилищами кроме хранилища SQLite.

      Доступный в OS X v10.6 и позже.

    • NSExternalRecordsDirectoryOption

      NSExternalRecordsDirectoryOption

      Опция, указывающая каталог, где Центр внимания внешние рекордные файлы должны быть записаны в.

      Доступный в OS X v10.6 и позже.

    • NSExternalRecordExtensionOption

      NSExternalRecordExtensionOption

      Опция, указывающая расширение файла для использования для Центра внимания внешние рекордные файлы.

      Доступный в OS X v10.6 и позже.

    • NSExternalRecordsFileFormatOption

      NSExternalRecordsFileFormatOption

      Опция указать формат файла Центра внимания внешние записи.

      Для возможных значений посмотрите Центр внимания Внешние Рекордные Параметры формата файлов.

      Доступный в OS X v10.6 и позже.

    • NSPersistentStoreUbiquitousContentNameKey

      NSPersistentStoreUbiquitousContentNameKey

      Опция указать, что персистентное хранилище имеет имя в повсеместности.

      Эта опция требуется для повсеместного содержания функционировать.

      Доступный в OS X v10.7 и позже.

    • NSPersistentStoreUbiquitousContentURLKey

      NSPersistentStoreUbiquitousContentURLKey

      Опция указать журнал соединяет каналом для использования для повсеместных журналов содержания.

      В iOS 6 и OS X 10.8 и ниже, эта опция требуется для повсеместного содержания функционировать. В iOS 7 и OS X 10.9 и позже, это является дополнительным.

      Доступный в OS X v10.7 и позже.

    • NSPersistentStoreUbiquitousPeerTokenOption

      NSPersistentStoreUbiquitousPeerTokenOption

      Соответствующее значение является дополнительно указанной строкой, которая будет смешана в к идентификатору Базовых Данных для каждой коллеги iCloud. Значение должно быть алфавитно-цифровой строкой без любых специальных символов, пробела или пунктуации. Основное использование для этой опции должно позволить многократным приложениям на той же коллеге (устройство) совместно использовать Базовое Хранилище данных, интегрированное с iCloud. Каждое приложение потребует, чтобы его собственные хранили файл.

      Доступный в OS X v10.9 и позже.

    • NSPersistentStoreRemoveUbiquitousMetadataOption

      NSPersistentStoreRemoveUbiquitousMetadataOption

      Соответствующее значение NSNumber объект, представляющий булевскую переменную, указывающую, должен ли получатель удалить все связанные метаданные повсеместности из персистентного хранилища. Вы обычно используете эту опцию во время миграции или копирования для разъединения персистентного файла хранилища с учетной записью iCloud.

      Доступный в OS X v10.9 и позже.

    • NSPersistentStoreUbiquitousContainerIdentifierKey

      NSPersistentStoreUbiquitousContainerIdentifierKey

      Соответствующее значение является строкой, указывающей, что Данные Ядра идентификатора контейнера iCloud должны передать URLForUbiquityContainerIdentifier:.

      Доступный в OS X v10.9 и позже.

    • NSPersistentStoreRebuildFromUbiquitousContentOption

      NSPersistentStoreRebuildFromUbiquitousContentOption

      Соответствующее значение NSNumber объект, представляющий булевскую переменную, указывающую, должен ли получатель стереть локальный файл хранилища и восстановить его от данных iCloud в Мобильных Документах.

      Доступный в OS X v10.9 и позже.

  • Опции миграции, указанные в словаре опций при добавлении персистентного использования хранилища addPersistentStoreWithType:configuration:URL:options:error:.

    Объявление

    Swift

    let NSIgnorePersistentStoreVersioningOption: NSString! let NSMigratePersistentStoresAutomaticallyOption: NSString! let NSInferMappingModelAutomaticallyOption: NSString!

    Objective C

    NSString * const NSIgnorePersistentStoreVersioningOption; NSString * const NSMigratePersistentStoresAutomaticallyOption; NSString * const NSInferMappingModelAutomaticallyOption;

    Константы

    • NSIgnorePersistentStoreVersioningOption

      NSIgnorePersistentStoreVersioningOption

      Ключ для игнорирования встроенного управления версиями, предоставленного Базовыми Данными.

      Соответствующее значение NSNumber объект. Если boolValue из числа YEStrue, Базовые Данные не сравнят хеши версии между моделью управляемого объекта в координаторе и метаданными для загруженного хранилища. (Это будет, однако, продолжать обновлять информацию о хеше версии в метаданных.) Это ключевое и соответствующее значение YEStrue указан по умолчанию для всех приложений, соединенных на или перед OS X v10.4.

      Доступный в OS X v10.5 и позже.

    • NSMigratePersistentStoresAutomaticallyOption

      NSMigratePersistentStoresAutomaticallyOption

      Ключ, чтобы автоматически попытаться переместить имеющие версию хранилища.

      Соответствующее значение NSNumber объект. Если boolValue из числа YEStrue и если информация о хеше версии для добавленного хранилища будет полна решимости быть несовместимой с моделью для координатора, то Базовые Данные попытаются определить местоположение источника и отображающихся моделей в комплектах приложений, и выполнить миграцию.

      Доступный в OS X v10.5 и позже.

    • NSInferMappingModelAutomaticallyOption

      NSInferMappingModelAutomaticallyOption

      Ключ, чтобы попытаться создать отображающуюся модель автоматически.

      Соответствующее значение NSNumber объект. Если boolValue из числа YEStrue и значение NSMigratePersistentStoresAutomaticallyOption YEStrue, координатор попытается вывести отображающуюся модель, если ни один не может быть найден.

      Доступный в OS X v10.6 и позже.

  • Ключи в метаданных хранилища для поддержки управления версиями.

    Объявление

    Swift

    let NSStoreModelVersionHashesKey: NSString! let NSStoreModelVersionIdentifiersKey: NSString! let NSPersistentStoreOSCompatibility: NSString!

    Objective C

    NSString * const NSStoreModelVersionHashesKey; NSString * const NSStoreModelVersionIdentifiersKey; NSString * const NSPersistentStoreOSCompatibility;

    Константы

    • NSStoreModelVersionHashesKey

      NSStoreModelVersionHashesKey

      Ключ для представления информации о хеше версии для модели раньше создавал хранилище.

      Этот ключ используется в метаданных для персистентного хранилища.

      Доступный в OS X v10.5 и позже.

    • NSStoreModelVersionIdentifiersKey

      NSStoreModelVersionIdentifiersKey

      Ключ для представления идентификаторов версии для модели раньше создавал хранилище.

      Если Вы добавляете свои собственные аннотации к идентификатору версии модели (см. versionIdentifiers), они сохранены в метаданных персистентного хранилища. Можно использовать этот ключ для получения идентификаторов из словарей метаданных, доступных от NSPersistentStore (metadata) и NSPersistentStoreCoordinator (metadataForPersistentStore: и связанные методы). Соответствующее значение является набором Основы ( NSArray или NSSet объект).

      Доступный в OS X v10.5 и позже.

    • NSPersistentStoreOSCompatibility

      NSPersistentStoreOSCompatibility

      Ключ для представления самой ранней версии операционной системы, которую поддерживает персистентное хранилище.

      Соответствующее значение NSNumber объект, принимающий форму констант, определенных макросами доступности, определенными в /usr/include/AvailabilityMacros.h; например, 1040 представляет версию 10.4.0 OS X.

      Обратная совместимость может устранить некоторые функции.

      Доступный в OS X v10.5 и позже.

  • Эти константы используются в качестве значения, соответствующего NSPersistentStoreUbiquitousTransitionTypeKey в пользовательском информационном словаре NSPersistentStoreCoordinatorStoresWillChangeNotification и NSPersistentStoreCoordinatorStoresDidChangeNotification уведомления для идентификации типа события, приводящего к изменению.

    Объявление

    Swift

    enum NSPersistentStoreUbiquitousTransitionType : UInt { case AccountAdded case AccountRemoved case ContentRemoved case InitialImportCompleted }

    Objective C

    typedef NS_ENUM (NSUInteger, NSPersistentStoreUbiquitousTransitionType ) { NSPersistentStoreUbiquitousTransitionTypeAccountAdded, NSPersistentStoreUbiquitousTransitionTypeAccountRemoved, NSPersistentStoreUbiquitousTransitionTypeContentRemoved, NSPersistentStoreUbiquitousTransitionTypeInitialImportCompleted };

    Константы

    • AccountAdded

      NSPersistentStoreUbiquitousTransitionTypeAccountAdded

      Это значение указывает, что новая учетная запись iCloud доступна, и персистентное хранилище в использовании будет или действительно переходило в новую учетную запись.

      Только возможно различить это состояние, когда приложение будет работать, и поэтому этот тип перехода будет только отправлен, если учетная запись изменится, в то время как приложение работает или в фоновом режиме.

      Доступный в OS X v10.9 и позже.

    • AccountRemoved

      NSPersistentStoreUbiquitousTransitionTypeAccountRemoved

      Это значение указывает, что никакая учетная запись iCloud не доступна, и персистентное хранилище в использовании будет или действительно переходило к «локальному» хранилищу.

      Только возможно различить это состояние, когда приложение будет работать, и поэтому этот тип перехода будет только отправлен, если учетная запись будет удалена, в то время как приложение работает или в фоновом режиме.

      Доступный в OS X v10.9 и позже.

    • ContentRemoved

      NSPersistentStoreUbiquitousTransitionTypeContentRemoved

      Это значение указывает, что пользователь вытер содержание учетной записи iCloud, обычно использование Удаляют Все из Документов и Данных в Настройках.

      Базовая Интеграция данных перейдет к пустому файлу хранилища в результате этого события.

      Доступный в OS X v10.9 и позже.

    • InitialImportCompleted

      NSPersistentStoreUbiquitousTransitionTypeInitialImportCompleted

      Это значение указывает, что Базовая Интеграция данных закончила создавать файл хранилища, который является соответствующим содержанию учетной записи iCloud и является готов заменить хранилище нейтрализации тем файлом.

      Доступный в OS X v10.9 и позже.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.9 и позже.

  • Константы, указывающие формат для Центра внимания внешние записи. Эти константы являются возможными значениями для ключа NSPersistentStoreFileProtectionKey.

    Объявление

    Swift

    let NSXMLExternalRecordType: NSString! let NSBinaryExternalRecordType: NSString!

    Objective C

    NSString * const NSXMLExternalRecordType; NSString * const NSBinaryExternalRecordType;

    Константы

    • NSXMLExternalRecordType

      NSXMLExternalRecordType

      Указывает формат файлов XML.

      Доступный в OS X v10.6 и позже.

    • NSBinaryExternalRecordType

      NSBinaryExternalRecordType

      Указывает формат двоичного файла

      Доступный в OS X v10.6 и позже.

  • Ключи для словаря с проанализированными элементами получили из Центра внимания внешний рекордный файл.

    Объявление

    Swift

    let NSEntityNameInPathKey: NSString! let NSStoreUUIDInPathKey: NSString! let NSStorePathKey: NSString! let NSModelPathKey: NSString! let NSObjectURIKey: NSString!

    Objective C

    NSString * const NSEntityNameInPathKey; NSString * const NSStoreUUIDInPathKey; NSString * const NSStorePathKey; NSString * const NSModelPathKey; NSString * const NSObjectURIKey;

    Константы

    • NSEntityNameInPathKey

      NSEntityNameInPathKey

      Ключ Dictionary для имени объекта извлечен из внешнего рекордного файла.

      Доступный в OS X v10.6 и позже.

    • NSStoreUUIDInPathKey

      NSStoreUUIDInPathKey

      Ключ Dictionary для хранилища UUID извлечен из внешнего рекордного файла.

      Доступный в OS X v10.6 и позже.

    • NSStorePathKey

      NSStorePathKey

      Ключ Dictionary для пути хранилища (экземпляр NSURL) извлеченный из внешнего рекордного файла.

      Это разрешено к пути к файлу хранилища, содержавшемуся во внешний рекордный каталог файла.

      Доступный в OS X v10.6 и позже.

    • NSModelPathKey

      NSModelPathKey

      Ключ Dictionary для пути модели управляемого объекта (экземпляр NSURL) извлеченный из внешнего рекордного файла.

      Это разрешено к model.mom путь содержится во внешнем рекордном каталоге файла.

      Доступный в OS X v10.6 и позже.

    • NSObjectURIKey

      NSObjectURIKey

      Ключ Dictionary для объектного URI извлечен из внешнего рекордного файла.

      Доступный в OS X v10.6 и позже.

  • Отправленный каждый раз, когда персистентные хранилища добавлены к или удалены от персистентного координатора хранилища, или когда хранилище изменяются UUIDs.

    Объект уведомления является затронутым персистентным координатором хранилища. Уведомление userInfo словарь содержит информацию о хранилищах, добавленных или удаленных, указанное использование следующих ключей:

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.4 и позже.

  • Отправленный перед списком открытых персистентных изменений хранилищ.

    Это уведомление подобно подобному NSPersistentStoreCoordinatorStoresDidChangeNotification. Если приложение будет работать, то Базовые Данные отправят это уведомление прежде, чем реагировать на изменения учетной записи iCloud, или “Удаляют Все” из Документов и Данных.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.9 и позже.

  • Отправленный каждый раз, когда персистентное хранилище удалено от персистентного координатора хранилища.

    Уведомление отправляется во время вызова NSPersistentStore willRemoveFromPersistentStoreCoordinator: метод во время освобождения хранилища или удаления. Объект уведомления является персистентным координатором хранилища, будет удален.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.5 и позже.

  • Отправленный после того, как записи импортируются из повсеместного довольного хранилище.

    Уведомление object установлен в NSPersistentStoreCoordinator экземпляр, зарегистрировавший хранилище. Уведомление userInfo словарь содержит те же ключи как NSManagedObjectContextObjectsDidChangeNotification уведомление (NSInsertedObjectsKey, NSUpdatedObjectsKeyNSDeletedObjectsKey), однако значения являются наборами NSManagedObjectID объекты, а не наборы NSManagedObject объекты.

    Оператор импорта

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

    Доступный в OS X v10.7 и позже.