NSPersistentStoreCoordinator
Экземпляры NSPersistentStoreCoordinator
свяжите персистентные хранилища (типом) с моделью (или более точно, конфигурация модели) и служите для посредничества между персистентным хранилищем или хранилищами и контекстом управляемого объекта или контекстами. Экземпляры NSManagedObjectContext
используйте координатора, чтобы сохранить графы объектов к персистентному хранению и получить информацию модели. Контекст без координатора не полностью функционален, поскольку он не может получить доступ к модели кроме через координатора. Координатор разработан для представления фасада контекстам управляемого объекта, таким образом, что группа персистентных хранилищ появляется как совокупное хранилище. Контекст управляемого объекта может тогда создать граф объектов на основе объединения всех хранилищ данных покрытия координатора.
Координаторы делают противоположность обеспечения параллелизма — они сериализируют операции. Если Вы хотите использовать многократные потоки для различных операций записи, Вы используете многократных координаторов. Обратите внимание на то, что, если многократные потоки работают непосредственно с координатором, они должны заблокировать и разблокировать его явно.
Каждый координатор (и таким образом контейнер) может использовать различные копии, и следовательно различные версии, модели управляемого объекта. Это позволяет Вам чисто иметь дело с управлением версиями файла.
Координатор предоставляет доступ к его хранилищам основного объекта. Можно получить объектно-ориентированную память, когда Вы сначала добавляете один (использование addPersistentStoreWithType:configuration:URL:options:error:
), или при помощи persistentStoreForURL:
или persistentStores
. Это позволяет Вам определить, например, было ли хранилище уже добавлено, или прибывают ли два объекта из того же хранилища.
Вы перемещаете хранилище от одного расположения до другого или изменяете тип хранилища, с помощью migratePersistentStore:toURL:options:withType:error:.
Можно установить метаданные для данного хранилища с помощью персистентного координатора хранилища (
setMetadata:forPersistentStore:
).
Для получения дополнительной информации об этих задачах, посмотрите Используя Персистентные Хранилища в Базовом Руководстве по программированию Данных.
Соответствует
-
AnyObject
-
CVarArgType
-
Сопоставимый
-
Hashable
-
NSLocking
-
NSObjectProtocol
-
Печатаемый
-
NSLocking
-
NSObject
Оператор импорта
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?, forStoreTypestoreType
: 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 и позже.
-
managedObjectModel managedObjectModel
СвойствоМодель управляемого объекта получателя. (только для чтения)
Объявление
Swift
var managedObjectModel: NSManagedObjectModel { get }
Objective C
@property(readonly, strong) NSManagedObjectModel *managedObjectModel
Оператор импорта
Objective C
@import CoreData;
Swift
import CoreData
Доступность
Доступный в OS X v10.4 и позже.
-
addPersistentStoreWithType (_: configuration:URL:options:error:) - addPersistentStoreWithType:configuration:URL:options:error:
Добавляет новое персистентное хранилище указанного типа в данном расположении и возвращает новое хранилище.
Объявление
Swift
func addPersistentStoreWithType(_
storeType
: String, configurationconfiguration
: String?, URLstoreURL
: NSURL?, optionsoptions
: [NSObject : AnyObject]?, errorerror
: 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, forPersistentStorestore
: NSPersistentStore) -> BoolObjective C
- (BOOL)setURL:(NSURL *)
url
forPersistentStore:(NSPersistentStore *)store
Параметры
url
Новое расположение для
store
.store
Персистентное хранилище связалось с получателем.
Возвращаемое значение
YES
true
если хранилище было перемещено, иначеNO
false
.Обсуждение
Для атомарных хранилищ этот метод изменяет расположение, в которое следующая работа сохранения запишет файл; для неатомарных хранилищ, вызывая этот метод оставит существующее соединение и создаст новое в указанном URL. (Для неатомарных хранилищ хранилище должно уже существовать в целевом URL; новое хранилище не будет создаваться.)
Оператор импорта
Objective C
@import CoreData;
Swift
import CoreData
Доступность
Доступный в OS X v10.5 и позже.
-
Удаляет данное персистентное хранилище.
Объявление
Swift
func removePersistentStore(_
store
: NSPersistentStore, errorerror
: NSErrorPointer) -> BoolObjective C
- (BOOL)removePersistentStore:(NSPersistentStore *)
store
error:(NSError **)error
Параметры
store
Персистентное хранилище.
error
Если ошибка происходит, по возврату содержит экземпляр
NSError
это описывает проблему.Возвращаемое значение
YES
true
если хранилище удалено, иначеNO
false
.Оператор импорта
Objective C
@import CoreData;
Swift
import CoreData
Доступность
Доступный в OS X v10.4 и позже.
-
migratePersistentStore (_: toURL:options:withType:error:) - migratePersistentStore:toURL:options:withType:error:
Перемещает персистентное хранилище в новое расположение, изменяя тип хранения при необходимости.
Объявление
Swift
func migratePersistentStore(_
store
: NSPersistentStore, toURLURL
: NSURL, optionsoptions
: [NSObject : AnyObject]?, withTypestoreType
: String, errorerror
: 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 и позже.
-
persistentStores persistentStores
СвойствоПерсистентные хранилища связались с получателем. (только для чтения)
Объявление
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) -> NSURLObjective C
- (NSURL *)URLForPersistentStore:(NSPersistentStore *)
store
Параметры
store
Персистентное хранилище.
Возвращаемое значение
URL для
store
.Оператор импорта
Objective C
@import CoreData;
Swift
import CoreData
Доступность
Доступный в OS X v10.4 и позже.
-
removeUbiquitousContentAndPersistentStoreAtURL (_: options:error:) + removeUbiquitousContentAndPersistentStoreAtURL:options:error:
Удаляет все повсеместное содержание для всех коллег для персистентного хранилища в данном URL, и также удалите локальный файл хранилища.
Объявление
Swift
class func removeUbiquitousContentAndPersistentStoreAtURL(_
storeURL
: NSURL, optionsoptions
: [NSObject : AnyObject]?, errorerror
: NSErrorPointer) -> BoolObjective C
+ (BOOL)removeUbiquitousContentAndPersistentStoreAtURL:(NSURL *)
storeURL
options:(NSDictionary *)options
error:(NSError **)error
Параметры
storeURL
URL хранилища для удаления.
options
Словарь, содержащий опции обычно, передавал
addPersistentStoreWithType:configuration:URL:options:error:
.error
Если сбои работы, по возврату содержит
NSError
объект, описывающий проблему.Возвращаемое значение
YES
true
если хранилище было удалено, иначеNO
false
.Обсуждение
Ошибки могут быть возвращены в результате файлового ввода-вывода, сети iCloud или проблем учетной записи iCloud.
Оператор импорта
Objective C
@import CoreData;
Swift
import CoreData
Доступность
Доступный в OS X v10.9 и позже.
-
Отправляет запрос ко всем персистентным хранилищам, связанным с получателем.
Объявление
Swift
func executeRequest(_
request
: NSPersistentStoreRequest, withContextcontext
: NSManagedObjectContext, errorerror
: 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 и позже.
-
блокировка () - блокировка
(OS X v10.10)Попытки получить блокировку.
Объявление
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
Возвращаемое значение
YES
true
в случае успеха, иначеNO
false
.Обсуждение
Возвраты сразу — контрастируют блокирующую блокировку.
Оператор импорта
Objective C
@import CoreData;
Swift
import CoreData
Доступность
Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.10.
См. также
-
разблокируйте () - разблокировать
(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]?, forPersistentStorestore
: 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 и позже.
-
setMetadata (_: forPersistentStoreOfType:URL:error:) + setMetadata:forPersistentStoreOfType:URL:error:
Устанавливает метаданные для данного хранилища.
Объявление
Swift
class func setMetadata(_
metadata
: [NSObject : AnyObject]?, forPersistentStoreOfTypestoreType
: String?, URLurl
: NSURL, errorerror
: NSErrorPointer) -> BoolObjective C
+ (BOOL)setMetadata:(NSDictionary *)
metadata
forPersistentStoreOfType:(NSString *)storeType
URL:(NSURL *)url
error:(NSError **)error
Параметры
metadata
Словарь, содержащий метаданные для хранилища.
storeType
Тип хранилища в
url
. Если это значениеnil
, Базовые Данные определят, какой класс хранилища должен использоваться, чтобы получить или установить метаданные файла хранилища путем проверки содержания файла.url
Расположение персистентного хранилища.
error
Если никакое хранилище не найдено в
url
или если существует проблема, устанавливающая ее метаданные, по возврату содержитNSError
объект, описывающий проблему.Возвращаемое значение
YES
true
если метаданные были установлены правильно, иначеNO
false
.Обсуждение
Можно использовать этот метод для установки метаданных для хранилища без издержек создания Базового Стека данных.
Оператор импорта
Objective C
@import CoreData;
Swift
import CoreData
Доступность
Доступный в OS X v10.5 и позже.
-
Возвращает словарь, содержащий метаданные, сохраненные в персистентном хранилище в данном URL.
Объявление
Swift
class func metadataForPersistentStoreOfType(_
storeType
: String?, URLurl
: NSURL, errorerror
: 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.
Объявление
Objective C
+ (NSDictionary *)elementsDerivedFromExternalRecordURL:(NSURL *)
fileURL
Параметры
fileURL
Файл URL, указывающий расположение Центра внимания внешний рекордный файл.
Возвращаемое значение
Словарь, содержащий проанализированные элементы, произошел из файла поддержки Центра внимания, указанного
fileURL
.Обсуждение
Ключи словаря и соответствующие значения описаны в Центре внимания Внешние Рекордные Элементы.
Оператор импорта
Objective C
@import CoreData;
Swift
import CoreData
Доступность
Доступный в OS X v10.6 и позже.
-
importStoreWithIdentifier (_: fromExternalRecordsDirectory:toURL:options:withType:error:) - importStoreWithIdentifier:fromExternalRecordsDirectory:toURL:options:withType:error:
Создает и заполняет хранилище с внешними записями, найденными в данном URL.
Объявление
Swift
func importStoreWithIdentifier(_
storeIdentifier
: String?, fromExternalRecordsDirectoryexternalRecordsURL
: NSURL, toURLdestinationURL
: NSURL, optionsoptions
: [NSObject : AnyObject]?, withTypestoreType
: String, errorerror
: 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 словарь метаданных.
Объявление
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 и позже.
-
-
Ключи для словаря опций, используемого в
addPersistentStoreWithType:configuration:URL:options:error:
,migratePersistentStore:toURL:options:withType:error:
, иimportStoreWithIdentifier:fromExternalRecordsDirectory:toURL:options:withType:error:
.Объявление
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
Флаг, указывающий, обрабатывается ли хранилище как только для чтения или нет.
Значение по умолчанию
NO
false
.Доступный в OS X v10.4 и позже.
-
NSValidateXMLStoreOption
NSValidateXMLStoreOption
Флаг, указывающий, должен ли XML-файл быть проверен с DTD при открытии.
Значение по умолчанию
NO
false
.Доступный в 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
из числаYES
true
, Базовые Данные не сравнят хеши версии между моделью управляемого объекта в координаторе и метаданными для загруженного хранилища. (Это будет, однако, продолжать обновлять информацию о хеше версии в метаданных.) Это ключевое и соответствующее значениеYES
true
указан по умолчанию для всех приложений, соединенных на или перед OS X v10.4.Доступный в OS X v10.5 и позже.
-
NSMigratePersistentStoresAutomaticallyOption
NSMigratePersistentStoresAutomaticallyOption
Ключ, чтобы автоматически попытаться переместить имеющие версию хранилища.
Соответствующее значение
NSNumber
объект. ЕслиboolValue
из числаYES
true
и если информация о хеше версии для добавленного хранилища будет полна решимости быть несовместимой с моделью для координатора, то Базовые Данные попытаются определить местоположение источника и отображающихся моделей в комплектах приложений, и выполнить миграцию.Доступный в OS X v10.5 и позже.
-
NSInferMappingModelAutomaticallyOption
NSInferMappingModelAutomaticallyOption
Ключ, чтобы попытаться создать отображающуюся модель автоматически.
Соответствующее значение
NSNumber
объект. ЕслиboolValue
из числаYES
true
и значениеNSMigratePersistentStoresAutomaticallyOption
YES
true
, координатор попытается вывести отображающуюся модель, если ни один не может быть найден.Доступный в 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
.Объявление
Objective C
NSString * const NSXMLExternalRecordType; NSString * const NSBinaryExternalRecordType;
Константы
-
Ключи для словаря с проанализированными элементами получили из Центра внимания внешний рекордный файл.
Объявление
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 и позже.
-
-
NSPersistentStoreCoordinatorStoresDidChangeNotification NSPersistentStoreCoordinatorStoresDidChangeNotification
Отправленный каждый раз, когда персистентные хранилища добавлены к или удалены от персистентного координатора хранилища, или когда хранилище изменяются UUIDs.
Объект уведомления является затронутым персистентным координатором хранилища. Уведомление
userInfo
словарь содержит информацию о хранилищах, добавленных или удаленных, указанное использование следующих ключей:Оператор импорта
Objective C
@import CoreData;
Swift
import CoreData
Доступность
Доступный в OS X v10.4 и позже.
-
NSPersistentStoreCoordinatorStoresWillChangeNotification NSPersistentStoreCoordinatorStoresWillChangeNotification
Отправленный перед списком открытых персистентных изменений хранилищ.
Это уведомление подобно подобному
NSPersistentStoreCoordinatorStoresDidChangeNotification
. Если приложение будет работать, то Базовые Данные отправят это уведомление прежде, чем реагировать на изменения учетной записи iCloud, или “Удаляют Все” из Документов и Данных.Оператор импорта
Objective C
@import CoreData;
Swift
import CoreData
Доступность
Доступный в OS X v10.9 и позже.
-
NSPersistentStoreCoordinatorWillRemoveStoreNotification NSPersistentStoreCoordinatorWillRemoveStoreNotification
Отправленный каждый раз, когда персистентное хранилище удалено от персистентного координатора хранилища.
Уведомление отправляется во время вызова
NSPersistentStore
willRemoveFromPersistentStoreCoordinator:
метод во время освобождения хранилища или удаления. Объект уведомления является персистентным координатором хранилища, будет удален.Оператор импорта
Objective C
@import CoreData;
Swift
import CoreData
Доступность
Доступный в OS X v10.5 и позже.
-
NSPersistentStoreDidImportUbiquitousContentChangesNotification NSPersistentStoreDidImportUbiquitousContentChangesNotification
Отправленный после того, как записи импортируются из повсеместного довольного хранилище.
Уведомление
object
установлен вNSPersistentStoreCoordinator
экземпляр, зарегистрировавший хранилище. УведомлениеuserInfo
словарь содержит те же ключи какNSManagedObjectContextObjectsDidChangeNotification
уведомление (NSInsertedObjectsKey
,NSUpdatedObjectsKey
NSDeletedObjectsKey
), однако значения являются наборамиNSManagedObjectID
объекты, а не наборыNSManagedObject
объекты.Оператор импорта
Objective C
@import CoreData;
Swift
import CoreData
Доступность
Доступный в OS X v10.7 и позже.