NSKeyValueCoding

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

Основные методы для доступа к значениям объекта setValue:forKey:, который устанавливает значение для свойства, идентифицированного указанным ключом, и valueForKey:, который возвращает значение для свойства, идентифицированного указанным ключом. Реализация по умолчанию использует методы доступа, обычно реализованные объектами (или к переменным экземпляра доступа непосредственно в случае необходимости).

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

Не применимый

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

Не применимый

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Получение значений

valueForKey (_:) - valueForKey:

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

Объявление

Swift

func valueForKey(_ key: String) -> AnyObject?

Objective C

- (id)valueForKey:(NSString *)key

Параметры

key

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

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

Значение для свойства, идентифицированного key.

Обсуждение

Поисковый образец это valueForKey: использование, чтобы найти, что правильное значение возвращается, описано в Подробных данных Реализации Поиска Средства доступа в Значении ключа, Кодирующем Руководство по программированию.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– valueForKeyPath:


    
    valueForKeyPath (_:)
    - valueForKeyPath:

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

Объявление

Swift

func valueForKeyPath(_ keyPath: String) -> AnyObject?

Objective C

- (id)valueForKeyPath:(NSString *)keyPath

Параметры


      keyPath

Ключевой путь формы relationship.property (с одним или более отношениями); например, «department.name» или «department.manager.lastName».

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

Значение для полученного свойства, идентифицированного keyPath.

Обсуждение

Реализация по умолчанию получает целевой объект для каждого использования отношения valueForKey: и возвращает результат a valueForKey: обменивайтесь сообщениями к конечному объекту.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– setValue:forKeyPath:


    
    dictionaryWithValuesForKeys (_:)
    - dictionaryWithValuesForKeys:

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

Объявление

Swift

func dictionaryWithValuesForKeys(_ keys: [AnyObject]) -> [NSObject : AnyObject]

Objective C

- (NSDictionary *)dictionaryWithValuesForKeys:(NSArray *)keys

Параметры


      keys

Массив, содержащий NSString объекты, идентифицирующие свойства получателя.

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

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

Обсуждение

Реализация по умолчанию вызывает valueForKey: для каждого ключа keys и замены NSNull значения в словаре для возвращенного nil значения.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– setValuesForKeysWithDictionary:

valueForUndefinedKey (_:) - valueForUndefinedKey:

Вызванный valueForKey: когда это не находит свойства, соответствующего данному ключу.

Объявление

Swift

func valueForUndefinedKey(_ key: String) -> AnyObject?

Objective C

- (id)valueForUndefinedKey:(NSString *)key

Параметры

key

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

Обсуждение

Подклассы могут переопределить этот метод для возврата альтернативного значения для неопределенных ключей. Реализация по умолчанию повышает NSUndefinedKeyException.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– setValue:forUndefinedKey:
mutableArrayValueForKey (_:) - mutableArrayValueForKey:

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

Объявление

Swift

func mutableArrayValueForKey(_ key: String) -> NSMutableArray

Objective C

- (NSMutableArray *)mutableArrayValueForKey:(NSString *)key

Параметры

key

Имя упорядоченного - многие отношение.

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

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

Обсуждение

Объекты, добавленные к непостоянному массиву, становятся связанными с получателем, и объекты, удаленные из непостоянного массива, становятся не связанными. Реализация по умолчанию распознает те же простые методы доступа и методы доступа массива как valueForKey:, и следует за теми же прямыми политиками доступа переменной экземпляра, но всегда возвращает непостоянный объект прокси набора вместо неизменного набора это valueForKey: возвратился бы.

Поисковый образец это mutableArrayValueForKey: использование описано в Подробных данных Реализации Поиска Средства доступа в Значении ключа, Кодирующем Руководство по программированию.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– mutableArrayValueForKeyPath:
– mutableOrderedSetValueForKey:


    
    mutableArrayValueForKeyPath (_:)
    - mutableArrayValueForKeyPath:

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

Объявление

Swift

func mutableArrayValueForKeyPath(_ keyPath: String) -> NSMutableArray

Objective C

- (NSMutableArray *)mutableArrayValueForKeyPath:(NSString *)keyPath

Параметры


      keyPath

Ключевой путь, относительно получателя, к упорядоченному - многие отношение.

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

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

Обсуждение

Посмотрите mutableArrayValueForKey: для дополнительных подробных данных.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– mutableArrayValueForKey:
– mutableOrderedSetValueForKeyPath:

mutableSetValueForKey (_:) - mutableSetValueForKey:

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

Объявление

Swift

func mutableSetValueForKey(_ key: String) -> NSMutableSet

Objective C

- (NSMutableSet *)mutableSetValueForKey:(NSString *)key

Параметры

key

Имя неупорядоченного к - многие отношение.

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

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

Обсуждение

Объекты, добавленные к непостоянному прокси набора, становятся связанными с получателем, и объекты, удаленные из непостоянного набора, становятся не связанными. Реализация по умолчанию распознает те же простые методы доступа и методы доступа набора как valueForKey:, и следует за теми же прямыми политиками доступа переменной экземпляра, но всегда возвращает непостоянный объект прокси набора вместо неизменного набора это valueForKey: возвратился бы.

Поисковый образец это mutableSetValueForKey: использование описано в Подробных данных Реализации Поиска Средства доступа в Значении ключа, Кодирующем Руководство по программированию.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– mutableArrayValueForKeyPath:
– mutableOrderedSetValueForKey:


    
    mutableSetValueForKeyPath (_:)
    - mutableSetValueForKeyPath:

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

Объявление

Swift

func mutableSetValueForKeyPath(_ keyPath: String) -> NSMutableSet

Objective C

- (NSMutableSet *)mutableSetValueForKeyPath:(NSString *)keyPath

Параметры


      keyPath

Ключевой путь, относительно получателя, к неупорядоченному к - многие отношение.

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

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

Обсуждение

Посмотрите mutableSetValueForKey: для дополнительных подробных данных.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– mutableArrayValueForKey:
– mutableOrderedSetValueForKeyPath:

mutableOrderedSetValueForKey (_:) - mutableOrderedSetValueForKey:

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

Объявление

Swift

func mutableOrderedSetValueForKey(_ key: String) -> NSMutableOrderedSet

Objective C

- (NSMutableOrderedSet *)mutableOrderedSetValueForKey:(NSString *)key

Параметры

key

Имя uniquing, упорядоченного - многие отношение.

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

Непостоянный упорядоченный набор, обеспечивающий доступ для чтения-записи к uniquing к - многие отношение, указанное key.

Обсуждение

Объекты, добавленные к непостоянному прокси набора, становятся связанными с получателем, и объекты, удаленные из непостоянного набора, становятся не связанными. Реализация по умолчанию распознает те же простые методы доступа и методы доступа набора как valueForKey:, и следует за теми же прямыми политиками доступа переменной экземпляра, но всегда возвращает непостоянный объект прокси набора вместо неизменного набора это valueForKey: возвратился бы.

Поисковый образец это mutableOrderedSetValueForKey: использование описано в Подробных данных Реализации Поиска Средства доступа в Значении ключа, Кодирующем Руководство по программированию.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    mutableOrderedSetValueForKeyPath (_:)
    - mutableOrderedSetValueForKeyPath:

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

Объявление

Swift

func mutableOrderedSetValueForKeyPath(_ keyPath: String) -> NSMutableOrderedSet

Objective C

- (NSMutableOrderedSet *)mutableOrderedSetValueForKeyPath:(NSString *)keyPath

Параметры


      keyPath

Ключевой путь, относительно получателя, к uniquing, упорядоченному - многие отношение, представлен набором.

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

Непостоянный упорядоченный набор, обеспечивающий доступ для чтения-записи к uniquing к - многие отношение, указанное keyPath.

Обсуждение

Посмотрите mutableOrderedSetValueForKey: для дополнительных подробных данных.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Установка значений


    
    setValue (_: forKeyPath:)
    - setValue:forKeyPath:

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

Объявление

Swift

func setValue(_ value: AnyObject?, forKeyPath keyPath: String)

Objective C

- (void)setValue:(id)value forKeyPath:(NSString *)keyPath

Параметры

`value`	Значение для свойства, идентифицированного `keyPath`.
`keyPath`	Ключевой путь формы relationship.property (с одним или более отношениями): например, «department.name» или «department.manager.lastName».

Обсуждение

Реализация по умолчанию этого метода получает целевой объект для каждого использования отношения valueForKey:, и отправляет конечный объект a setValue:forKey: сообщение.

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

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– valueForKeyPath:


    
    setValuesForKeysWithDictionary (_:)
    - setValuesForKeysWithDictionary:

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

Объявление

Swift

func setValuesForKeysWithDictionary(_ keyedValues: [NSObject : AnyObject])

Objective C

- (void)setValuesForKeysWithDictionary:(NSDictionary *)keyedValues

Параметры


      keyedValues

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

Обсуждение

Реализация по умолчанию вызывает setValue:forKey: для каждой пары ключ/значение, занимая место nil для NSNull значения в keyedValues.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– dictionaryWithValuesForKeys:

setNilValueForKey (_:) - setNilValueForKey:

Вызванный setValue:forKey: когда это дало a nil значение для скалярного значения (такой как int или float).

Объявление

Swift

func setNilValueForKey(_ key: String)

Objective C

- (void)setNilValueForKey:(NSString *)key

Параметры

key

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

Обсуждение

Подклассы могут переопределить этот метод для обрабатывания запроса некоторым другим способом, такой как путем замены 0 или сигнальная метка оценивает за nil и вызов setValue:forKey: снова или установка переменной непосредственно. Реализация по умолчанию повышает NSInvalidArgumentException.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    setValue (_: forKey:)
    - setValue:forKey:

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

Объявление

Swift

func setValue(_ value: AnyObject?, forKey key: String)

Objective C

- (void)setValue:(id)value forKey:(NSString *)key

Параметры

`value`	Значение для свойства, идентифицированного `key`.
`key`	Имя одного из свойств получателя.

Обсуждение

Если key идентифицирует для - одно отношение, свяжите объект, указанный value к получателю, не связывая ранее связанный объект, если был тот. Учитывая объект коллекции и a key это идентифицирует для - многие отношение, свяжите объекты, содержавшиеся в наборе к получателю, не связав ранее связанные объекты, если был кто-либо.

Поисковый образец это setValue:forKey: использование описано в Подробных данных Реализации Поиска Средства доступа в Значении ключа, Кодирующем Руководство по программированию.

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    setValue (_: forUndefinedKey:)
    - setValue:forUndefinedKey:

Вызванный setValue:forKey: когда это не находит свойства для данного ключа.

Объявление

Swift

func setValue(_ value: AnyObject?, forUndefinedKey key: String)

Objective C

- (void)setValue:(id)value forUndefinedKey:(NSString *)key

Параметры

`value`	Значение для ключа, идентифицированного `key`.
`key`	Строка, которая не равна имени ни одного из свойств получателя.

Обсуждение

Подклассы могут переопределить этот метод для обрабатывания запроса некоторым другим способом. Реализация по умолчанию повышает NSUndefinedKeyException.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– valueForUndefinedKey:

Изменение поведения по умолчанию

accessInstanceVariablesDirectly () + accessInstanceVariablesDirectly

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

Объявление

Swift

class func accessInstanceVariablesDirectly() -> Bool

Objective C

+ (BOOL)accessInstanceVariablesDirectly

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

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

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Проверка


    
    validateValue (_: forKey:error:)
    - validateValue:forKey:error:

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

Объявление

Swift

func validateValue(_ ioValue: AutoreleasingUnsafeMutablePointer<AnyObject?>, forKey key: String, error outError: NSErrorPointer) -> Bool

Objective C

- (BOOL)validateValue:(inout id *)ioValue forKey:(NSString *)key error:(out NSError **)outError

Параметры

`ioValue`	Указатель на новое значение для свойства, идентифицированного `key`. Этот метод может изменить или заменить значение для создания его допустимым.
`key`	Имя одного из свойств получателя. Ключ должен указать атрибут или к - одно отношение.
`outError`	Если проверка необходима и `ioValue` не преобразовывается в допустимое значение, по возврату содержит `NSError` объект, описывающий причину это `ioValue` не допустимое значение.

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

YES, если *ioValue допустимое значение для свойства, идентифицированного key, или если метод в состоянии изменить значение к *ioValue сделать его допустимым; иначе NOfalse.

Обсуждение

Реализация по умолчанию этого метода ищет класс получателя для метода проверки, имя которого соответствует образец validate<Ключ>:error:. Если такой метод найден, он вызывается, и результат возвращается. Если никакой такой метод не найден, YEStrue возвращается.

Отправителю сообщения никогда не дают ответственность за выпуск ioValue или outError.

Посмотрите Проверку Значения ключа для получения дополнительной информации.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– validateValue:forKeyPath:error:


    
    validateValue (_: forKeyPath:error:)
    - validateValue:forKeyPath:error:

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

Объявление

Swift

func validateValue(_ ioValue: AutoreleasingUnsafeMutablePointer<AnyObject?>, forKeyPath key: String, error outError: NSErrorPointer) -> Bool

Objective C

- (BOOL)validateValue:(inout id *)ioValue forKeyPath:(NSString *)key error:(out NSError **)outError

Параметры

`ioValue`	Указатель на новое значение для свойства, идентифицированного `keyPath`. Этот метод может изменить или заменить значение для создания его допустимым.
`key`	Имя одного из свойств получателя. Ключевой путь должен указать атрибут или к - одно отношение. Ключевой путь имеет форму relationship.property (с одним или более отношениями); например, «department.name» или «department.manager.lastName».
`outError`	Если проверка необходима и `ioValue` не преобразовывается в допустимое значение, по возврату содержит `NSError` объект, описывающий причину это `ioValue` не допустимое значение.

Обсуждение

Реализация по умолчанию получает целевой объект для каждого использования отношения valueForKey: и возвращает результат a validateValue:forKey:error: обменивайтесь сообщениями к конечному объекту.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– validateValue:forKey:error:

Устаревшие методы

useStoredAccessor + useStoredAccessor (OS X v10.4)

Возвраты YEStrue если методы хранимой суммы storedValueForKey: и takeStoredValue:forKey: должен использовать частные методы доступа в предпочтении к общедоступным средствам доступа.

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

Этот метод не имеет никакой прямой замены, несмотря на то, что см. accessInstanceVariablesDirectly.

Объявление

Objective C

+ (BOOL)useStoredAccessor

Обсуждение

Возврат NOfalse заставляет методы хранимой суммы использовать тот же порядок поиска метода доступа или переменной экземпляра в качестве соответствующих основных методов кодирования значения ключа (valueForKey: и takeValue:forKey:). Возвраты реализации по умолчанию YEStrue.

Приложения должны использовать valueForKey: и setValue:forKey: методы вместо storedValueForKey: и takeStoredValue:forKey:.

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.4.
handleQueryWithUnboundKey: - handleQueryWithUnboundKey: (OS X v10.3)

Вызванный valueForKey: когда это не находит соответствия свойства key.

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

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

Объявление

Objective C

- (id)handleQueryWithUnboundKey:(NSString *)key

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.3.
handleTakeValue:forUnboundKey: - handleTakeValue:forUnboundKey: (OS X v10.3)

Вызванный takeValue:forKey: когда это не находит привязки свойства для key.

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

Использовать setValue:forUndefinedKey: вместо этого.

Объявление

Objective C

- (void)handleTakeValue:(id)value forUnboundKey:(NSString *)key

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.3.
storedValueForKey: - storedValueForKey: (OS X v10.4)
Возвращает свойство, идентифицированное данным ключом.

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

Если Вы используете NSManagedObject класс, использовать primitiveValueForKey: вместо этого.

Объявление

Objective C

- (id)storedValueForKey:(NSString *)key
Обсуждение

Этот метод используется, когда значение получено для хранения в объектно-ориентированной памяти (обычно, это хранение находится в конечном счете в базе данных), или для включения в снимок. Реализация по умолчанию подобна реализации valueForKey:, но это решает key с различным методом/переменной экземпляра ищут порядок:
1. Поиски частного метода доступа на основе key (метод, которому предшествует underbar). Например, с a key из «lastName», storedValueForKey: ищет названный метод _getLastName или _lastName.
2. Если частное средство доступа не найдено, ищет переменную экземпляра на основе key и возвращает его значение непосредственно. Например, с a key из «lastName», storedValueForKey: ищет названную переменную экземпляра _lastName или lastName.
3. Если ни частное средство доступа, ни переменная экземпляра не найдены, storedValueForKey: поиски общедоступного метода доступа на основе key. Для key «lastName», это было бы getLastName или lastName.
4. Если key неизвестно, storedValueForKey: вызовы handleTakeValue:forUnboundKey:.
Этот различный поисковый порядок позволяет объекту обойти обработку, выполняющуюся прежде, чем возвратить значение через общедоступный API. Однако, если Вы всегда хотите использовать поисковый порядок в valueForKey:, можно реализовать метод класса useStoredAccessor возвратиться NOfalse. И как с valueForKey:, можно предотвратить прямой доступ переменной экземпляра с методом класса accessInstanceVariablesDirectly.
Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.4.
takeStoredValue:forKey: - takeStoredValue:forKey: (OS X v10.4)
Устанавливает значение свойства, идентифицированного данным ключом.

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

Если Вы используете NSManagedObject класс, использовать setPrimitiveValue:forKey: вместо этого.

Объявление

Objective C

- (void)takeStoredValue:(id)value forKey:(NSString *)key
Обсуждение

Этот метод используется для инициализации получателя со значениями от объектно-ориентированной памяти (обычно, это хранение в конечном счете от базы данных) или восстановить значение от снимка. Реализация по умолчанию подобна реализации takeValue:forKey:, но это решает key с различным методом/переменной экземпляра ищут порядок:
1. Поиски частного метода доступа на основе key (метод, которому предшествует underbar). Например, с a key из «lastName», takeStoredValue:forKey: ищет названный метод _setLastName:.
2. Если частное средство доступа не найдено, ищет переменную экземпляра на основе key и наборы value непосредственно. Например, с a key из «lastName», takeStoredValue:forKey: ищет названную переменную экземпляра _lastName или lastName.
3. Если ни частное средство доступа, ни переменная экземпляра не найдены, takeStoredValue:forKey: поиски общедоступного метода доступа на основе key. Для key «lastName», это было бы setLastName:.
4. Если key неизвестно, takeStoredValue:forKey: вызовы handleTakeValue:forUnboundKey:.
Этот различный поисковый порядок позволяет объекту обойти обработку, выполняющуюся прежде, чем установить значение через общедоступный API. Однако, если Вы всегда хотите использовать поисковый порядок в takeValue:forKey:, можно реализовать метод класса useStoredAccessor возвратиться NOfalse. И как с valueForKey:, можно предотвратить прямой доступ переменной экземпляра с методом класса accessInstanceVariablesDirectly.
Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.4.
takeValuesFromDictionary: - takeValuesFromDictionary: (OS X v10.3)

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

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

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

Объявление

Objective C

- (void)takeValuesFromDictionary:(NSDictionary *)properties

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.3.
takeValue:forKeyPath: - takeValue:forKeyPath: (OS X v10.3)

Устанавливает значение для свойства, идентифицированного keyPath к value.

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

Использовать setValue:forKeyPath: вместо этого.

Объявление

Objective C

- (void)takeValue:(id)value forKeyPath:(NSString *)keyPath

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.3.
takeValue:forKey: - takeValue:forKey: (OS X v10.3)

Устанавливает значение для свойства, идентифицированного key к value.

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

Использовать setValue:forKey: вместо этого.

Объявление

Objective C

- (void)takeValue:(id)value forKey:(NSString *)key

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.3.
unableToSetNilForKey: - unableToSetNilForKey: (OS X v10.3)

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

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

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

Объявление

Objective C

- (void)unableToSetNilForKey:(NSString *)key

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.3.
valuesForKeys: - valuesForKeys: (OS X v10.3)

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

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

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

Объявление

Objective C

- (NSDictionary *)valuesForKeys:(NSArray *)keys

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

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.3.

Константы

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

Объявление

Swift

let NSUndefinedKeyException: NSString!

Objective C

extern NSString *NSUndefinedKeyException;

Константы
- NSUndefinedKeyException
  
  NSUndefinedKeyException
  
  Повышенный, когда работа кодирования значения ключа перестала работать. userInfo ключи описаны в ключах NSUndefinedKeyException userInfo
  
  Доступный в OS X v10.3 и позже.
Ключи NSUndefinedKeyException userInfo
Эти константы являются ключами в NSUndefinedKeyException userInfo словарь

Объявление

Objective C

extern NSString *NSTargetObjectUserInfoKey; extern NSString *NSUnknownUserInfoKey;

Константы
- NSTargetObjectUserInfoKey
  
  NSTargetObjectUserInfoKey
  
  Объект, на котором перестала работать работа кодирования значения ключа.
- NSUnknownUserInfoKey
  
  NSUnknownUserInfoKey
  
  Ключ, для которого перестала работать работа кодирования значения ключа.
Обсуждение

Поскольку дополнительная информация видит, что Значение ключа Кодирует Имена Исключения.
Операторы массива
Эти константы определяют доступных операторов массива. Посмотрите Операторов Набора и Массива для получения дополнительной информации.

Объявление

Swift

let NSAverageKeyValueOperator: NSString! let NSCountKeyValueOperator: NSString! let NSDistinctUnionOfArraysKeyValueOperator: NSString! let NSDistinctUnionOfObjectsKeyValueOperator: NSString! let NSDistinctUnionOfSetsKeyValueOperator: NSString! let NSMaximumKeyValueOperator: NSString! let NSMinimumKeyValueOperator: NSString! let NSSumKeyValueOperator: NSString! let NSUnionOfArraysKeyValueOperator: NSString! let NSUnionOfObjectsKeyValueOperator: NSString! let NSUnionOfSetsKeyValueOperator: NSString!

Objective C

NSString *const NSAverageKeyValueOperator; NSString *const NSCountKeyValueOperator; NSString *const NSDistinctUnionOfArraysKeyValueOperator; NSString *const NSDistinctUnionOfObjectsKeyValueOperator; NSString *const NSDistinctUnionOfSetsKeyValueOperator; NSString *const NSMaximumKeyValueOperator; NSString *const NSMinimumKeyValueOperator; NSString *const NSSumKeyValueOperator; NSString *const NSUnionOfArraysKeyValueOperator; NSString *const NSUnionOfObjectsKeyValueOperator; NSString *const NSUnionOfSetsKeyValueOperator;

Константы
- NSAverageKeyValueOperator
  
  NSAverageKeyValueOperator
  
  @avg оператор массива.
  
  Доступный в OS X v10.4 и позже.
- NSCountKeyValueOperator
  
  NSCountKeyValueOperator
  
  @count оператор массива.
  
  Доступный в OS X v10.4 и позже.
- NSDistinctUnionOfArraysKeyValueOperator
  
  NSDistinctUnionOfArraysKeyValueOperator
  
  @distinctUnionOfArrays оператор массива.
  
  Доступный в OS X v10.4 и позже.
- NSDistinctUnionOfObjectsKeyValueOperator
  
  NSDistinctUnionOfObjectsKeyValueOperator
  
  @distinctUnionOfObjects оператор массива.
  
  Доступный в OS X v10.4 и позже.
- NSDistinctUnionOfSetsKeyValueOperator
  
  NSDistinctUnionOfSetsKeyValueOperator
  
  @distinctUnionOfSets оператор массива.
  
  Доступный в OS X v10.4 и позже.
- NSMaximumKeyValueOperator
  
  NSMaximumKeyValueOperator
  
  @max оператор массива.
  
  Доступный в OS X v10.4 и позже.
- NSMinimumKeyValueOperator
  
  NSMinimumKeyValueOperator
  
  @min оператор массива.
  
  Доступный в OS X v10.4 и позже.
- NSSumKeyValueOperator
  
  NSSumKeyValueOperator
  
  @sum оператор массива.
  
  Доступный в OS X v10.4 и позже.
- NSUnionOfArraysKeyValueOperator
  
  NSUnionOfArraysKeyValueOperator
  
  @unionOfArrays оператор массива.
  
  Доступный в OS X v10.4 и позже.
- NSUnionOfObjectsKeyValueOperator
  
  NSUnionOfObjectsKeyValueOperator
  
  @unionOfObjects оператор массива.
  
  Доступный в OS X v10.4 и позже.
- NSUnionOfSetsKeyValueOperator
  
  NSUnionOfSetsKeyValueOperator
  
  @unionOfSets оператор массива.
  
  Доступный в OS X v10.4 и позже.
Доступность

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