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

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

Разработчик

Ссылка платформы основы ссылка класса NSUserDefaults

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

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

NSUserDefaults

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

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

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

NSUserDefaults класс обеспечивает программируемый интерфейс для взаимодействия с системой значений по умолчанию. Система значений по умолчанию позволяет приложению настраивать свое поведение соответствовать предпочтения пользователя. Например, можно позволить пользователям определять, какие единицы измерения отображения приложения или как часто автоматически сохраняются документы. Приложения записывают такие предпочтения путем присвоения значений ряду параметров в базе данных значений по умолчанию пользователя. Параметры упоминаются как значения по умолчанию, так как они обычно используются для определения состояния по умолчанию приложения при запуске или способе, которым он действует по умолчанию.

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

NSUserDefaults класс обеспечивает удобные методы для доступа к общим типам, таким как плавания, удваивается, целые числа, булевские переменные и URLs. Объект по умолчанию должен быть списком свойств, т.е. экземпляром (или для наборов комбинация экземпляров): NSData, NSString, NSNumber, NSDate, NSArray, или NSDictionary. Если Вы хотите сохранить какой-либо другой тип объекта, необходимо обычно архивировать его для создания экземпляра NSData. Для получения дополнительной информации см. Руководство по программированию Предпочтений и Настроек.

Значения возвратились из NSUserDefaults даже если Вы устанавливаете непостоянный объект как значение, являются неизменными. Например, если Вы устанавливаете непостоянную строку как значение для "MyStringDefault", строка Вы позже получаете использование stringForKey: будет неизменным.

База данных значений по умолчанию создается автоматически для каждого пользователя. NSUserDefaults класс в настоящее время не поддерживает предпочтения на узел. Чтобы сделать это, необходимо использовать API CFPreferences (см. Предпочтительную Ссылку Утилит). Однако NSUserDefaults правильно предпочтения чтений на узел, таким образом, можно безопасно смешать код CFPreferences с NSUserDefaults код.

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

NSUserDefaults класс ориентирован на многопотоковое исполнение.

Персистентность NSURL и ссылки на файл URLs

При использовании экземпляров NSURL для обращения к файлам в процессе важно сделать различие между основанным на местоположении отслеживанием (файл: схема URLs, которые являются в основном путями) по сравнению с отслеживанием идентификационных данных файловой системы (файл: схема URLs, которые являются ссылкой на файл URLs). При сохранении NSURL необходимо принять то поведение во внимание. Если Ваше приложение отслеживает ресурс, располагаемый его идентификационными данными так, чтобы можно было найти, перемещает ли пользователь файл, то необходимо явно записать данные закладки NSURL или закодировать ссылку на файл URL.

Если Вы хотите отследить файл ссылкой, но Вы требуете явного управления, когда разрешение происходит, необходимо заботиться, чтобы выписать данные закладки к NSUserDefaults, а не полагаться - [NSUserDefaults setURL:forKey:]. Это позволяет Вам вызывать + [NSURL URLByResolvingBookmarkData:options:relativeToURL:bookmarkDataIsStale:error:] в то время, когда Вы будете знать, Ваше приложение будет в состоянии обработать потенциальный I/O или требуемые взаимодействия пользовательского интерфейса.

Соображения песочницы

Поигравшее в песочнице приложение не может получить доступ или изменить предпочтения любого другого приложения. (Например, если Вы добавляете доменное использование другого приложения addSuiteNamed: метод, Вы не получаете доступ к предпочтениям того приложения.)

Попытка получить доступ или изменить предпочтения другого приложения не приводит к ошибке, но когда Вы делаете, OS X фактически читает и пишет файлы, расположенные в контейнере Вашего приложения, а не фактических предпочтительных файлах для другого приложения.

Получение совместно используемого экземпляра NSUserDefaults
  • standardUserDefaults () + standardUserDefaults

    Возвращает совместно используемый объект значений по умолчанию.

    Объявление

    Swift

    class func standardUserDefaults() -> NSUserDefaults

    Objective C

    + (NSUserDefaults *)standardUserDefaults

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

    Совместно используемый объект значений по умолчанию.

    Обсуждение

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

    • NSArgumentDomain, состоять из значений по умолчанию проанализировано от параметров приложения

    • Домен идентифицируется идентификатором пакета приложения

    • NSGlobalDomain, состоять из значений по умолчанию означало быть замеченным всеми приложениями

    • Отдельные домены для каждого из предпочтительных языков пользователя

    • NSRegistrationDomain, ряд временных значений по умолчанию, значения которых могут быть установлены приложением гарантировать, что поиски всегда будут успешны

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

  • resetStandardUserDefaults () + resetStandardUserDefaults

    Синхронизирует любые изменения, внесенные в совместно используемый пользовательский объект значений по умолчанию, и выпускает его из памяти.

    Объявление

    Swift

    class func resetStandardUserDefaults()

    Objective C

    + (void)resetStandardUserDefaults

    Обсуждение

    Последующий вызов standardUserDefaults создает новый совместно используемый пользовательский объект значений по умолчанию со стандартным поисковым списком.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

Инициализация объекта NSUserDefaults
  • init () - init

    Возвраты NSUserDefaults объект инициализируется со значениями по умолчанию для текущей учетной записи пользователя.

    Объявление

    Swift

    convenience init()

    Objective C

    - (instancetype)init

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

    Инициализированный NSUserDefaults возразите, чей параметр и регистрационные домены уже устанавливаются.

    Обсуждение

    Этот метод ничего не помещает в поисковый список. Вызовите его, только если Вы выделили свое собственное NSUserDefaults экземпляр вместо того, чтобы использовать совместно используемый.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    + standardUserDefaults

  • - initWithUser: (iOS 7.0)

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

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

    Этот метод никогда не реализовывался для возврата чего-либо кроме значений по умолчанию для текущего пользователя. Использовать standardUserDefaults вместо этого.

    Объявление

    Objective C

    - (id)initWithUser:(NSString *)username

    Параметры

    username

    Имя учетной записи пользователя.

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

    Инициализированный NSUserDefaults возразите, чей параметр и регистрационные домены уже устанавливаются. Если у текущего пользователя нет доступа к указанной учетной записи пользователя, этот метод возвраты nil.

    Обсуждение

    Этот метод ничего не помещает в поисковый список. Вызовите его, только если Вы выделили свое собственное NSUserDefaults экземпляр вместо того, чтобы использовать совместно используемый.

    Вы обычно не используете этот метод для инициализации экземпляра NSUserDefaults. Приложения, использованные суперпользователем, могли бы использовать этот метод для обновления баз данных значений по умолчанию для многих пользователей. У пользователя, запустившего приложение, должен быть надлежащий доступ (чтение, запишите, или оба) к базе данных значений по умолчанию нового пользователя или этому методу возвраты nil.

    Специальные замечания

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в iOS 2.0 и позже.

    Осуждаемый в iOS 7.0.

    См. также

    + standardUserDefaults

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

    Возвраты NSUserDefaults объект инициализируется со значениями по умолчанию для указанной группы приложений.

    Объявление

    Swift

    init?(suiteName suitename: String?)

    Objective C

    - (instancetype)initWithSuiteName:(NSString *)suitename

    Параметры

    suitename

    Имя группы приложений.

    Если Вы передаете nil к этому параметру система использует поисковый список по умолчанию что standardUserDefaults использование метода класса.

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

    Инициализированный NSUserDefaults возразите, чей параметр и регистрационные домены уже устанавливаются.

    Обсуждение

    Используйте этот метод в сценариях, таких как:

    • При разработке комплекта приложения, для совместного использования предпочтений или других данных среди приложений

    • При разработке расширения приложения, для совместного использования предпочтений или других данных между расширением и его содержанием приложения

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 7.0 и позже.

Регистрация значений по умолчанию
  • registerDefaults (_:) - registerDefaults:

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

    Объявление

    Swift

    func registerDefaults(_ dictionary: [NSObject : AnyObject])

    Objective C

    - (void)registerDefaults:(NSDictionary *)dictionary

    Параметры

    dictionary

    Словарь ключей и значений Вы хотите зарегистрироваться.

    Обсуждение

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

    Содержание регистрационного домена не записано в диск; необходимо вызвать этот метод каждый раз, когда приложение запускается. Можно поместить plist файл в каталог и вызов Resources приложения registerDefaults: с содержанием, в котором Вы читаете из того файла.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

Получение значений по умолчанию
  • arrayForKey (_:) - arrayForKey:

    Возвращает массив, связанный с указанным ключом.

    Объявление

    Swift

    func arrayForKey(_ defaultName: String) -> [AnyObject]?

    Objective C

    - (NSArray *)arrayForKey:(NSString *)defaultName

    Параметры

    defaultName

    Ключ в базе данных значений по умолчанию текущего пользователя.

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

    Массив связался с указанным ключом, или nil если ключ не существует, или его значение не NSArray объект.

    Специальные замечания

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – setObject:forKey:

  • boolForKey (_:) - boolForKey:

    Возвращает булево значение, связанное с указанным ключом.

    Объявление

    Swift

    func boolForKey(_ defaultName: String) -> Bool

    Objective C

    - (BOOL)boolForKey:(NSString *)defaultName

    Параметры

    defaultName

    Ключ в базе данных значений по умолчанию текущего пользователя.

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

    Если булево значение связано с defaultName в пользовательских значениях по умолчанию возвращается то значение. Иначе, NOfalse возвращается.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – setBool:forKey:

  • dataForKey (_:) - dataForKey:

    Возвращает объект данных, связанный с указанным ключом.

    Объявление

    Swift

    func dataForKey(_ defaultName: String) -> NSData?

    Objective C

    - (NSData *)dataForKey:(NSString *)defaultName

    Параметры

    defaultName

    Ключ в базе данных значений по умолчанию текущего пользователя.

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

    Объект данных связался с указанным ключом, или nil если ключ не существует, или его значение не NSData объект.

    Специальные замечания

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – setObject:forKey:

  • dictionaryForKey (_:) - dictionaryForKey:

    Возвращает объект словаря, связанный с указанным ключом.

    Объявление

    Swift

    func dictionaryForKey(_ defaultName: String) -> [NSObject : AnyObject]?

    Objective C

    - (NSDictionary *)dictionaryForKey:(NSString *)defaultName

    Параметры

    defaultName

    Ключ в базе данных значений по умолчанию текущего пользователя.

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

    Объект словаря связался с указанным ключом, или nil если ключ не существует, или его значение не NSDictionary объект.

    Специальные замечания

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – setObject:forKey:

  • floatForKey (_:) - floatForKey:

    Возвращает значение с плавающей точкой, связанное с указанным ключом.

    Объявление

    Swift

    func floatForKey(_ defaultName: String) -> Float

    Objective C

    - (float)floatForKey:(NSString *)defaultName

    Параметры

    defaultName

    Ключ в базе данных значений по умолчанию текущего пользователя.

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

    Значение с плавающей точкой связалось с указанным ключом. Если ключ не существует, этот метод возвраты 0.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – setFloat:forKey:

  • integerForKey (_:) - integerForKey:

    Возвращает целочисленное значение, связанное с указанным ключом..

    Объявление

    Swift

    func integerForKey(_ defaultName: String) -> Int

    Objective C

    - (NSInteger)integerForKey:(NSString *)defaultName

    Параметры

    defaultName

    Ключ в базе данных значений по умолчанию текущего пользователя.

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

    Целочисленное значение связалось с указанным ключом. Если указанный ключ не существует, этот метод возвраты 0.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – setInteger:forKey:

  • objectForKey (_:) - objectForKey:

    Возвращает объект, связанный с первым возникновением указанного значения по умолчанию.

    Объявление

    Swift

    func objectForKey(_ defaultName: String) -> AnyObject?

    Objective C

    - (id)objectForKey:(NSString *)defaultName

    Параметры

    defaultName

    Ключ в базе данных значений по умолчанию текущего пользователя.

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

    Объект связался с указанным ключом, или nil если не был найден ключ.

    Обсуждение

    Этот метод ищет домены, включенные в поисковый список в порядке, они перечислены.

    Специальные замечания

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – arrayForKey:
    – dataForKey:
    – dictionaryForKey:
    – stringArrayForKey:
    – stringForKey:

  • stringArrayForKey (_:) - stringArrayForKey:

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

    Объявление

    Swift

    func stringArrayForKey(_ defaultName: String) -> [AnyObject]?

    Objective C

    - (NSArray *)stringArrayForKey:(NSString *)defaultName

    Параметры

    defaultName

    Ключ в базе данных значений по умолчанию текущего пользователя.

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

    Массив NSString объекты, или nil если указанное значение по умолчанию не существует, значение по умолчанию не содержит массив, или массив не содержит NSString объекты.

    Специальные замечания

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – setObject:forKey:

  • stringForKey (_:) - stringForKey:

    Возвращает строку, связанную с указанным ключом.

    Объявление

    Swift

    func stringForKey(_ defaultName: String) -> String?

    Objective C

    - (NSString *)stringForKey:(NSString *)defaultName

    Параметры

    defaultName

    Ключ в базе данных значений по умолчанию текущего пользователя.

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

    Для строковых значений строка связалась с указанным ключом. Для числовых значений, строкового значения числа. Возвраты nil если значение по умолчанию не существует или не является строкой или числовым значением.

    Специальные замечания

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – setObject:forKey:

  • doubleForKey (_:) - doubleForKey:

    Возвращает двойное значение, связанное с указанным ключом.

    Объявление

    Swift

    func doubleForKey(_ defaultName: String) -> Double

    Objective C

    - (double)doubleForKey:(NSString *)defaultName

    Параметры

    defaultName

    Ключ в базе данных значений по умолчанию текущего пользователя.

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

    Двойное значение связалось с указанным ключом. Если ключ не существует, этот метод возвраты 0.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – setDouble:forKey:

  • URLForKey (_:) - URLForKey:

    Возвраты NSURL экземпляр связался с указанным ключом.

    Объявление

    Swift

    func URLForKey(_ defaultName: String) -> NSURL?

    Objective C

    - (NSURL *)URLForKey:(NSString *)defaultName

    Параметры

    defaultName

    Ключ в базе данных значений по умолчанию текущего пользователя.

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

    NSURL значение экземпляра связалось с указанным ключом. Если ключ не существует, этот метод возвраты nil.

    Обсуждение

    Когда NSURL читается с помощью - [NSUserDefaults URLForKey:], следующая логика используется:

    1. Если значение для ключа NSData, NSData используется в качестве параметра +[NSKeyedUnarchiver unarchiveObjectWithData:]. Если NSData может быть разархивирован как NSURL, NSURL возвращается иначе, ноль возвращается.

    2. Если значение для этого ключа было ссылкой на файл URL, ссылка на файл, URL будет создаваться, но его данные закладки не будут разрешены, пока экземпляр NSURL не будет позже использоваться (например, в -[NSData initWithContentsOfURL:]).

    3. Если значение для ключа будет NSString, начинающимся с ~, то NSString будет расширен с помощью -[NSString stringByExpandingTildeInPath] и файл: схема NSURL будет создаваться из этого.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 4.0 и позже.

    См. также

    – setURL:forKey:

Установка значений по умолчанию
  • setBool (_: forKey:) - setBool:forKey:

    Устанавливает значение указанного ключа по умолчанию к указанному булеву значению.

    Объявление

    Swift

    func setBool(_ value: Bool, forKey defaultName: String)

    Objective C

    - (void)setBool:(BOOL)value forKey:(NSString *)defaultName

    Параметры

    value

    Булево значение для хранения в базе данных значений по умолчанию.

    defaultName

    Ключ, с которым можно связаться со значением.

    Обсуждение

    Вызывает setObject:forKey: как часть его реализации.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – boolForKey:

  • setFloat (_: forKey:) - setFloat:forKey:

    Устанавливает значение указанного ключа по умолчанию к указанному значению с плавающей точкой.

    Объявление

    Swift

    func setFloat(_ value: Float, forKey defaultName: String)

    Objective C

    - (void)setFloat:(float)value forKey:(NSString *)defaultName

    Параметры

    value

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

    defaultName

    Ключ, с которым можно связаться со значением.

    Обсуждение

    Вызывает setObject:forKey: как часть его реализации.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – floatForKey:

  • setInteger (_: forKey:) - setInteger:forKey:

    Устанавливает значение указанного ключа по умолчанию к указанному целочисленному значению.

    Объявление

    Swift

    func setInteger(_ value: Int, forKey defaultName: String)

    Objective C

    - (void)setInteger:(NSInteger)value forKey:(NSString *)defaultName

    Параметры

    value

    Целочисленное значение для хранения в базе данных значений по умолчанию.

    defaultName

    Ключ, с которым можно связаться со значением.

    Обсуждение

    Вызывает setObject:forKey: как часть его реализации.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – integerForKey:

  • setObject (_: forKey:) - setObject:forKey:

    Наборы значение указанного значения по умолчанию вводят стандартный домен приложения.

    Объявление

    Swift

    func setObject(_ value: AnyObject?, forKey defaultName: String)

    Objective C

    - (void)setObject:(id)value forKey:(NSString *)defaultName

    Параметры

    value

    Объект сохранить в базе данных значений по умолчанию.

    defaultName

    Ключ, с которым можно связаться со значением.

    Обсуждение

    value параметр может быть только объектами списка свойств: NSData, NSString, NSNumber, NSDate, NSArray, или NSDictionary. Для NSArray и NSDictionary объекты, их содержание должно быть объектами списка свойств. Посмотрите то, Что Список свойств? в Руководстве по программированию Списка свойств.

    Установка значения по умолчанию не имеет никакого эффекта на значение, возвращенное objectForKey: метод, если тот же ключ существует в домене, предшествующем домену приложения в поисковом списке.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – removeObjectForKey:

  • setDouble (_: forKey:) - setDouble:forKey:

    Устанавливает значение указанного ключа по умолчанию к двойному значению.

    Объявление

    Swift

    func setDouble(_ value: Double, forKey defaultName: String)

    Objective C

    - (void)setDouble:(double)value forKey:(NSString *)defaultName

    Параметры

    value

    Двойное значение.

    defaultName

    Ключ, с которым можно связаться со значением.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

  • setURL (_: forKey:) - setURL:forKey:

    Устанавливает значение указанного ключа по умолчанию к указанному URL.

    Объявление

    Swift

    func setURL(_ url: NSURL, forKey defaultName: String)

    Objective C

    - (void)setURL:(NSURL *)url forKey:(NSString *)defaultName

    Параметры

    url

    NSURL сохранить в базе данных значений по умолчанию.

    defaultName

    Ключ, с которым можно связаться со значением.

    Обсуждение

    Когда NSURL сохранен с помощью - [NSUserDefaults setURL:forKey:], некоторые корректировки внесены:

    1. Любой нефайл URL записан путем вызова +[NSKeyedArchiver archivedDataWithRootObject:] использование экземпляра NSURL как корневой объект.

    2. Любая ссылка на файл file: схема URL будет обработана как нефайл URL, и информация, делающая этот URL совместимым с 10,5 системами, будет также записана как часть архива, а также его минимальных данных закладки.

    3. Любой находящийся на пути файл: если путь может быть сделан относительно корневого каталога пользователя, схема URL записана первым взятием абсолютного URL, получением пути от этого и затем определения. Если это может, строка, которая будет сокращаться при помощи stringByAbbreviatingWithTildeInPath и выписанный. Это позволяет пред10.6 клиентам читать значение по умолчанию и использование -[NSString stringByExpandingTildeInPath] использовать эту информацию.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 4.0 и позже.

    См. также

    – URLForKey:

Удаление значений по умолчанию
  • removeObjectForKey (_:) - removeObjectForKey:

    Удаляет значение указанного значения по умолчанию, вводят стандартный домен приложения.

    Объявление

    Swift

    func removeObjectForKey(_ defaultName: String)

    Objective C

    - (void)removeObjectForKey:(NSString *)defaultName

    Параметры

    defaultName

    Ключ, значение которого Вы хотите удалить.

    Обсуждение

    Удаление значения по умолчанию не имеет никакого эффекта на значение, возвращенное objectForKey: метод, если тот же ключ существует в домене, предшествующем стандартному домену приложения в поисковом списке.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – setObject:forKey:

Поддержание персистентных доменов
  • синхронизируйтесь () - синхронизироваться

    Записи любые модификации к персистентным доменам к диску и обновлениям все неизмененные персистентные домены к тому, что находится на диске.

    Объявление

    Swift

    func synchronize() -> Bool

    Objective C

    - (BOOL)synchronize

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

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

    Обсуждение

    Поскольку этот метод автоматически вызывается в периодических интервалах, используйте этот метод, только если Вы не можете ожидать автоматической синхронизации (например, если Ваше приложение собирается выйти), или если Вы хотите обновить пользовательские значения по умолчанию к тому, что находится на диске даже при том, что Вы не внесли изменений.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – persistentDomainForName:
    – removePersistentDomainForName:
    – setPersistentDomain:forName:

  • persistentDomainForName (_:) - persistentDomainForName:

    Возвращает словарь, содержащий ключи и значения в указанном персистентном домене.

    Объявление

    Swift

    func persistentDomainForName(_ domainName: String) -> [NSObject : AnyObject]?

    Objective C

    - (NSDictionary *)persistentDomainForName:(NSString *)domainName

    Параметры

    domainName

    Домен, ключи которого и значения Вы хотите.

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

    Словарь, содержащий ключи. Ключи являются именами значений по умолчанию, и значение, соответствующее каждому ключу, является объектом списка свойств (NSData, NSString, NSNumber, NSDate, NSArray, или NSDictionary).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – removePersistentDomainForName:
    – setPersistentDomain:forName:

  • - persistentDomainNames (iOS 7.0)

    Возвращает массив текущих персистентных доменных имен.

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

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

    Объявление

    Objective C

    - (NSArray *)persistentDomainNames

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

    Массив NSString объекты, содержащие доменные имена.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в iOS 2.0 и позже.

    Осуждаемый в iOS 7.0.

    См. также

    – removePersistentDomainForName:
    – setPersistentDomain:forName:

  • removePersistentDomainForName (_:) - removePersistentDomainForName:

    Удаляет содержание указанного персистентного домена от значений по умолчанию пользователя.

    Объявление

    Swift

    func removePersistentDomainForName(_ domainName: String)

    Objective C

    - (void)removePersistentDomainForName:(NSString *)domainName

    Параметры

    domainName

    Домен, ключи которого и значения Вы хотите.

    Обсуждение

    Когда персистентный домен изменяется, NSUserDefaultsDidChangeNotification отправляется.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – setPersistentDomain:forName:
    – persistentDomainNames

  • setPersistentDomain (_: forName:) - setPersistentDomain:forName:

    Устанавливает словарь для указанного персистентного домена.

    Объявление

    Swift

    func setPersistentDomain(_ domain: [NSObject : AnyObject], forName domainName: String)

    Objective C

    - (void)setPersistentDomain:(NSDictionary *)domain forName:(NSString *)domainName

    Параметры

    domain

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

    domainName

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

    Обсуждение

    Когда персистентный домен изменяется, NSUserDefaultsDidChangeNotification отправляется.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – persistentDomainForName:
    – persistentDomainNames

Доступ к ключам управляемой среды
  • objectIsForcedForKey (_:) - objectIsForcedForKey:

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

    Объявление

    Swift

    func objectIsForcedForKey(_ key: String) -> Bool

    Objective C

    - (BOOL)objectIsForcedForKey:(NSString *)key

    Параметры

    key

    Ключ, состояние которого Вы хотите проверить.

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

    YEStrue если значением указанного ключа управляет администратор, иначе NOfalse.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – objectIsForcedForKey:inDomain:

  • objectIsForcedForKey (_: inDomain:) - objectIsForcedForKey:inDomain:

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

    Объявление

    Swift

    func objectIsForcedForKey(_ key: String, inDomain domain: String) -> Bool

    Objective C

    - (BOOL)objectIsForcedForKey:(NSString *)key inDomain:(NSString *)domain

    Параметры

    key

    Ключ, состояние которого Вы хотите проверить.

    domain

    Домен ключа.

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

    YEStrue если ключом управляет администратор в указанном домене, иначе NOfalse.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – objectIsForcedForKey:

Управление поисковым списком
  • dictionaryRepresentation () - dictionaryRepresentation

    Возвращает словарь, содержащий объединение всех пар ключ/значение в доменах в поисковом списке.

    Объявление

    Swift

    func dictionaryRepresentation() -> [NSObject : AnyObject]

    Objective C

    - (NSDictionary *)dictionaryRepresentation

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

    Словарь, содержащий ключи. Ключи являются именами значений по умолчанию, и значение, соответствующее каждому ключу, является объектом списка свойств (NSData, NSString, NSNumber, NSDate, NSArray, или NSDictionary).

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

Поддержание энергозависимых доменов
  • removeVolatileDomainForName (_:) - removeVolatileDomainForName:

    Удаляет указанный энергозависимый домен из значений по умолчанию пользователя.

    Объявление

    Swift

    func removeVolatileDomainForName(_ domainName: String)

    Objective C

    - (void)removeVolatileDomainForName:(NSString *)domainName

    Параметры

    domainName

    Энергозависимый домен Вы хотите удалить.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – setVolatileDomain:forName:

  • setVolatileDomain (_: forName:) - setVolatileDomain:forName:

    Устанавливает словарь для указанного энергозависимого домена.

    Объявление

    Swift

    func setVolatileDomain(_ domain: [NSObject : AnyObject], forName domainName: String)

    Objective C

    - (void)setVolatileDomain:(NSDictionary *)domain forName:(NSString *)domainName

    Параметры

    domain

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

    domainName

    Домен, ключи которого и значения Вы хотите установить.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – volatileDomainForName:
    – volatileDomainNames

  • volatileDomainForName (_:) - volatileDomainForName:

    Возвращает словарь для указанного энергозависимого домена.

    Объявление

    Swift

    func volatileDomainForName(_ domainName: String) -> [NSObject : AnyObject]

    Objective C

    - (NSDictionary *)volatileDomainForName:(NSString *)domainName

    Параметры

    domainName

    Домен, ключи которого и значения Вы хотите.

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

    Словарь ключей и значений, принадлежащих домену. Ключи в словаре являются именами значений по умолчанию, и значение, соответствующее каждому ключу, является объектом списка свойств (NSData, NSString, NSNumber, NSDate, NSArray, или NSDictionary).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – removeVolatileDomainForName:
    – setVolatileDomain:forName:

  • volatileDomainNames Свойство

    Текущие энергозависимые доменные имена. (только для чтения)

    Объявление

    Swift

    var volatileDomainNames: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *volatileDomainNames

    Обсуждение

    Доменные имена представлены как строки. Можно получить содержание каждого домена путем передачи возвращенных доменных имен volatileDomainForName: метод.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – removeVolatileDomainForName:
    – setVolatileDomain:forName:

Поддержание комплектов
  • addSuiteNamed (_:) - addSuiteNamed:

    Указывает указанное доменное имя в поисковый список получателя.

    Объявление

    Swift

    func addSuiteNamed(_ suiteName: String)

    Objective C

    - (void)addSuiteNamed:(NSString *)suiteName

    Параметры

    suiteName

    Доменное имя для вставки. Этот домен вставляется после домена приложения.

    Обсуждение

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    + standardUserDefaults
    – removeSuiteNamed:

  • removeSuiteNamed (_:) - removeSuiteNamed:

    Удаляет указанное доменное имя из поискового списка получателя.

    Объявление

    Swift

    func removeSuiteNamed(_ suiteName: String)

    Objective C

    - (void)removeSuiteNamed:(NSString *)suiteName

    Параметры

    suiteName

    Доменное имя для удаления.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – addSuiteNamed:

Константы
  • Домены NSUserDefaults

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

    Объявление

    Swift

    let NSGlobalDomain: String let NSArgumentDomain: String let NSRegistrationDomain: String

    Objective C

    extern NSString *NSGlobalDomain; extern NSString *NSArgumentDomain; extern NSString *NSRegistrationDomain;

    Константы

    • NSGlobalDomain

      Домен, состоящий из значений по умолчанию, означал быть замеченным всеми приложениями.

      Доступный в iOS 2.0 и позже.

    • NSArgumentDomain

      Домен, состоящий из значений по умолчанию, проанализирован от параметров приложения. Это одна или более пар формы - значение по умолчанию, включенное в вызов командной строки приложения.

      Доступный в iOS 2.0 и позже.

    • NSRegistrationDomain

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

      Доступный в iOS 2.0 и позже.

Уведомления
  • NSUserDefaultsDidChangeNotification NSUserDefaultsDidChangeNotification

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

    Объект уведомления NSUserDefaults объект. Это уведомление не содержит a userInfo словарь.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.