NSURL

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

Можно использовать объекты URL создать URLs и получить доступ к их частям. Для URLs, представляющего локальные файлы, можно также управлять свойствами тех файлов непосредственно, такими как изменение даты последнего изменения файла. Наконец, можно передать объекты URL другому APIs для получения содержания того URLs. Например, можно использовать NSURLSession, NSURLConnection, и NSURLDownload классы для доступа к содержанию удаленных ресурсов, как описано в Руководстве по программированию Загрузочной системы URL.

Объекты URL являются предпочтительным способом относиться к локальным файлам. Большинство объектов, считывающих данные из или данные записи к файлу, имеет методы, принимающие NSURL объект вместо пути как ссылка на файл. Например, можно получить содержание локального файла URL как NSString объект путем вызова stringWithContentsOfURL:encoding:error: метод, или как NSData объект путем вызова dataWithContentsOfURL:options:error: метод.

Можно также использовать URLs для межсвязи приложений. В OS X, NSWorkspace класс обеспечивает openURL: метод для открытия расположения, указанного URL. Точно так же в iOS, UIApplication класс обеспечивает openURL: метод.

Кроме того, можно использовать URLs при работе с областями монтажа, как описано в Дополнительной Ссылке NSURL (часть платформы AppKit).

Структура URL

NSURL объект составлен из двух частей — потенциально nil базовый URL и строка, разрешенная относительно базового URL. NSURL если его строковая часть полностью разрешена без основы, объект считают абсолютным; весь другой URLs считают относительным.

Например, при построении NSURL объект, Вы могли бы указать file:///path/to/web_root/ как базовый URL и folder/file.html как строковая часть, следующим образом:

          NSURL *baseURL = [NSURL URLWithString:@"file:///path/to/web_root/"];
    NSURL *url = [NSURL URLWithString:@"folder/file.html" relativeToURL:baseURL];
    NSURL *absURL = [url absoluteURL];
    NSLog(@"absURL = %@", absURL);

Когда полностью разрешено, абсолютный URL file:///path/to/web_root/folder/file.html.

URL в целом может также быть разделен на части на основе его структуры. Например, URL https://www.example.com/script?name=value содержит схему URL (https), узел (www.example.com), путь (/script), и строка запроса (name=value). NSURL класс обеспечивает методы доступа, позволяющие Вам исследовать те части.

Закладки и объем безопасности

Начиная с OS X v10.6 и iOS 4.0, NSURL класс предоставляет средство для создания и использования объектов закладки. Закладка обеспечивает персистентную ссылку на ресурс файловой системы. При разрешении закладки Вы получаете URL к текущему расположению ресурса. Связь закладки с ресурсом файловой системы (обычно файл или папка) обычно продолжает работать, если пользователь перемещает или переименовывает ресурс, или если пользователь повторно запускает Ваше приложение или перезапускает систему.

Для общего введения в использование закладок считайте Располагающиеся Файлы Используя Закладки в Руководстве по программированию Файловой системы.

В приложении OS X, принимающем Тестовую среду приложения, можно использовать ограниченные по объему безопасностью закладки для получения доступа к ресурсам файловой системы вне песочницы приложения. Эти закладки сохраняют намерение пользователя дать Ваш доступ к приложениям ресурсу через запуски приложения. Для получения дополнительной информации о том, как это работает, включая информацию о правах, в которых Вы нуждаетесь в своем проекте XCode, считайте Ограниченные по объему безопасностью Закладки и Персистентный Доступ Ресурса в Руководстве по проектированию Тестовой среды приложения. Методы для использования ограниченных по объему безопасностью закладок описаны в этом документе в Работе с Данными Закладки.

При разрешении ограниченной по объему безопасностью закладки Вы получаете ограниченный по объему безопасностью URL.

Ограниченный по объему безопасностью URLs

Ограниченный по объему безопасностью URLs обеспечивает доступ к ресурсам вне песочницы приложения. В OS X Вы получаете доступ к ограниченному по объему безопасностью URLs при разрешении ограниченной по объему безопасностью закладки. В iOS, приложения, открывающие или перемещающие документы с помощью a UIDocumentPickerViewController также получите ограниченный по объему безопасностью URLs.

Для получения доступа к ограниченному по объему безопасностью URL необходимо вызвать startAccessingSecurityScopedResource метод (или его Базовая эквивалентная Основа, CFURLStartAccessingSecurityScopedResource функция). Для приложений для iOS, если Вы используете a UIDocument для доступа к URL это автоматически управляет ограниченным по объему безопасностью URL для Вас.

Если startAccessingSecurityScopedResource (или CFUrLStartAccessingSecurityScopedResource) возвраты YEStrue, необходимо оставить доступ путем вызова stopAccessingSecurityScopedResource метод (или его Базовая эквивалентная Основа, CFURLStopAccessingSecurityScopedResource функция). Необходимо оставить доступ, как только Вы закончили использовать файл. После вызова этих методов Вы сразу теряете доступ к рассматриваемому ресурсу.

Ограниченный по объему безопасностью URLs и строковые пути

В приложении OS X при копировании ограниченного по объему безопасностью URL копия имеет объем безопасности оригинала. Вы получаете доступ к ресурсу файловой системы (на который URL указывает на), как Вы были бы с исходным URL: путем вызова startAccessingSecurityScopedResource метод (или его Базовая эквивалентная Основа).

Если Вам нужен ограниченный по объему безопасностью путь URL’s как строковое значение (в соответствии с path метод), например, для обеспечения для API, требующего строкового значения, получают путь из URL по мере необходимости. Отметьте, однако, что основанный на операция со строками путь, полученный из ограниченного по объему безопасностью URL, не имеет объема безопасности, и Вы не можете использовать ту строку для получения доступа к ограниченному по объему безопасностью ресурсу.

Обработка отказа создания объекта

Если передаваемый путь не хорошо формируется, классу NSURL не удается создать новый объект NSURL; путь должен соответствовать RFC 2396. Примерами случаев, которые не успешно выполнятся, являются строки, содержащие пробелы и высоко-разрядные символы. Если создание NSURL возражает сбоям, возврату методов создания nil, который Вы должны быть подготовлены обработать. При создании объектов NSURL с помощью путей файловой системы использовать fileURLWithPath: или initFileURLWithPath:, которые обрабатывают тонкие различия между путями URL и путями файловой системы. Если Вы хотите быть терпимыми к уродливым строкам пути, используйте функции, предоставленные Базовой платформой Основы для очистки строк.

Миниатюры документа

С OS X v10.10 и iOS 8.0, класс NSURL включает возможность получить и установить миниатюры документа как свойство ресурса. И в OS X и в iOS, можно получить словарь NSImages или UIImages использование getResourceValue:forKey:error: метод. На OS X можно установить словарь миниатюр с помощью setResourceValue:forKey:error: метод. Можно также получить или установить все миниатюры как NSImage объект с многократными представлениями при помощи NSURLThumbnailKey.

Примечание:

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

В iOS используйте a UIDocument подкласс для управления файлом. Установите миниатюру путем переопределения документа fileAttributesToWriteToURL:forSaveOperation:error: метод и возврат словаря, содержащего надлежащие ключи миниатюры (вместе с любыми другими атрибутами файла).

В OS X следуйте инструкциям для создания миниатюр, данных в Руководстве по программированию Беглого взгляда.

      // Setting a document's thumbnail
 
NSURL *url = [self URLForDocument];
//Save the file here...
 
NSImage *thumbnail = [self createDocumentThumbnail];
 
NSError *error = nil;
BOOL success =
[url setResourceValue:@{NSThumbnail1024x1024SizeKey : thumbnail}
               forKey:NSURLThumbnailDictionaryKey
                error:&error];
 
if (!success) {
    // Handle the error here...
}


  

      // Getting a document's thumbnail
 
NSURL *url = [self URLForDocument];
NSDictionary *thumbnails;
NSError *error;
 
BOOL success =
[url getResourceValue:&thumbnails
               forKey:NSURLThumbnailDictionaryKey
                error:nil];
 
if (!success) {
    // Handle the error here...
}
 
NSImage *image = thumbnails[NSThumbnail1024x1024SizeKey];


  

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

NSObject
NSURL

NSObject
NSURL

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

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Создание объекта NSURL


    
    init (scheme:host:path:)
    - initWithScheme:host:path:

Инициализирует недавно создаваемый NSURL с указанной схемой, узлом и путем.

Объявление

Swift

convenience init?(scheme scheme: String, host host: String?, path path: String)

Objective C

- (instancetype)initWithScheme:(NSString *)scheme host:(NSString *)host path:(NSString *)path

Параметры

`scheme`	Схема объекта NSURL. Например, в URL `http://www.example.com/index.html`, схема `http`.
`host`	Узел к объекту NSURL (например, `www.example.com`). Может быть пустая строка.
`path`	Путь для объекта NSURL (например, `/index.html`). Если путь начинается с тильды, необходимо сначала развернуть его путем вызова `stringByExpandingTildeInPath`.

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

Недавно инициализированный объект NSURL.

Обсуждение

Этот метод автоматически использует кодирование процента для выхода path и host параметры.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    URLWithString:
    + URLWithString:

Создает и возвращает объект NSURL, инициализированный с предоставленной строкой URL.

Объявление

Objective C

+ (instancetype)URLWithString:(NSString *)URLString

Параметры


      URLString

URL представляет в виде строки, с которым можно инициализировать объект NSURL. Должен быть URL, соответствующий RFC 2396. Этот метод синтаксические анализы URLString согласно 1738 и 1808 RFCs.

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

Объект NSURL, инициализированный с URLString. Если строка URL была уродлива или nil, возвраты nil.

Обсуждение

Этот метод ожидает URLString содержать только символы, позволяющиеся в должным образом сформированном URL. Все другие символы должны быть должным образом процентом, которого оставляют. Любые оставленные из процента символы интерпретируются с помощью кодирования UTF-8.

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

Objective C

@import Foundation;

Доступность

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


    
    init (строка:)
    - initWithString:

Инициализирует объект NSURL с предоставленной строкой URL.

Объявление

Swift

convenience init?(string URLString: String)

Objective C

- (instancetype)initWithString:(NSString *)URLString

Параметры


      URLString

URL представляет в виде строки, с которым можно инициализировать объект NSURL. Эта строка URL должна соответствовать Формату ссылки, как описано в RFC 2396 и не должна быть nil. Этот метод синтаксические анализы URLString согласно 1738 и 1808 RFCs.

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

Объект NSURL, инициализированный с URLString. Если строка URL была уродлива, возвраты nil.

Обсуждение

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

URLWithString:


    
    URLWithString:relativeToURL:
    + URLWithString:relativeToURL:

Создает и возвращает объект NSURL, инициализированный с базовым URL и относительной строкой.

Объявление

Objective C

+ (instancetype)URLWithString:(NSString *)URLString relativeToURL:(NSURL *)baseURL

Параметры

`URLString`	URL представляет в виде строки, с которым можно инициализировать объект NSURL. Может не быть `nil`. Должен соответствовать RFC 2396. `URLString` интерпретируется относительно `baseURL`.
`baseURL`	Базовый URL для объекта NSURL.

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

Объект NSURL, инициализированный с URLString и baseURL. Если URLString было уродливо или nil, возвраты nil.

Обсуждение

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

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

Objective C

@import Foundation;

Доступность

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


    
    init (string:relativeToURL:)
    - initWithString:relativeToURL:

Определяемый инициализатор

Инициализирует объект NSURL с базовым URL и относительной строкой.

Объявление

Swift

init?(string URLString: String, relativeToURL baseURL: NSURL?)

Objective C

- (instancetype)initWithString:(NSString *)URLString relativeToURL:(NSURL *)baseURL

Параметры

`URLString`	URL представляет в виде строки, с которым можно инициализировать объект NSURL. Должен соответствовать RFC 2396. `URLString` интерпретируется относительно `baseURL`.
`baseURL`	Базовый URL для объекта NSURL.

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

Объект NSURL, инициализированный с URLString и baseURL. Если URLString было уродливо, возвраты nil.

Обсуждение

initWithString:relativeToURL: определяемый инициализатор для NSURL.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– baseURL
– relativeString
URLWithString:relativeToURL:


    
    fileURLWithPath (_: isDirectory:)
    + fileURLWithPath:isDirectory:

Инициализирует и возвращает недавно создаваемый объект NSURL как файл URL с указанным путем.

Объявление

Swift

class func fileURLWithPath(_ path: String, isDirectory isDir: Bool) -> NSURL?

Objective C

+ (NSURL *)fileURLWithPath:(NSString *)path isDirectory:(BOOL)isDir

Параметры


      path

Путь, который будет представлять объект NSURL. path должен быть допустимый системный путь. Если path начинается с тильды, она должна сначала быть расширена с stringByExpandingTildeInPath. Если path относительный путь, он обрабатывается как являющийся относительно текущего рабочего каталога.

Передача nil поскольку этот параметр производит исключение.


      isDir

Булево значение, указывающее ли path обрабатывается как путь к каталогу при разрешении против компонентов относительного пути. Передача YEStrue если path указывает каталог, NOfalse иначе.

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

Объект NSURL, инициализированный с path.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

initFileURLWithPath:


    
    init (fileURLWithPath:isDirectory:)
    - initFileURLWithPath:isDirectory:

Определяемый инициализатор

Инициализирует недавно создаваемый NSURL ссылка на локальный файл или каталог в path.

Объявление

Swift

init?(fileURLWithPath path: String, isDirectory isDir: Bool)

Objective C

- (instancetype)initFileURLWithPath:(NSString *)path isDirectory:(BOOL)isDir

Параметры


      path

Передача nil поскольку этот параметр производит исключение.


      isDir

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

Объект NSURL, инициализированный с path.

Обсуждение

Вызов этого метода эквивалентен вызову initWithScheme:host:path: со схемой NSURLFileScheme, a nil узел, и path.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

fileURLWithPath:


    
    fileURLWithPath (_:)
    + fileURLWithPath:

Инициализирует и возвращает недавно создаваемый объект NSURL как файл URL с указанным путем.

Объявление

Swift

class func fileURLWithPath(_ path: String) -> NSURL?

Objective C

+ (NSURL *)fileURLWithPath:(NSString *)path

Параметры


      path

Передача nil поскольку этот параметр производит исключение.

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

Объект NSURL, инициализированный с path.

Обсуждение

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

Как альтернатива, рассмотреть использование fileURLWithPath:isDirectory:, который позволяет Вам явно указывать ли возвращенный NSURL объект представляет файл или каталог.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

initFileURLWithPath:


    
    init (fileURLWithPath:)
    - initFileURLWithPath:

Определяемый инициализатор

Инициализирует недавно создаваемый NSURL ссылка на локальный файл или каталог в path.

Объявление

Swift

init?(fileURLWithPath path: String)

Objective C

- (instancetype)initFileURLWithPath:(NSString *)path

Параметры


      path

Передача nil поскольку этот параметр производит исключение.

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

Объект NSURL, инициализированный с path.

Обсуждение

Вызов этого метода эквивалентен вызову initWithScheme:host:path: со схемой NSURLFileScheme, a nil узел, и path.

Как альтернатива, рассмотреть использование initFileURLWithPath:isDirectory:, который позволяет Вам явно указывать ли возвращенный NSURL объект представляет файл или каталог.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

fileURLWithPath:


    
    fileURLWithPathComponents (_:)
    + fileURLWithPathComponents:

Инициализирует и возвращает недавно создаваемый объект NSURL как файл URL с указанными компонентами контура.

Объявление

Swift

class func fileURLWithPathComponents(_ components: [AnyObject]) -> NSURL?

Objective C

+ (NSURL *)fileURLWithPathComponents:(NSArray *)components

Параметры


      components

Массив компонентов контура.

Передача nil поскольку этот параметр производит исключение.

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

Объект NSURL, инициализированный с components.

Обсуждение

Компоненты контура разделяются наклонной чертой вправо в возвращенном URL.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    init (byResolvingAliasFileAtURL:options:error:)
    + URLByResolvingAliasFileAtURL:options:error:

Возвращает новый URL, сделанный путем разрешения файла псевдонима в url.

Объявление

Swift

convenience init?(byResolvingAliasFileAtURL url: NSURL, options options: NSURLBookmarkResolutionOptions, error error: NSErrorPointer)

Objective C

+ (instancetype)URLByResolvingAliasFileAtURL:(NSURL *)url options:(NSURLBookmarkResolutionOptions)options error:(NSError **)error

Параметры

`url`	URL, указывающий на файл псевдонима.
`options`	Опции, принятые во внимание при разрешении данных закладки. `NSURLBookmarkResolutionWithSecurityScope` опция не поддерживается этим методом.
`error`	Ошибка, произошедшая при попытке разрешить предоставленный URL.

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

Новый URL, создаваемый путем разрешения данных закладки, произошел из предоставленного файла псевдонима. Если ошибка происходит, этот метод возвраты nil.

Обсуждение

Создает и инициализирует новый URL на основе файла псевдонима в url. Используйте этот метод для разрешения данных закладки, сохраненных с помощью writeBookmarkData:toURL:options:error: и решения те данные за один шаг.

Если url параметр не относится к файлу псевдонима, как определено NSURLIsAliasFileKey свойство, этот метод возвращается url параметр.

Если url параметр недостижим, этот метод возвраты nil и дополнительный ошибочный параметр заполняется.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    URLByResolvingBookmarkData:options:relativeToURL:bookmarkDataIsStale:error:
    + URLByResolvingBookmarkData:options:relativeToURL:bookmarkDataIsStale:error:

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

Объявление

Objective C

+ (instancetype)URLByResolvingBookmarkData:(NSData *)bookmarkData options:(NSURLBookmarkResolutionOptions)options relativeToURL:(NSURL *)relativeURL bookmarkDataIsStale:(BOOL *)isStale error:(NSError **)error

Параметры

`bookmarkData`	Данные закладки URL получены из.
`options`	Опции, принятые во внимание при разрешении данных закладки. Для разрешения ограниченной по объему безопасностью закладки для поддержки Тестовой среды приложения необходимо включать (посредством поразрядно `OR` операторы с любыми другими опциями в этом параметре) `NSURLBookmarkResolutionWithSecurityScope` опция.
`relativeURL`	Базовый URL, относительно которого данные закладки. При разрешении ограниченной по объему безопасностью закладки для получения ограниченного по объему безопасностью URL, используйте этот параметр следующим образом: Для разрешения ограниченной по объему приложением закладки используйте значение `nil`. Для разрешения ограниченной по объему документом закладки используйте абсолютный путь (несмотря на имя этого параметра) к документу, из которого Вы получили закладку.
`isStale`	По возврату, если `YEStrue`, данные закладки являются устаревшими. Ваше приложение должно создать новую закладку с помощью возвращенного URL и использовать ее вместо любых сохраненных копий существующей закладки.
`error`	Ошибка, произошедшая в случае, что не может быть создан URL.

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

Новый URL сделан путем разрешения bookmarkData.

Обсуждение

Эти сбои метода, если исходный файл или каталог не мог бы быть расположен или находится на объеме, который не мог бы быть смонтирован. Если этот метод перестал работать, можно использовать resourceValuesForKeys:fromBookmarkData: метод для получения информации о закладке, такой как последний известный путь (NSURLPathKey) помочь пользователю решить, как продолжить.

Для получения ограниченного по объему безопасностью URL из ограниченной по объему безопасностью закладки вызовите этот метод с помощью NSURLBookmarkResolutionWithSecurityScope опция. Кроме того, для использования объема безопасности Вы, должно быть, сначала включили надлежащие права для своего приложения, как описано во Включении Ограниченной по объему безопасностью Закладки и Доступа через URL.

Тогда получить доступ к ресурсу файловой системы, на который указывает ограниченный по объему безопасностью URL (другими словами, принести ресурс в песочницу Вашего приложения), вызов startAccessingSecurityScopedResource метод (или его Базовая эквивалентная Основа, CFURLStartAccessingSecurityScopedResource функция) на URL.

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

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

Objective C

@import Foundation;

Доступность

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

См. также

– bookmarkDataWithOptions:includingResourceValuesForKeys:relativeToURL:error:


    
    init (byResolvingBookmarkData:options:relativeToURL:bookmarkDataIsStale:error:)
    - initByResolvingBookmarkData:options:relativeToURL:bookmarkDataIsStale:error:

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

Объявление

Swift

convenience init?(byResolvingBookmarkData bookmarkData: NSData, options options: NSURLBookmarkResolutionOptions, relativeToURL relativeURL: NSURL?, bookmarkDataIsStale isStale: UnsafeMutablePointer<ObjCBool>, error error: NSErrorPointer)

Objective C

- (instancetype)initByResolvingBookmarkData:(NSData *)bookmarkData options:(NSURLBookmarkResolutionOptions)options relativeToURL:(NSURL *)relativeURL bookmarkDataIsStale:(BOOL *)isStale error:(NSError **)error

Параметры

`bookmarkData`	Данные закладки URL получены из.
`options`	Опции, принятые во внимание при разрешении данных закладки.
`relativeURL`	Базовый URL, относительно которого данные закладки.
`isStale`	Если `YEStrue`, данные закладки являются устаревшими.
`error`	Ошибка, произошедшая в случае, что не может быть создан URL.

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

NSURL инициализируется путем разрешения bookmarkData.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    fileURLWithFileSystemRepresentation (_: isDirectory:relativeToURL:)
    + fileURLWithFileSystemRepresentation:isDirectory:relativeToURL:

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

Объявление

Swift

class func fileURLWithFileSystemRepresentation(_ path: UnsafePointer<Int8>, isDirectory isDir: Bool, relativeToURL baseURL: NSURL?) -> NSURL?

Objective C

+ (NSURL *)fileURLWithFileSystemRepresentation:(const char *)path isDirectory:(BOOL)isDir relativeToURL:(NSURL *)baseURL

Параметры

`path`	Завершенная нулем струна до в представлении файловой системы, содержащем путь для представления как URL. Если этот путь является относительным путем, он обрабатывается как являющийся относительно текущего рабочего каталога.
`isDir`	`YEStrue` если последняя часть пути является каталогом, иначе `NOfalse`.
`baseURL`	Базовый URL для нового объекта URL. Это должно быть файлом URL. Если `path` является абсолютным, этот URL проигнорирован.

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

Возвращает новый объект или nil если произошла ошибка.

Обсуждение

Формат представления файловой системы описан в Кодировках Файла и Шрифтах.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    getFileSystemRepresentation (_: maxLength:)
    - getFileSystemRepresentation:maxLength:

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

Объявление

Swift

func getFileSystemRepresentation(_ buffer: UnsafeMutablePointer<Int8>, maxLength maxBufferLength: Int) -> Bool

Objective C

- (BOOL)getFileSystemRepresentation:(char *)buffer maxLength:(NSUInteger)maxBufferLength

Параметры

`buffer`	Буфер, достаточно большой для содержания пути. По возврату, содержит завершенную нулем струну до в представлении файловой системы.
`maxBufferLength`	Размер `buffer` в байтах (обычно `MAXPATHLEN` или `PATH_MAX`).

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

Возвраты YEStrue если URL мог бы быть преобразован в представление файловой системы, иначе NOfalse.

Обсуждение

Формат представления файловой системы описан в Кодировках Файла и Шрифтах.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    init (fileURLWithFileSystemRepresentation:isDirectory:relativeToURL:)
    - initFileURLWithFileSystemRepresentation:isDirectory:relativeToURL:

Определяемый инициализатор

Инициализирует объект URL со струной до, представляющей путь локальной файловой системы.

Объявление

Swift

init?(fileURLWithFileSystemRepresentation path: UnsafePointer<Int8>, isDirectory isDir: Bool, relativeToURL baseURL: NSURL?)

Objective C

- (instancetype)initFileURLWithFileSystemRepresentation:(const char *)path isDirectory:(BOOL)isDir relativeToURL:(NSURL *)baseURL

Параметры

`path`	Завершенная нулем струна до в представлении файловой системы, содержащем путь для представления как URL. Если этот путь является относительным путем, он обрабатывается как являющийся относительно текущего рабочего каталога.
`isDir`	`YEStrue` если последняя часть пути является каталогом, иначе `NOfalse`.
`baseURL`	Базовый URL для нового объекта URL. Это должно быть файлом URL. Если `path` является абсолютным, этот URL проигнорирован.

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

Возвращает инициализированный объект или nil если произошла ошибка.

Обсуждение

Формат представления файловой системы описан в Кодировках Файла и Шрифтах.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Идентификация и сравнение объектов

isEqual: - isEqual:

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

Объявление

Objective C

- (BOOL)isEqual:(id)anObject

Параметры

anObject

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

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

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

Обсуждение

Этот метод определяет то, что это означает для экземпляров быть равным. Два NSURLs считают равными, если и только если они возвращают идентичные значения для обоих baseURL и relativeString.

Запросы NSURL

checkResourceIsReachableAndReturnError (_:) - checkResourceIsReachableAndReturnError:

Возвраты, может ли быть достигнут ресурс, на который указывает файл URL.

Объявление

Swift

func checkResourceIsReachableAndReturnError(_ error: NSErrorPointer) -> Bool

Objective C

- (BOOL)checkResourceIsReachableAndReturnError:(NSError **)error

Параметры

error

Ошибка, произошедшая, когда не мог быть достигнут ресурс.

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

YEStrue если ресурс достижим; иначе, NOfalse.

Обсуждение

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

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

Если возвращается этот метод NOfalse, объектный указатель, на который ссылаются error заполняется с дополнительной информацией.

Примечание:

Этот метод в настоящее время применим только к URLs для ресурсов файловой системы. Для других типов URL всегда возвращается этот метод NOfalse.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Возвраты, является ли URL ссылкой на файл URL.

Объявление

Swift

func isFileReferenceURL() -> Bool

Objective C

- (BOOL)isFileReferenceURL

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

YEStrue если URL является ссылкой на файл URL; иначе, NOfalse.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Булево значение, определяющее, является ли получатель файлом URL. (только для чтения)

Объявление

Swift

var fileURL: Bool { get }

Objective C

@property(readonly, getter=isFileURL) BOOL fileURL

Обсуждение

Значение свойства YEStrue если получатель использует схему файла, NOfalse иначе. И путь к файлу и ссылка на файл URLs считаются файлом URLs.

Если значение этого свойства YEStrue, тогда получатель path свойство содержит подходящее значение для ввода в NSFileManager или NSPathUtilities.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Загрузка ресурса объекта NSURL


    
    URLHandleUsingCache:
    - URLHandleUsingCache:

(OS X v10.4)

Возвращает дескриптор URL для обслуживания получателя.

Объявление

Objective C

- (NSURLHandle *)URLHandleUsingCache:(BOOL)shouldUseCache

Параметры


      shouldUseCache

Использовать ли кэшируемый дескриптор URL. Если shouldUseCache YEStrue, кэш ищется дескриптор URL, обслуживший получатель или другой идентичный URL. Если shouldUseCache NOfalse, даже если эквивалентный URL был загружен, возвращается недавно инстанцированный дескриптор.

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

URL обрабатывает для обслуживания получателя.

Обсуждение

Сложные клиенты используют дескриптор URL непосредственно для дополнительного управления.

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

Используйте NSURLSession или NSURLConnection классы для загрузки содержания от удаленного URLs.

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

Objective C

@import Foundation;

Доступность

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

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

См. также

cachedHandleForURL: (NSURLHandle)


    
    loadResourceDataNotifyingClient:usingCache:
    - loadResourceDataNotifyingClient:usingCache:

(OS X v10.4)

Загружает данные ресурсов получателя в фоновом режиме.

Объявление

Objective C

- (void)loadResourceDataNotifyingClient:(id)client usingCache:(BOOL)shouldUseCache

Параметры


      client

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


      shouldUseCache

Должен ли URL использовать кэшируемые данные ресурсов от уже загруженного URL, относящегося к тому же ресурсу. Если YES, с кэшем консультируются при загрузке данных. Если NO, данные всегда загружаются непосредственно, не консультируясь с кэшем.

Обсуждение

Данный объект NSURL может выполнить только одну фоновую загрузку за один раз.

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

Используйте NSURLSession или NSURLConnection классы для загрузки содержания от удаленного URLs.

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

Objective C

@import Foundation;

Доступность

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

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


    
    resourceDataUsingCache:
    - resourceDataUsingCache:

(OS X v10.4)

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

Объявление

Objective C

- (NSData *)resourceDataUsingCache:(BOOL)shouldUseCache

Параметры


      shouldUseCache

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

Данные ресурсов получателя.

Обсуждение

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

В OS X v10.4, этот метод запрашивает, чтобы данные были отправлены с gzip сжатием, однако это автоматически не распаковывает данные, если сервер соответствует этому запросу. Данные автоматически распаковываются в OS X v10.5 и позже.

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

Используйте NSURLSession или NSURLConnection классы для загрузки содержания от удаленного URLs.

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

Objective C

@import Foundation;

Доступность

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

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

setResourceData: - setResourceData: (OS X v10.4)

Попытки установить данные ресурсов для получателя.

Объявление

Objective C

- (BOOL)setResourceData:(NSData *)data

Параметры

data

Данные для установки для URL.

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

Возвраты YEStrue в случае успеха, NOfalse иначе.

Обсуждение

В случае файла URL, устанавливая данные включает запись data к указанному файлу.

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

Objective C

@import Foundation;

Доступность

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

Возвращает указанное свойство ресурса получателя.

Объявление

Objective C

- (id)propertyForKey:(NSString *)propertyKey

Параметры

propertyKey

Ключ желаемого свойства.

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

Значение свойства ресурса получателя для предоставленного ключа. Возвраты nil если нет такого ключа.

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

Objective C

@import Foundation;

Доступность

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

См. также

setProperty:forKey:


    
    setProperty:forKey:
    - setProperty:forKey:

(OS X v10.4)

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

Объявление

Objective C

- (BOOL)setProperty:(id)propertyValue forKey:(NSString *)propertyKey

Параметры

`propertyValue`	Новое значение свойства ресурса получателя.
`propertyKey`	Ключ желаемого свойства.

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

Возвраты YEStrue если модификация была успешна, NOfalse иначе.

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

Objective C

@import Foundation;

Доступность

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

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

Доступ к частям URL

absoluteString absoluteString Свойство

URL представляет в виде строки для получателя как абсолютный URL. (только для чтения)

Объявление

Swift

var absoluteString: String? { get }

Objective C

@property(readonly, copy) NSString *absoluteString

Обсуждение

Значение этого свойства вычисляется путем разрешения строки получателя против ее основы согласно алгоритму, данному в RFC 1808.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Абсолютный URL, именующий тот же ресурс как получатель. (только для чтения)

Объявление

Swift

@NSCopying var absoluteURL: NSURL? { get }

Objective C

@property(readonly, copy) NSURL *absoluteURL

Обсуждение

Если URL является уже абсолютным, это свойство содержит копию получателя. Разрешение выполняется на RFC 1808.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Базовый URL. (только для чтения)

Объявление

Swift

@NSCopying var baseURL: NSURL? { get }

Objective C

@property(readonly, copy) NSURL *baseURL

Обсуждение

Это свойство содержит базовый URL. Если получателем является абсолютный URL, это свойство содержит nil.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Струна до, содержащая путь файловой системы URL’s. (только для чтения)

Объявление

Swift

var fileSystemRepresentation: UnsafePointer<Int8> { get }

Objective C

@property(readonly) const char *fileSystemRepresentation

Обсуждение

Это возвращает завершенную нулем струну до в представлении файловой системы.

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

Формат представления файловой системы описан в Кодировках Файла и Шрифтах.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.9 и позже.
фрагмент фрагмент Свойство

Идентификатор фрагмента, приспосабливая RFC 1808. (только для чтения)

Объявление

Swift

var fragment: String? { get }

Objective C

@property(readonly, copy) NSString *fragment

Обсуждение

Это свойство содержит фрагмент URL’s. Если получатель не приспосабливает RFC 1808, это свойство содержит nil. Например, в URL http://www.example.com/index.html#jumpLocation, идентификатор фрагмента jumpLocation.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Узел, приспосабливая RFC 1808. (только для чтения)

Объявление

Swift

var host: String? { get }

Objective C

@property(readonly, copy) NSString *host

Обсуждение

Это свойство содержит узел. Например, в URL http://www.example.com/index.html, узел www.example.com.

Если получатель не приспосабливает RFC 1808, это свойство содержит nil. Лакмусовый тест для соответствия к RFC 1808 как рекомендуется в RFC 1808 — в частности, ли первые два символа resourceSpecifier наклонные черты (//).

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Последний компонент контура. (только для чтения)

Объявление

Swift

var lastPathComponent: String { get }

Objective C

@property(readonly, copy) NSString *lastPathComponent

Обсуждение

Это свойство содержит последний компонент контура. Например, в URL file:///path/to/file, последний компонент контура file.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Строка параметров, соответствующая RFC 1808. (только для чтения)

Объявление

Swift

var parameterString: String? { get }

Objective C

@property(readonly, copy) NSString *parameterString

Обсуждение

Это свойство содержит строку параметров. Если получатель не приспосабливает RFC 1808, это свойство содержит nil. Например, в URL file:///path/to/file;foo, строка параметров foo.

Это свойство не должно быть перепутано с query свойство, также часто содержащее строку параметров.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.0 и позже.
пароль пароль Свойство

Пароль, соответствующий RFC 1808. (только для чтения)

Объявление

Swift

var password: String? { get }

Objective C

@property(readonly, copy) NSString *password

Обсуждение

Это свойство содержит пароль. Если получатель не приспосабливает RFC 1808, он содержит nil. Например, в URL http://username:password@www.example.com/index.html, пароль password.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Путь, приспосабливая RFC 1808. (только для чтения)

Объявление

Swift

var path: String? { get }

Objective C

@property(readonly, copy) NSString *path

Обсуждение

Это свойство содержит путь, незавершенный с stringByReplacingPercentEscapesUsingEncoding: метод. Если получатель не приспосабливает RFC 1808, это свойство содержит nil.

Если получатель содержит ссылку на файл или ссылку на файл URL (как определено с isFileURL), значение этого свойства подходит для ввода в методы NSFileManager или NSPathUtilities. Если путь имеет запаздывающую наклонную черту, он разделяется.

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

Если parameterString свойство содержит не -nil значение, путь может быть неполным. Если получатель содержит незакодированную точку с запятой, концы свойства пути в символе перед точкой с запятой. Остаток от URL предоставлен в parameterString свойство.

Получить полный путь, если parameterString содержит не -nil оцените, добавьте точку с запятой, сопровождаемую строкой параметров.

На RFC 3986 ведущая наклонная черта после полномочий (имя хоста и порт) часть обрабатывается как часть пути. Например, в URL http://www.example.com/index.html, путь /index.html.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

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

Объявление

Swift

var pathComponents: [AnyObject] { get }

Objective C

@property(readonly, copy) NSArray *pathComponents

Обсуждение

Это свойство содержит массив, содержащий компоненты отдельного тракта URL. Например, в URL file:///directory/directory2/file, массив компонентов контура был бы @[@"/", @"directory", @"directory2", @"file"].

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Расширение пути. (только для чтения)

Объявление

Swift

var pathExtension: String { get }

Objective C

@property(readonly, copy) NSString *pathExtension

Обсуждение

Это свойство содержит расширение пути. Например, в URL file:///path/to/file.txt, расширение пути txt.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Порт, приспосабливая RFC 1808. (только для чтения)

Объявление

Swift

@NSCopying var port: NSNumber? { get }

Objective C

@property(readonly, copy) NSNumber *port

Обсуждение

Это свойство содержит номер порта. Например, в URL http://www.example.com:8080/index.php, номер порта 8080.

Если получатель не приспосабливает RFC 1808, это свойство содержит nil. Лакмусовый тест для соответствия к RFC 1808 как рекомендуется в RFC 1808 — в частности, ли первые два символа resourceSpecifier наклонные черты (//).

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Строка запроса, приспосабливая RFC 1808. (только для чтения)

Объявление

Swift

var query: String? { get }

Objective C

@property(readonly, copy) NSString *query

Обсуждение

Это свойство содержит строку запроса. Если получатель не приспосабливает RFC 1808, это свойство содержит nil. Например, в URL http://www.example.com/index.php?key1=value1&key2=value2, строка запроса key1=value1&key2=value2.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Относительный путь, приспосабливая RFC 1808. (только для чтения)

Объявление

Swift

var relativePath: String? { get }

Objective C

@property(readonly, copy) NSString *relativePath

Обсуждение

Это свойство содержит относительный путь URL получателя, не решая против его базового URL. Если путь имеет запаздывающую наклонную черту, он разделяется. Если получателем является абсолютный URL, это свойство содержит то же значение как path. Если получатель не приспосабливает RFC 1808, он содержит nil.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Строковое представление относительной части URL. (только для чтения)

Объявление

Swift

var relativeString: String? { get }

Objective C

@property(readonly, copy) NSString *relativeString

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Спецификатор ресурса. (только для чтения)

Объявление

Swift

var resourceSpecifier: String? { get }

Objective C

@property(readonly, copy) NSString *resourceSpecifier

Обсуждение

Это свойство содержит спецификатор ресурса. Например, в URL http://www.example.com/index.html?key1=value1#jumplink, спецификатор ресурса //www.example.com/index.html?key1=value1#jumplink (все после двоеточия).

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Схема. (только для чтения)

Объявление

Swift

var scheme: String? { get }

Objective C

@property(readonly, copy) NSString *scheme

Обсуждение

Это свойство содержит схему. Например, в URL http://www.example.com/index.html, схема http.

Полный URL является связью схемы, двоеточие (:), и значение resourceSpecifier.

Примечание:

Термин «протокол» также иногда используется при разговоре об основанных на сети схемах URL. Однако не все схемы URL являются сетевыми протоколами —data:// URLs, например.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Копия URL с любыми экземплярами ".." или "." удаленный из его пути. (только для чтения)

Объявление

Swift

@NSCopying var standardizedURL: NSURL? { get }

Objective C

@property(readonly, copy) NSURL *standardizedURL

Обсуждение

Это свойство содержит новое NSURL объект, инициализированное использование пути получателя с любыми экземплярами ".." или "." удаленный.

Если URL приспосабливает RFC 1808 (наиболее распространенная форма URL), это свойство содержит указанный компонент URL; иначе это содержит nil. Лакмусовый тест для соответствия к RFC 1808 как рекомендуется в RFC 1808 — в частности, ли первые два символа resourceSpecifier наклонные черты (//).

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Имя пользователя, приспосабливая RFC 1808. (только для чтения)

Объявление

Swift

var user: String? { get }

Objective C

@property(readonly, copy) NSString *user

Обсуждение

Это свойство содержит имя пользователя. Например, в URL ftp://username@www.example.com/, имя пользователя является именем пользователя.

Если URL получателя не приспосабливает RFC 1808, это свойство возвраты nil. Лакмусовый тест для соответствия к RFC 1808 как рекомендуется в RFC 1808 — в частности, ли первые два символа resourceSpecifier наклонные черты (//).

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Изменение и преобразование файла URL

filePathURL filePathURL Свойство

URL пути к файлу, указывающий на тот же ресурс как объект URL. (только для чтения)

Объявление

Swift

@NSCopying var filePathURL: NSURL? { get }

Objective C

@property(readonly, copy) NSURL *filePathURL

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Возвращает новую ссылку на файл URL, указывающий на тот же ресурс как получатель.

Объявление

Swift

func fileReferenceURL() -> NSURL?

Objective C

- (NSURL *)fileReferenceURL

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

Новая ссылка на файл URL.

Обсуждение

URLs ссылки на файл использует синтаксис пути URL, идентифицирующий объект файловой системы ссылкой, не путем. Эта форма файла, URL остается допустимым, когда изменяется путь файловой системы URL’s, лежащего в основе ресурса.

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

URLs ссылки на файл не может быть создана к объектам файловой системы, которые не существуют или не достижимы. Это свойство содержит nil вместо этого.

В некоторых областях иерархии файловой системы ссылка на файл URLs не может быть сгенерирован к вершине пути URL.

Важный

Ссылка на файл путь URL's никогда не должен быть постоянно сохранен, потому что это не допустимо через систему, перезапускает или повторно монтируется объемов. Если необходимо сохранить персистентную ссылку на объект файловой системы, используйте закладку вместо этого. Можно создать закладку путем вызова bookmarkDataWithOptions:includingResourceValuesForKeys:relativeToURL:error:.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    URLByAppendingPathComponent (_:)
    - URLByAppendingPathComponent:

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

Объявление

Swift

func URLByAppendingPathComponent(_ pathComponent: String) -> NSURL

Objective C

- (NSURL *)URLByAppendingPathComponent:(NSString *)pathComponent

Параметры


      pathComponent

Компонент контура для добавления к URL, в его исходной форме (не закодированный URL).

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

Новый URL с pathComponent добавленный.

Обсуждение

Если исходный URL не заканчивается наклонной чертой вправо и pathComponent не начинается с наклонной черты вправо, наклонная черта вправо вставляется между двумя частями возвращенного URL, если исходный URL не является пустой строкой.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    URLByAppendingPathComponent (_: isDirectory:)
    - URLByAppendingPathComponent:isDirectory:

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

Объявление

Swift

func URLByAppendingPathComponent(_ pathComponent: String, isDirectory isDirectory: Bool) -> NSURL

Objective C

- (NSURL *)URLByAppendingPathComponent:(NSString *)pathComponent isDirectory:(BOOL)isDirectory

Параметры

`pathComponent`	Компонент контура для добавления к URL.
`isDirectory`	Если `YEStrue`, запаздывающая наклонная черта добавляется после `pathComponent`.

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

Новый URL с pathComponent добавленный.

Обсуждение

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

URLByAppendingPathExtension (_:) - URLByAppendingPathExtension:

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

Объявление

Swift

func URLByAppendingPathExtension(_ pathExtension: String) -> NSURL

Objective C

- (NSURL *)URLByAppendingPathExtension:(NSString *)pathExtension

Параметры

pathExtension

Расширение пути для добавления к URL.

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

Новый URL с pathExtension добавленный.

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

URL, создаваемый путем взятия получателя и удаления последнего компонента контура. (только для чтения)

Объявление

Swift

@NSCopying var URLByDeletingLastPathComponent: NSURL? { get }

Objective C

@property(readonly, copy) NSURL *URLByDeletingLastPathComponent

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

URL, создаваемый путем взятия получателя и удаления расширения пути, если таковые имеются. (только для чтения)

Объявление

Swift

@NSCopying var URLByDeletingPathExtension: NSURL? { get }

Objective C

@property(readonly, copy) NSURL *URLByDeletingPathExtension

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

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

Объявление

Swift

@NSCopying var URLByResolvingSymlinksInPath: NSURL? { get }

Objective C

@property(readonly, copy) NSURL *URLByResolvingSymlinksInPath

Обсуждение

Если получатель не имеет никаких символьных ссылок, это свойство содержит копию исходного URL.

Если некоторые символьные ссылки не могут быть разрешены, это свойство содержит те поврежденные символьные ссылки.

Если имя пути получения начинается /private, это свойство снимает изоляцию /private указатель, если результатом является имя существующего файла.

Это свойство только работает над URLs с file: схема пути. Для всего другого URLs это содержит копию получателя.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.6 и позже.
URLByStandardizingPath URLByStandardizingPath Свойство
URL, указывающий на тот же ресурс как исходный URL с помощью абсолютного пути. (только для чтения)

Объявление

Swift

@NSCopying var URLByStandardizingPath: NSURL? { get }

Objective C

@property(readonly, copy) NSURL *URLByStandardizingPath
Обсуждение

Это свойство только работает над URLs с file: схема пути. Для всего другого URLs это возвращает копию исходного URL.

Как stringByStandardizingPath, это свойство может внести следующие изменения в предоставленном URL:
- Разверните начальное использование выражения тильды stringByExpandingTildeInPath.
- Сократите пустые компоненты и ссылки на текущий каталог (т.е. последовательности «//» и “/. /”) к единственным разделителям пути.
- В абсолютных путях только, разрешите ссылки на родительский каталог (т.е. компонент «..») к реальному родительскому каталогу, если возможное использование stringByResolvingSymlinksInPath, который консультируется с файловой системой для разрешения каждой потенциальной символьной ссылки.
  
  В относительных путях, потому что символьные ссылки не могут быть разрешены, ссылки на родительский каталог оставляют на месте.
- Удалите начальный компонент “/ частный” от пути, если результат все еще указывает существующий файл или каталог (проверенный консалтинг файловая система).
Обратите внимание на то, что путь, содержавший этим свойством, может все еще иметь компоненты символьной ссылки в нем. Отметьте также, что это свойство только работает с путями к файлам (не, например, строковые представления URLs).
Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Работа с данными закладки


    
    bookmarkDataWithContentsOfURL (_: ошибка:)
    + bookmarkDataWithContentsOfURL:error:

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

Объявление

Swift

class func bookmarkDataWithContentsOfURL(_ bookmarkFileURL: NSURL, error error: NSErrorPointer) -> NSData?

Objective C

+ (NSData *)bookmarkDataWithContentsOfURL:(NSURL *)bookmarkFileURL error:(NSError **)error

Параметры

`bookmarkFileURL`	URL, указывающий на файл псевдонима.
`error`	Ошибка, произошедшая в случае, что не могут быть получены данные закладки.

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

Данные закладки для файла псевдонима.

Обсуждение

Если bookmarkFileURL точки к файлу псевдонима создали до OS X v10.6, который содержит менеджера по Псевдониму информация, но никакие данные закладки, этот метод синтезирует данные закладки для файла.

Этот метод возвраты nil если не могут быть созданы данные закладки.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    bookmarkDataWithOptions (_: includingResourceValuesForKeys:relativeToURL:error:)
    - bookmarkDataWithOptions:includingResourceValuesForKeys:relativeToURL:error:

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

Объявление

Swift

func bookmarkDataWithOptions(_ options: NSURLBookmarkCreationOptions, includingResourceValuesForKeys keys: [AnyObject]?, relativeToURL relativeURL: NSURL?, error error: NSErrorPointer) -> NSData?

Objective C

- (NSData *)bookmarkDataWithOptions:(NSURLBookmarkCreationOptions)options includingResourceValuesForKeys:(NSArray *)keys relativeToURL:(NSURL *)relativeURL error:(NSError **)error

Параметры

`options`	Опции, принятые во внимание при создании закладки для URL. Возможные флаги (который может быть объединен с поразрядно `OR` операции), описаны в Опциях Создания Данных Закладки. Для создания ограниченной по объему безопасностью закладки для поддержки Тестовой среды приложения включайте `NSURLBookmarkCreationWithSecurityScope` флаг. При позже разрешении закладки можно использовать получающийся ограниченный по объему безопасностью URL для получения доступа для чтения-записи к ресурсу файловой системы, на который указывает URL. Если Вы вместо этого хотите создать ограниченную по объему безопасностью закладку, когда разрешено, позволяющую Вам получить доступ только для чтения к ресурсу файловой системы, поразрядно `OR` значение этого параметра с обоими `NSURLBookmarkCreationWithSecurityScope` опция и `NSURLBookmarkCreationSecurityScopeAllowOnlyReadAccess` опция.
`keys`	Массив имен свойств ресурса URL для хранения как часть закладки. Можно позже получить доступ к этим значениям (не разрешая закладку) путем вызова `resourceValuesForKeys:fromBookmarkData:` метод. Значения этих свойств должны иметь тип, который может сериализировать код генерации закладки. В частности значения могут содержать любые из следующих типов примитивов: `NSString` или `CFString` `NSData` или `CFData` `NSDate` или `CFDate` `NSNumber` или `CFNumber` `CFBoolean` `NSURL` или `CFURL` `kCFNull` или `NSNull` `CFUUID` Кроме того, свойства могут содержать следующие классы набора: `NSArray` или `CFArray` содержа только вышеупомянутые типы примитивов `NSDictionary` или `CFDictionary` с `NSString` или `CFString` ключи, в которых все значения содержат только вышеупомянутые типы примитивов
`relativeURL`	URL, относительно которого будут данные закладки. При создании ограниченной по объему безопасностью закладки для поддержки Тестовой среды приложения, используйте этот параметр следующим образом: Для создания ограниченной по объему приложением закладки используйте значение `nil`. Для создания ограниченной по объему документом закладки используйте абсолютный путь (несмотря на имя этого параметра) к файлу документа, которому должна принадлежать новая ограниченная по объему безопасностью закладка.
`error`	Ошибка, произошедшая в случае, что не могут быть созданы данные закладки.

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

Закладка для URL.

Обсуждение

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

Можно также использовать этот метод для создания ограниченной по объему безопасностью закладки для поддержки Тестовой среды приложения. Прежде чем Вы сделаете так, необходимо сначала включить надлежащие права для приложения, как описано во Включении Ограниченной по объему безопасностью Закладки и Доступа через URL. Кроме того, обязательно поймите поведение options и relativeURL параметры.

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– startAccessingSecurityScopedResource
– stopAccessingSecurityScopedResource
+ URLByResolvingBookmarkData:options:relativeToURL:bookmarkDataIsStale:error:


    
    resourceValuesForKeys (_: fromBookmarkData:)
    + resourceValuesForKeys:fromBookmarkData:

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

Объявление

Swift

class func resourceValuesForKeys(_ keys: [AnyObject], fromBookmarkData bookmarkData: NSData) -> [NSObject : AnyObject]?

Objective C

+ (NSDictionary *)resourceValuesForKeys:(NSArray *)keys fromBookmarkData:(NSData *)bookmarkData

Параметры


      keys

Массив имен свойств ресурса URL. В дополнение к стандартным, определенным с помощью системы свойствам ресурса можно также запросить любые пользовательские свойства, которые Вы обеспечили при создании закладки. Посмотрите bookmarkDataWithOptions:includingResourceValuesForKeys:relativeToURL:error: метод для подробных данных.


      bookmarkData

Данные закладки, от которых Вы хотите получить значения ресурса.

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

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

“Ключи системного ресурса общего файла”
“Ключи свойства файла”
“Повсеместные ключи свойства элемента”
“Ключи свойства объема”


    
    writeBookmarkData (_: toURL:options:error:)
    + writeBookmarkData:toURL:options:error:

Создает файл псевдонима на диске в указанном расположении с указанными данными закладки.

Объявление

Swift

class func writeBookmarkData(_ bookmarkData: NSData, toURL bookmarkFileURL: NSURL, options options: NSURLBookmarkFileCreationOptions, error error: NSErrorPointer) -> Bool

Objective C

+ (BOOL)writeBookmarkData:(NSData *)bookmarkData toURL:(NSURL *)bookmarkFileURL options:(NSURLBookmarkFileCreationOptions)options error:(NSError **)error

Параметры

`bookmarkData`	Данные закладки, содержащие информацию для файла псевдонима.
`bookmarkFileURL`	Желаемое расположение файла псевдонима.
`options`	Опции, принятые во внимание при создании файла псевдонима.
`error`	Ошибка, произошедшая в случае, что не может быть создан файл псевдонима.

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

YEStrue если успешно создается файл псевдонима; иначе, NOfalse.

Обсуждение

Этот метод произведет ошибку если bookmarkData не создавался с NSURLBookmarkCreationSuitableForBookmarkFile опция.

Если bookmarkFileURL точки к каталогу, файл псевдонима будет создаваться в том каталоге с его именем, полученным из информации в bookmarkData. Если bookmarkFileURL точки к файлу, файл псевдонима будет создаваться с расположением и именем, обозначенным bookmarkFileURL, и его расширение будет изменено на .alias если это уже не.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

startAccessingSecurityScopedResource () - startAccessingSecurityScopedResource

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

Объявление

Swift

func startAccessingSecurityScopedResource() -> Bool

Objective C

- (BOOL)startAccessingSecurityScopedResource

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

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

Обсуждение

При получении ограниченного по объему безопасностью URL, такой как путем разрешения ограниченной по объему безопасностью закладки, Вы не можете сразу использовать ресурс, на который она указывает. Для предоставления доступа к ресурсу доступным для приложения, посредством добавления его расположения к песочнице приложения, вызывают этот метод (или его Базовая эквивалентная Основа, CFURLStartAccessingSecurityScopedResource функция) на ограниченном по объему безопасностью URL.

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

Предупреждение

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

Примечание версии

Ограниченные по объему безопасностью закладки не доступны в версиях OS X до OS X v10.7.3.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– stopAccessingSecurityScopedResource
+ URLByResolvingBookmarkData:options:relativeToURL:bookmarkDataIsStale:error:
stopAccessingSecurityScopedResource () - stopAccessingSecurityScopedResource

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

Объявление

Swift

func stopAccessingSecurityScopedResource()

Objective C

- (void)stopAccessingSecurityScopedResource

Обсуждение

Когда Вам больше не будет нужен доступ к файлу или каталогу, на который указывает ограниченный по объему безопасностью URL, такой, как один возвращенный путем разрешения ограниченной по объему безопасностью закладки, вызовите этот метод (или его Базовая эквивалентная Основа, CFURLStopAccessingSecurityScopedResource функция) на URL для отказа от доступа. При вызове этого метода Вы сразу теряете доступ к рассматриваемому ресурсу.

Предупреждение

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

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

Примечание версии

Ограниченные по объему безопасностью закладки не доступны в версиях OS X до OS X v10.7.3.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– startAccessingSecurityScopedResource

Получение и установка свойств ресурса файловой системы


    
    getResourceValue (_: forKey:error:)
    - getResourceValue:forKey:error:

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

Объявление

Swift

func getResourceValue(_ value: AutoreleasingUnsafeMutablePointer<AnyObject?>, forKey key: String, error error: NSErrorPointer) -> Bool

Objective C

- (BOOL)getResourceValue:(out id *)value forKey:(NSString *)key error:(out NSError **)error

Параметры

`value`	Расположение, где значение для свойства ресурса, идентифицированного `key` должен быть сохранен.
`key`	Имя одного из свойств ресурса URL’s.
`error`	Ошибка, произошедшая, если не могло бы быть получено значение ресурса. Этот параметр является дополнительным. Если Вы не интересуетесь получением информации об ошибке, можно передать `nil`.

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

YEStrue если value успешно заполняется; иначе, NOfalse.

Обсуждение

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

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

Если возвращается этот метод YEStrue и значение заполняется с nil, это означает, что свойство ресурса не доступно для указанного ресурса, и что никакие ошибки не произошли при решении, что свойство ресурса было недоступно.

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также


    
    resourceValuesForKeys (_: ошибка:)
    - resourceValuesForKeys:error:

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

Объявление

Swift

func resourceValuesForKeys(_ keys: [AnyObject], error error: NSErrorPointer) -> [NSObject : AnyObject]?

Objective C

- (NSDictionary *)resourceValuesForKeys:(NSArray *)keys error:(NSError **)error

Параметры

`keys`	Массив ключей свойства для желаемых свойств ресурса.
`error`	Ошибка, произошедшая, если не могли бы быть получены одно или более значений ресурса. Этот параметр является дополнительным. Если Вы не интересуетесь получением информации об ошибке, можно передать `nil`.

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

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

Обсуждение

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

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

Если ошибка происходит, этот метод возвраты nil и заполняет объектный указатель, на который ссылаются error с дополнительной информацией.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также


    
    setResourceValue (_: forKey:error:)
    - setResourceValue:forKey:error:

Устанавливает свойство ресурса URL’s для данного ключа к данному значению.

Объявление

Swift

func setResourceValue(_ value: AnyObject?, forKey key: String, error error: NSErrorPointer) -> Bool

Objective C

- (BOOL)setResourceValue:(id)value forKey:(NSString *)key error:(NSError **)error

Параметры

`value`	Значение для свойства ресурса, определенного `key`.
`key`	Имя одного из свойств ресурса URL’s.
`error`	Ошибка, произошедшая, если не могло бы быть установлено значение ресурса.

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

YEStrue если называют свойство ресурса key успешно установлен в value; иначе, NOfalse.

Обсуждение

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

Если ошибка происходит, этот метод возвраты NOfalse и заполняет объектный указатель, на который ссылаются error с дополнительной информацией.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также


    
    setResourceValues (_: ошибка:)
    - setResourceValues:error:

Устанавливает свойства ресурса URL’s для данного набора ключей к данному набору значений.

Объявление

Swift

func setResourceValues(_ keyedValues: [NSObject : AnyObject], error error: NSErrorPointer) -> Bool

Objective C

- (BOOL)setResourceValues:(NSDictionary *)keyedValues error:(NSError **)error

Параметры

`keyedValues`	Словарь ресурса оценивает, чтобы быть установленным.
`error`	Ошибка, произошедшая, если не могли бы быть установлены одно или более значений ресурса.

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

YEStrue если весь ресурс оценивает в keyedValues успешно установлены; иначе, NOfalse.

Обсуждение

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

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

Порядок, в котором установлены значения ресурса, не определяется. Если необходимо гарантировать порядок, в котором установлены значения ресурса, необходимо выполнить многократные запросы к этому методу или setResourceValue:forKey:error:.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

removeAllCachedResourceValues () - removeAllCachedResourceValues

Удаляет все кэшируемые значения ресурса и временные значения ресурса от объекта URL.

Объявление

Swift

func removeAllCachedResourceValues()

Objective C

- (void)removeAllCachedResourceValues

Обсуждение

Этот метод применим только к URLs, представляющему ресурсы файловой системы.

Примечание:

Кэширующееся поведение NSURL и CFURL APIs отличается. Для NSURL, все кэшируемые значения (не временные ценности) автоматически удалены после того, как каждый проходит через цикл выполнения. Только необходимо вызвать removeCachedResourceValueForKey: метод, когда Вы хотите очистить кэш в единственном выполнении цикла выполнения. CFURL функции, с другой стороны, автоматически не очищают кэшируемые значения ресурса. Клиент имеет полный контроль над временами жизни кэша, и необходимо использовать CFURLClearResourcePropertyCacheForKey или CFURLClearResourcePropertyCache очистить кэшируемые значения ресурса.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    removeCachedResourceValueForKey (_:)
    - removeCachedResourceValueForKey:

Удаляет кэшируемое значение ресурса, идентифицированное данным ключом от объекта URL.

Объявление

Swift

func removeCachedResourceValueForKey(_ key: String)

Objective C

- (void)removeCachedResourceValueForKey:(NSString *)key

Параметры

key

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

Обсуждение

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

Этот метод в настоящее время применим только к URLs для ресурсов файловой системы.

Примечание:

Кэширующееся поведение NSURL и CFURL APIs отличается. Для NSURL, все кэшируемые значения (не временные ценности) автоматически удалены после того, как каждый проходит через цикл выполнения. Только необходимо вызвать removeCachedResourceValueForKey: метод, когда Вы хотите очистить кэш в единственном выполнении цикла выполнения. CFURL функции, с другой стороны, автоматически не очищают кэшируемые значения ресурса. Клиент имеет полный контроль над временами жизни кэша, и необходимо использовать CFURLClearResourcePropertyCacheForKey или CFURLClearResourcePropertyCache очистить кэшируемые значения ресурса.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    setTemporaryResourceValue (_: forKey:)
    - setTemporaryResourceValue:forKey:

Устанавливает временное значение ресурса на объекте URL.

Объявление

Swift

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

Objective C

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

Параметры

`value`	Значение для хранения.
`key`	Ключ, где должно быть сохранено значение. Этот ключ должен быть уникальным и не должен конфликтовать ни с какими определенными с помощью системы ключами. Нотация обратного доменного имени рекомендуется.

Обсуждение

Ваше приложение может использовать временное значение ресурса для временного хранения значения для определенного с помощью приложения ключа значения ресурса в памяти, не изменяя фактический ресурс, который представляет URL. После того, как набор, можно скопировать временное значение ресурса с объекта URL, как Вы скопировали бы определенные с помощью системы ключи — путем вызова getResourceValue:forKey:error: или resourceValuesForKeys:error:.

Ваше приложение может удалить временное значение ресурса из объекта URL путем вызова removeCachedResourceValueForKey: или removeAllCachedResourceValues (для удаления всех временных ценностей).

Этот метод применим только к URLs для ресурсов файловой системы.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Работа с обещанными элементами

checkPromisedItemIsReachableAndReturnError (_:) - checkPromisedItemIsReachableAndReturnError:
Возвраты, может ли быть достигнут обещанный элемент.

Объявление

Swift

func checkPromisedItemIsReachableAndReturnError(_ error: NSErrorPointer) -> Bool

Objective C

- (BOOL)checkPromisedItemIsReachableAndReturnError:(NSError **)error

Параметры

error

Ошибка, произошедшая, когда не мог быть достигнут обещанный элемент.

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

YEStrue если обещанный элемент достижим; иначе, NOfalse.
Обсуждение

Этот метод ведет себя тождественно к checkResourceIsReachableAndReturnError:, но работы над обещанными элементами. Обещанный элемент, как гарантируют, не будет иметь свое содержание в файловой системе, пока Вы не будете использовать координатора файла для выполнения скоординированного чтения на его URL, заставляющем содержание быть загруженным или иначе сгенерированным. Обещанный элемент URLs возвращается различным APIs, включая:
- Запрос метаданных с помощью любого NSMetadataQueryUbiquitousDataScope или NSMetadataQueryUbiquitousDocumentsScope объемы
- Содержание каталога, возвращенного файловым менеджером URLForUbiquitousContainerIdentifier:
- URL в блоке средства доступа скоординированной операции чтения или операции записи, использовавшей NSFileCoordinatorReadingImmediatelyAvailableMetadataOnly, NSFileCoordinatorWritingForDeleting, NSFileCoordinatorWritingForMoving, или NSFileCoordinatorWritingContentIndependentMetadataOnly опции
Необходимо использовать этот метод вместо checkResourceIsReachableAndReturnError для любого URLs, возвращенного этими методами.
Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– checkResourceIsReachableAndReturnError:
– getPromisedItemResourceValue:forKey:error:
– promisedItemResourceValuesForKeys:error:


    
    getPromisedItemResourceValue (_: forKey:error:)
    - getPromisedItemResourceValue:forKey:error:

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

Объявление

Swift

func getPromisedItemResourceValue(_ value: AutoreleasingUnsafeMutablePointer<AnyObject?>, forKey key: String, error error: NSErrorPointer) -> Bool

Objective C

- (BOOL)getPromisedItemResourceValue:(id *)value forKey:(NSString *)key error:(NSError **)error

Параметры

`value`	Расположение, где значение для свойства ресурса, идентифицированного `key` должен быть сохранен.
`key`	Имя одного из свойств ресурса URL’s.
`error`	Ошибка, произошедшая в случае, что не может быть получено значение ресурса.

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

YEStrue если value успешно заполняется; иначе, NOfalse.

Обсуждение

Этот метод ведет себя тождественно к getResourceValue:forKey:error:, но работы над обещанными элементами. Обещанный элемент, как гарантируют, не будет иметь свое содержание в файловой системе, пока Вы не будете использовать координатора файла для выполнения скоординированного чтения на его URL, заставляющем содержание быть загруженным или иначе сгенерированным. Обещанный элемент URLs возвращается различным APIs, включая:

Запрос метаданных с помощью любого NSMetadataQueryUbiquitousDataScope или NSMetadataQueryUbiquitousDocumentsScope объемы
Содержание каталога, возвращенного файловым менеджером URLForUbiquitousContainerIdentifier:
URL в блоке средства доступа скоординированной операции чтения или операции записи, использовавшей NSFileCoordinatorReadingImmediatelyAvailableMetadataOnly, NSFileCoordinatorWritingForDeleting, NSFileCoordinatorWritingForMoving, или NSFileCoordinatorWritingContentIndependentMetadataOnly опции

Необходимо использовать этот метод вместо getResourceValue:forKey:error: для любого URLs, возвращенного этими методами.

Этот метод работает на любое значение ресурса, не связывающееся к содержанию элемента. Некоторые ключи, как NSURLContentAccessDateKey или NSURLGenerationIdentifierKey, не возвращайте допустимые значения. Если Вы используете один из этих ключей, возвратов метода YEStrue, но возвраты значения nil.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– getResourceValue:forKey:error:
– checkPromisedItemIsReachableAndReturnError:
– promisedItemResourceValuesForKeys:error:


    
    promisedItemResourceValuesForKeys (_: ошибка:)
    - promisedItemResourceValuesForKeys:error:

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

Объявление

Swift

func promisedItemResourceValuesForKeys(_ keys: [AnyObject], error error: NSErrorPointer) -> [NSObject : AnyObject]?

Objective C

- (NSDictionary *)promisedItemResourceValuesForKeys:(NSArray *)keys error:(NSError **)error

Параметры

`keys`	Массив имен свойств ресурса URL.
`error`	Ошибка, произошедшая в случае, что не могут быть получены одно или более значений ресурса.

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

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

Обсуждение

Этот метод ведет себя тождественно к resourceValuesForKeys:error:, но работы над обещанными элементами. Обещанный элемент, как гарантируют, не будет иметь свое содержание в файловой системе, пока Вы не будете использовать координатора файла для выполнения скоординированного чтения на его URL, заставляющем содержание быть загруженным или иначе сгенерированным. Обещанный элемент URLs возвращается различным APIs, включая:

Запрос метаданных с помощью любого NSMetadataQueryUbiquitousDataScope или NSMetadataQueryUbiquitousDocumentsScope объемы
Содержание каталога, возвращенного файловым менеджером URLForUbiquitousContainerIdentifier:
URL в блоке средства доступа скоординированной операции чтения или операции записи, использовавшей NSFileCoordinatorReadingImmediatelyAvailableMetadataOnly, NSFileCoordinatorWritingForDeleting, NSFileCoordinatorWritingForMoving, или NSFileCoordinatorWritingContentIndependentMetadataOnly опции

Необходимо использовать этот метод вместо resourceValuesForKeys:error: для любого URLs, возвращенного этими методами.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– resourceValuesForKeys:error:
– checkPromisedItemIsReachableAndReturnError:
– getPromisedItemResourceValue:forKey:error:

Работа с областями монтажа

init (fromPasteboard:) + URLFromPasteboard:

Прочитывает объект NSURL указанной области монтажа.

Объявление

Swift

init?(fromPasteboard pasteBoard: NSPasteboard) -> NSURL

Objective C

+ (NSURL *)URLFromPasteboard:(NSPasteboard *)pasteBoard

Параметры

pasteBoard

Целевая область монтажа.

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

a NSURL объект, или nil если область монтажа не содержит NSURLPboardType данные.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– writeToPasteboard:
writeToPasteboard (_:) - writeToPasteboard:

Пишет URL в указанную область монтажа.

Объявление

Swift

func writeToPasteboard(_ pasteboard: NSPasteboard)

Objective C

- (void)writeToPasteboard:(NSPasteboard *)pasteboard

Параметры

pasteboard

Целевая область монтажа.

Обсуждение

Необходимо объявить NSURLPboardType тип данных для области монтажа прежде, чем вызвать этот метод. Иначе, метод возвращается, ничего не делая.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

+ URLFromPasteboard:
declareTypes:owner: (NSPasteboard)

Типы данных

NSURLBookmarkFileCreationOptions NSURLBookmarkFileCreationOptions

Опции, используемые при создании файла, отмечают данные

Объявление

Swift

typealias NSURLBookmarkFileCreationOptions = Int

Objective C

typedef NSUInteger NSURLBookmarkFileCreationOptions;

Обсуждение

Посмотрите Опции Создания Данных Закладки для получения дополнительной информации.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Константы

Схемы NSURL
Эти схемы - те это NSURL может проанализировать.

Объявление

Swift

var NSURLFileScheme: NSString!

Objective C

NSString * const NSURLFileScheme;

Константы
- NSURLFileScheme
  
  NSURLFileScheme
  
  Идентифицирует URL, указывающий на файл на смонтированном объеме.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Для получения дополнительной информации см. initWithScheme:host:path:.
Ключи системного ресурса общего файла
Ключи, применяющиеся к файловой системе URLs.

Объявление

Swift

let NSURLAddedToDirectoryDateKey: NSString! let NSURLAttributeModificationDateKey: NSString! let NSURLContentAccessDateKey: NSString! let NSURLContentModificationDateKey: NSString! let NSURLCreationDateKey: NSString! let NSURLCustomIconKey: NSString! let NSURLDocumentIdentifierKey: NSString! let NSURLEffectiveIconKey: NSString! let NSURLFileResourceIdentifierKey: NSString! let NSURLFileResourceTypeKey: NSString! let NSURLFileSecurityKey: NSString! let NSURLGenerationIdentifierKey: NSString! let NSURLHasHiddenExtensionKey: NSString! let NSURLIsDirectoryKey: NSString! let NSURLIsExcludedFromBackupKey: NSString! let NSURLIsExecutableKey: NSString! let NSURLIsHiddenKey: NSString! let NSURLIsMountTriggerKey: NSString! let NSURLIsPackageKey: NSString! let NSURLIsReadableKey: NSString! let NSURLIsRegularFileKey: NSString! let NSURLIsSymbolicLinkKey: NSString! let NSURLIsSystemImmutableKey: NSString! let NSURLIsUserImmutableKey: NSString! let NSURLIsVolumeKey: NSString! let NSURLIsWritableKey: NSString! let NSURLLabelColorKey: NSString! let NSURLLabelNumberKey: NSString! let NSURLLinkCountKey: NSString! let NSURLLocalizedLabelKey: NSString! let NSURLLocalizedNameKey: NSString! let NSURLLocalizedTypeDescriptionKey: NSString! let NSURLNameKey: NSString! let NSURLParentDirectoryURLKey: NSString! let NSURLPathKey: NSString! let NSURLPreferredIOBlockSizeKey: NSString! let NSURLTagNamesKey: NSString! let NSURLThumbnailDictionaryKey: NSString! let NSURLThumbnailKey: NSString! let NSURLTypeIdentifierKey: NSString! let NSURLVolumeIdentifierKey: NSString! let NSURLVolumeURLKey: NSString!

Objective C

NSString * const NSURLAddedToDirectoryDateKey NSString * const NSURLAttributeModificationDateKey; NSString * const NSURLContentAccessDateKey; NSString * const NSURLContentModificationDateKey; NSString * const NSURLCreationDateKey; NSString * const NSURLCustomIconKey; NSString * const NSURLDocumentIdentifierKey NSString * const NSURLEffectiveIconKey; NSString * const NSURLFileResourceIdentifierKey; NSString * const NSURLFileResourceTypeKey; NSString * const NSURLFileSecurityKey; NSString * const NSURLGenerationIdentifierKey NSString * const NSURLHasHiddenExtensionKey; NSString * const NSURLIsDirectoryKey; NSString * const NSURLIsExcludedFromBackupKey; NSString * const NSURLIsExecutableKey; NSString * const NSURLIsHiddenKey; NSString * const NSURLIsMountTriggerKey; NSString * const NSURLIsPackageKey; NSString * const NSURLIsReadableKey; NSString * const NSURLIsRegularFileKey; NSString * const NSURLIsSymbolicLinkKey; NSString * const NSURLIsSystemImmutableKey; NSString * const NSURLIsUserImmutableKey; NSString * const NSURLIsVolumeKey; NSString * const NSURLIsWritableKey; NSString * const NSURLLabelColorKey; NSString * const NSURLLabelNumberKey; NSString * const NSURLLinkCountKey; NSString * const NSURLLocalizedLabelKey; NSString * const NSURLLocalizedNameKey; NSString * const NSURLLocalizedTypeDescriptionKey; NSString * const NSURLNameKey; NSString * const NSURLParentDirectoryURLKey; NSString * const NSURLPathKey NSString * const NSURLPreferredIOBlockSizeKey; NSString * const NSURLTagNamesKey; NSString * const NSURLThumbnailDictionaryKey NSString * const NSURLThumbnailKey NSString * const NSURLTypeIdentifierKey; NSString * const NSURLVolumeIdentifierKey; NSString * const NSURLVolumeURLKey;

Константы
- NSURLAddedToDirectoryDateKey
  
  NSURLAddedToDirectoryDateKey
  
  Время, в которое ресурс был создан или переименован в или в его родительском каталоге, возвратилось как NSDate. Когда этот атрибут требуют на трудно соединенных элементах, противоречивое поведение может наблюдаться. Это свойство не поддерживается всеми объемами. (только для чтения)
  
  Доступный в OS X v10.10 и iOS 8.0.
- NSURLAttributeModificationDateKey
  
  NSURLAttributeModificationDateKey
  
  Время, в которое были последний раз изменены атрибуты ресурса, возвратилось как NSDate возразите, поддерживает ли объем даты модификации атрибута, или nil если даты модификации атрибута не поддерживаются (чтение-запись).
  
  Доступный в OS X v10.6 и позже.
- NSURLContentAccessDateKey
  
  NSURLContentAccessDateKey
  
  Время, в которое последний раз получили доступ к ресурсу, возвратилось как NSDate возразите, поддерживает ли объем даты доступа, или nil если даты доступа не поддерживаются (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLContentModificationDateKey
  
  NSURLContentModificationDateKey
  
  Время, в которое был последний раз изменен ресурс, возвратилось как NSDate возразите, поддерживает ли объем даты модификации, или nil если даты модификации не поддерживаются (чтение-запись).
  
  Доступный в OS X v10.6 и позже.
- NSURLCreationDateKey
  
  NSURLCreationDateKey
  
  Дата создания ресурса, возвращенная как NSDate возразите, поддерживает ли объем даты создания, или nil если даты создания не поддерживаются (чтение-запись).
  
  Доступный в OS X v10.6 и позже.
- NSURLCustomIconKey
  
  NSURLCustomIconKey
  
  Значок, сохраненный ресурсом, возвращенным как NSImage объект, или nil если ресурс не имеет никакого пользовательского значка.
  
  Доступный в OS X v10.6 и позже.
- NSURLDocumentIdentifierKey
  
  NSURLDocumentIdentifierKey
  
  Идентификатор документа возвратился как NSNumber (только для чтения).
  
  Идентификатор документа является значением, присвоенным ядром файлу или каталогу. Это значение используется для идентификации документа независимо от того, куда это перемещено в объем. Идентификатор сохраняется через системные перезапуски. Это не передается, когда файл копируется, но это остается в силе «после безопасного сохранения” операции. Например, это остается на пути, которому это было присвоено, даже после вызова replaceItemAtURL:withItemAtURL:backupItemName:options:resultingItemURL:error: метод. Идентификаторы документа только уникальны в единственном объеме. Это свойство не поддерживается всеми объемами.
  
  Доступный в OS X v10.10 и iOS 8.0.
- NSURLEffectiveIconKey
  
  NSURLEffectiveIconKey
  
  Нормальный значок ресурса, возвращенный как NSImage объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLFileResourceIdentifierKey
  
  NSURLFileResourceIdentifierKey
  
  Уникальный идентификатор ресурса, возвращенный как id (только для чтения).
  
  Этот идентификатор может использоваться для определения равенства между ресурсами файловой системы с isEqual: метод. Два ресурса равны, если у них есть тот же путь файловой системы или если их пути соединяются с тем же inode в той же файловой системе.
  
  Значение этого идентификатора не является персистентным через системные перезапуски.
  
  Доступный в OS X v10.7 и позже.
- NSURLFileResourceTypeKey
  
  NSURLFileResourceTypeKey
  
  Тип объекта ресурса, возвращенный как NSString объект (только для чтения). Посмотрите Типы ресурсов Файла для возможных значений.
  
  Доступный в OS X v10.7 и позже.
- NSURLFileSecurityKey
  
  NSURLFileSecurityKey
  
  Информация о безопасности ресурса, возвращенная как NSFileSecurity объект (чтение-запись).
  
  Доступный в OS X v10.7 и позже.
- NSURLGenerationIdentifierKey
  
  NSURLGenerationIdentifierKey
  
  Непрозрачный идентификатор генерации, возвращенный как id <NSCopying, NSCoding, NSObject> (только для чтения)
  
  Идентификатор генерации может быть сравнен с помощью isEqual: определить, были ли изменены данные в документе. Для URLs, относящегося к тому же файлу inode, изменения идентификатора генерации, когда изменяются данные в ветви данных файла. Изменения в расширенных атрибутах или других метаданных файловой системы не изменяют идентификатор. Для URLs, обращающегося к тому же каталогу inode, изменения идентификатора генерации, когда прямые дочерние элементы того каталога добавлены, удалены или переименованы. Изменения в данных прямых дочерних элементов того каталога не изменяют идентификатор генерации. Идентификатор сохраняется через системные перезапуски. Когда документ копируется в другой объем, это связывается к определенному документу об удельном объеме и не передается. Это свойство не поддерживается всеми объемами.
  
  Доступный в OS X v10.10 и iOS 8.0.
- NSURLHasHiddenExtensionKey
  
  NSURLHasHiddenExtensionKey
  
  Ключ для определения, удаляется ли расширение ресурса обычно из его локализованного имени, возвратился как булевская переменная NSNumber объект (чтение-запись).
  
  Доступный в OS X v10.6 и позже.
- NSURLIsDirectoryKey
  
  NSURLIsDirectoryKey
  
  Ключ для определения, является ли ресурс каталогом, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLIsExcludedFromBackupKey
  
  NSURLIsExcludedFromBackupKey
  
  Ключ для определения, исключен ли ресурс из всех резервных копий данных приложения, возвратился как булевская переменная NSNumber объект (чтение-запись).
  
  Можно использовать это свойство для исключения кэша и других файлов поддержки приложений, которые не необходимы в резервном копировании. Некоторые операции, обычно делаемые к пользовательским документам, заставляют это свойство быть сброшенным к false; следовательно, не используйте это свойство на пользовательских документах.
  
  Доступный в OS X v10.8 и позже.
- NSURLIsExecutableKey
  
  NSURLIsExecutableKey
  
  Ключ для определения, может ли текущий процесс (как определено EUID) выполнить ресурс (если это - файл) или ищет ресурс (если это - каталог), возвращенный как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLIsHiddenKey
  
  NSURLIsHiddenKey
  
  Ключ для определения, не выводится ли ресурс обычно на экран пользователям, возвратился как булевская переменная NSNumber объект (чтение-запись).
  
  Примечание:
  
  Если ресурс скрыт, потому что его имя начинается с периода, устанавливание этого значения не имеет никакого эффекта.
  
  Доступный в OS X v10.6 и позже.
- NSURLIsMountTriggerKey
  
  NSURLIsMountTriggerKey
  
  Ключ для определения, является ли URL триггерным каталогом файловой системы, возвратился как булевская переменная NSNumber объект (только для чтения). Пересечение или открытие триггерного каталога файловой системы вызывают попытку смонтировать файловую систему на каталоге.
  
  Доступный в OS X v10.7 и позже.
- NSURLIsPackageKey
  
  NSURLIsPackageKey
  
  Ключ для определения, является ли ресурс пакетом файла, возвратился как булевская переменная NSNumber объект (чтение-запись в OS X v10.8 и позже, только для чтения в предыдущих версиях). A true оцените означает, что ресурс является пакетом файла.
  
  При попытке установить или очистить значение этого ключа на файле вместо каталога, система игнорирует Вашу попытку. Если каталог определяется как пакет посредством его расширения файла или другой причины кроме этого ключа, устанавливая значение этого ключа в false не имеет никакого эффекта.
  
  Доступный в OS X v10.6 и позже.
- NSURLIsReadableKey
  
  NSURLIsReadableKey
  
  Ключ для определения, может ли текущий процесс (как определено EUID) считать ресурс, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLIsRegularFileKey
  
  NSURLIsRegularFileKey
  
  Ключ для определения, является ли ресурс регулярным файлом, в противоположность каталогу или символьной ссылке. Возвращенный как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLIsSymbolicLinkKey
  
  NSURLIsSymbolicLinkKey
  
  Ключ для определения, является ли ресурс символьной ссылкой, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLIsSystemImmutableKey
  
  NSURLIsSystemImmutableKey
  
  Ключ для определения, установлена ли система ресурса неизменный бит, возвратился как булевская переменная NSNumber объект (чтение-запись).
  
  Доступный в OS X v10.6 и позже.
- NSURLIsUserImmutableKey
  
  NSURLIsUserImmutableKey
  
  Ключ для определения, установлен ли пользователь ресурса неизменный бит, возвратился как булевская переменная NSNumber объект (чтение-запись).
  
  Доступный в OS X v10.6 и позже.
- NSURLIsVolumeKey
  
  NSURLIsVolumeKey
  
  Ключ для определения, является ли ресурс корневым каталогом объема, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLIsWritableKey
  
  NSURLIsWritableKey
  
  Ключ для определения, может ли текущий процесс (как определено EUID) записать в ресурс, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLLabelColorKey
  
  NSURLLabelColorKey
  
  Цвет метки ресурса, возвращенный как NSColor объект, или nil если ресурс не имеет никакого цвета метки (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLLabelNumberKey
  
  NSURLLabelNumberKey
  
  Номер метки ресурса, возвращенный как NSNumber объект (чтение-запись).
  
  Доступный в OS X v10.6 и позже.
- NSURLLinkCountKey
  
  NSURLLinkCountKey
  
  Число жестких ссылок на ресурс, возвращенный как NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLLocalizedLabelKey
  
  NSURLLocalizedLabelKey
  
  Локализованный текст метки ресурса, возвращенный как NSString объект, или nil если ресурс не имеет никакого локализованного текста метки (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLLocalizedNameKey
  
  NSURLLocalizedNameKey
  
  Локализованное или скрытое от расширения имя ресурса, возвращенное как NSString объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLLocalizedTypeDescriptionKey
  
  NSURLLocalizedTypeDescriptionKey
  
  Локализованное описание типа ресурса, возвращенное как NSString объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLNameKey
  
  NSURLNameKey
  
  Имя ресурса в файловой системе, возвращенной как NSString объект (чтение-запись).
  
  Доступный в OS X v10.6 и позже.
- NSURLParentDirectoryURLKey
  
  NSURLParentDirectoryURLKey
  
  Родительский каталог ресурса, возвращенного как NSURL объект, или nil если ресурс является корневым каталогом своего объема (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLPathKey
  
  NSURLPathKey
  
  Путь файловой системы для URL, возвращенного как NSString объект (только для чтения).
  
  Доступный в OS X v10.8 и позже.
- NSURLPreferredIOBlockSizeKey
  
  NSURLPreferredIOBlockSizeKey
  
  Оптимальный размер блока для использования при чтении или записи данных этого файла, возвратился как NSNumber объект, или nil если предпочтительный размер не доступен (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLTagNamesKey
  
  NSURLTagNamesKey
  
  Имена тегов, присоединенных к ресурсу, возвращенному как массив NSString значения (чтение-запись).
  
  Доступный в OS X v10.9 и позже.
- NSURLThumbnailDictionaryKey
  
  NSURLThumbnailDictionaryKey
  
  Словарь объектов NSImage/UIImage, включенных размером (чтение-запись). Посмотрите Ключи Свойства Миниатюры для списка возможных ключей.
  
  Доступный в OS X v10.10 и iOS 8.0.
- NSURLThumbnailKey
  
  NSURLThumbnailKey
  
  Все миниатюры как единственный NSImage (чтение-запись).
  
  Доступный в OS X v10.10.
- NSURLTypeIdentifierKey
  
  NSURLTypeIdentifierKey
  
  Универсальный идентификатор типа (UTI) ресурса, возвращенный как NSString объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLVolumeIdentifierKey
  
  NSURLVolumeIdentifierKey
  
  Уникальный идентификатор объема ресурса, возвращенного как id (только для чтения).
  
  Этот идентификатор может использоваться с isEqual: метод, чтобы определить, являются ли два ресурса файловой системы на том же объеме.
  
  Значение этого идентификатора не является персистентным через системные перезапуски.
  
  Доступный в OS X v10.7 и позже.
- NSURLVolumeURLKey
  
  NSURLVolumeURLKey
  
  Корневой каталог объема ресурса, возвращенного как NSURL объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
Обсуждение

Для запроса информации с помощью одного из этих ключей передайте его forKey: параметр getResourceValue:forKey:error: метод экземпляра.
Типы ресурсов файла
Возможные значения для NSURLFileResourceTypeKey ключ.

Объявление

Swift

let NSURLFileResourceTypeNamedPipe: NSString! let NSURLFileResourceTypeCharacterSpecial: NSString! let NSURLFileResourceTypeDirectory: NSString! let NSURLFileResourceTypeBlockSpecial: NSString! let NSURLFileResourceTypeRegular: NSString! let NSURLFileResourceTypeSymbolicLink: NSString! let NSURLFileResourceTypeSocket: NSString! let NSURLFileResourceTypeUnknown: NSString!

Objective C

NSString * const NSURLFileResourceTypeNamedPipe; NSString * const NSURLFileResourceTypeCharacterSpecial; NSString * const NSURLFileResourceTypeDirectory; NSString * const NSURLFileResourceTypeBlockSpecial; NSString * const NSURLFileResourceTypeRegular; NSString * const NSURLFileResourceTypeSymbolicLink; NSString * const NSURLFileResourceTypeSocket; NSString * const NSURLFileResourceTypeUnknown;

Константы
- NSURLFileResourceTypeNamedPipe
  
  NSURLFileResourceTypeNamedPipe
  
  Ресурс является именованным каналом.
  
  Доступный в OS X v10.7 и позже.
- NSURLFileResourceTypeCharacterSpecial
  
  NSURLFileResourceTypeCharacterSpecial
  
  Ресурс является символьным специальным файлом.
  
  Доступный в OS X v10.7 и позже.
- NSURLFileResourceTypeDirectory
  
  NSURLFileResourceTypeDirectory
  
  Ресурс является каталогом.
  
  Доступный в OS X v10.7 и позже.
- NSURLFileResourceTypeBlockSpecial
  
  NSURLFileResourceTypeBlockSpecial
  
  Ресурс является блоком специальный файл.
  
  Доступный в OS X v10.7 и позже.
- NSURLFileResourceTypeRegular
  
  NSURLFileResourceTypeRegular
  
  Ресурс является регулярным файлом.
  
  Доступный в OS X v10.7 и позже.
- NSURLFileResourceTypeSymbolicLink
  
  NSURLFileResourceTypeSymbolicLink
  
  Ресурс является символьной ссылкой.
  
  Доступный в OS X v10.7 и позже.
- NSURLFileResourceTypeSocket
  
  NSURLFileResourceTypeSocket
  
  Ресурс является сокетом.
  
  Доступный в OS X v10.7 и позже.
- NSURLFileResourceTypeUnknown
  
  NSURLFileResourceTypeUnknown
  
  Тип ресурса неизвестен.
  
  Доступный в OS X v10.7 и позже.
Ключи свойства миниатюры
Возможные ключи для NSURLThumbnailDictionaryKey словарь.

Объявление

Swift

let NSThumbnail1024x1024SizeKey: NSString!

Objective C

NSString * const NSThumbnail1024x1024SizeKey

Константы
- NSThumbnail1024x1024SizeKey
  
  NSThumbnail1024x1024SizeKey
  
  Миниатюра на 1024 x 1 024 пикселя как a UIImage на iOS или NSImage на OS X.
  
  Доступный в OS X v10.10 и позже.
Ключи свойства файла
Ключи, применяющиеся к свойствам файлов.

Объявление

Swift

let NSURLFileSizeKey: NSString! let NSURLFileAllocatedSizeKey: NSString! let NSURLTotalFileSizeKey: NSString! let NSURLTotalFileAllocatedSizeKey: NSString! let NSURLIsAliasFileKey: NSString!

Objective C

NSString * const NSURLFileSizeKey; NSString * const NSURLFileAllocatedSizeKey; NSString * const NSURLIsAliasFileKey; NSString * const NSURLTotalFileAllocatedSizeKey; NSString * const NSURLTotalFileSizeKey;

Константы
- NSURLFileSizeKey
  
  NSURLFileSizeKey
  
  Ключ для размера файла в байтах, возвращенных как NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLFileAllocatedSizeKey
  
  NSURLFileAllocatedSizeKey
  
  Ключ для общего размера, выделенного на диске для файла, возвращенного как NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLTotalFileSizeKey
  
  NSURLTotalFileSizeKey
  
  Ключ для общего визуализуемого размера файла в байтах, возвращенных как NSNumber объект (только для чтения). Это включает размер любых метаданных файла.
  
  Доступный в OS X v10.7 и позже.
- NSURLTotalFileAllocatedSizeKey
  
  NSURLTotalFileAllocatedSizeKey
  
  Ключ для общего выделенного размера файла в байтах, возвращенных как NSNumber объект (только для чтения). Это включает размер любых метаданных файла.
  
  Доступный в OS X v10.7 и позже.
- NSURLIsAliasFileKey
  
  NSURLIsAliasFileKey
  
  Ключ для определения, является ли файл псевдонимом, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
Ключи свойства объема
Ключи, применяющиеся к объемам.

Объявление

Swift

let NSURLVolumeLocalizedFormatDescriptionKey: NSString! let NSURLVolumeTotalCapacityKey: NSString! let NSURLVolumeAvailableCapacityKey: NSString! let NSURLVolumeResourceCountKey: NSString! let NSURLVolumeSupportsPersistentIDsKey: NSString! let NSURLVolumeSupportsSymbolicLinksKey: NSString! let NSURLVolumeSupportsHardLinksKey: NSString! let NSURLVolumeSupportsJournalingKey: NSString! let NSURLVolumeIsJournalingKey: NSString! let NSURLVolumeSupportsSparseFilesKey: NSString! let NSURLVolumeSupportsZeroRunsKey: NSString! let NSURLVolumeSupportsCaseSensitiveNamesKey: NSString! let NSURLVolumeSupportsCasePreservedNamesKey: NSString! let NSURLVolumeSupportsRootDirectoryDatesKey: NSString! let NSURLVolumeSupportsVolumeSizesKey: NSString! let NSURLVolumeSupportsRenamingKey: NSString! let NSURLVolumeSupportsAdvisoryFileLockingKey: NSString! let NSURLVolumeSupportsExtendedSecurityKey: NSString! let NSURLVolumeIsBrowsableKey: NSString! let NSURLVolumeMaximumFileSizeKey: NSString! let NSURLVolumeIsEjectableKey: NSString! let NSURLVolumeIsRemovableKey: NSString! let NSURLVolumeIsInternalKey: NSString! let NSURLVolumeIsAutomountedKey: NSString! let NSURLVolumeIsLocalKey: NSString! let NSURLVolumeIsReadOnlyKey: NSString! let NSURLVolumeCreationDateKey: NSString! let NSURLVolumeURLForRemountingKey: NSString! let NSURLVolumeUUIDStringKey: NSString! let NSURLVolumeNameKey: NSString! let NSURLVolumeLocalizedNameKey: NSString!

Objective C

NSString * const NSURLVolumeLocalizedFormatDescriptionKey; NSString * const NSURLVolumeTotalCapacityKey; NSString * const NSURLVolumeAvailableCapacityKey; NSString * const NSURLVolumeResourceCountKey; NSString * const NSURLVolumeSupportsPersistentIDsKey; NSString * const NSURLVolumeSupportsSymbolicLinksKey; NSString * const NSURLVolumeSupportsHardLinksKey; NSString * const NSURLVolumeSupportsJournalingKey; NSString * const NSURLVolumeIsJournalingKey; NSString * const NSURLVolumeSupportsSparseFilesKey; NSString * const NSURLVolumeSupportsZeroRunsKey; NSString * const NSURLVolumeSupportsCaseSensitiveNamesKey; NSString * const NSURLVolumeSupportsCasePreservedNamesKey; NSString * const NSURLVolumeSupportsRootDirectoryDatesKey; NSString * const NSURLVolumeSupportsVolumeSizesKey; NSString * const NSURLVolumeSupportsRenamingKey; NSString * const NSURLVolumeSupportsAdvisoryFileLockingKey; NSString * const NSURLVolumeSupportsExtendedSecurityKey; NSString * const NSURLVolumeIsBrowsableKey; NSString * const NSURLVolumeMaximumFileSizeKey; NSString * const NSURLVolumeIsEjectableKey; NSString * const NSURLVolumeIsRemovableKey; NSString * const NSURLVolumeIsInternalKey; NSString * const NSURLVolumeIsAutomountedKey; NSString * const NSURLVolumeIsLocalKey; NSString * const NSURLVolumeIsReadOnlyKey; NSString * const NSURLVolumeCreationDateKey; NSString * const NSURLVolumeURLForRemountingKey; NSString * const NSURLVolumeUUIDStringKey; NSString * const NSURLVolumeNameKey; NSString * const NSURLVolumeLocalizedNameKey;

Константы
- NSURLVolumeLocalizedFormatDescriptionKey
  
  NSURLVolumeLocalizedFormatDescriptionKey
  
  Ключ для дескриптивного имени формата объема, возвращенного как NSString объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLVolumeTotalCapacityKey
  
  NSURLVolumeTotalCapacityKey
  
  Ключ для способности объема в байтах, возвращенных как NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLVolumeAvailableCapacityKey
  
  NSURLVolumeAvailableCapacityKey
  
  Ключ для полезной мощности объема в байтах, возвращенных как NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLVolumeResourceCountKey
  
  NSURLVolumeResourceCountKey
  
  Ключ для общего количества ресурсов на объеме, возвращенном как NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLVolumeSupportsPersistentIDsKey
  
  NSURLVolumeSupportsPersistentIDsKey
  
  Ключ для определения, поддерживает ли объем персистентный IDs, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLVolumeSupportsSymbolicLinksKey
  
  NSURLVolumeSupportsSymbolicLinksKey
  
  Ключ для определения, поддерживает ли объем символьные ссылки, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLVolumeSupportsHardLinksKey
  
  NSURLVolumeSupportsHardLinksKey
  
  Ключ для определения, поддерживает ли объем жесткие ссылки, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLVolumeSupportsJournalingKey
  
  NSURLVolumeSupportsJournalingKey
  
  Ключ для определения, поддерживает ли объем журналирование, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLVolumeIsJournalingKey
  
  NSURLVolumeIsJournalingKey
  
  Ключ для определения, журналирует ли объем в настоящее время, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLVolumeSupportsSparseFilesKey
  
  NSURLVolumeSupportsSparseFilesKey
  
  Ключ для определения, поддерживает ли объем редкие файлы, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLVolumeSupportsZeroRunsKey
  
  NSURLVolumeSupportsZeroRunsKey
  
  Ключ для определения, поддерживает ли объем нулевые выполнения, возвращенные как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLVolumeSupportsCaseSensitiveNamesKey
  
  NSURLVolumeSupportsCaseSensitiveNamesKey
  
  Ключ для определения, поддерживает ли объем чувствительные к регистру имена, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLVolumeSupportsCasePreservedNamesKey
  
  NSURLVolumeSupportsCasePreservedNamesKey
  
  Ключ для определения, поддерживает ли объем сохраненные случаем имена, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.6 и позже.
- NSURLVolumeSupportsRootDirectoryDatesKey
  
  NSURLVolumeSupportsRootDirectoryDatesKey
  
  Ключ для определения, поддерживает ли объем надежное хранение времен для корневого каталога, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLVolumeSupportsVolumeSizesKey
  
  NSURLVolumeSupportsVolumeSizesKey
  
  Ключ для определения, ли поддержки объема, возвращая информацию о размере тома, возвращенную как булевская переменная NSNumber объект (только для чтения). Если true, информация о размере тома доступна как значения NSURLVolumeTotalCapacityKey иNSURLVolumeAvailableCapacityKey ключи.
  
  Доступный в OS X v10.7 и позже.
- NSURLVolumeSupportsRenamingKey
  
  NSURLVolumeSupportsRenamingKey
  
  Ключ для определения, может ли объем быть переименован, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLVolumeSupportsAdvisoryFileLockingKey
  
  NSURLVolumeSupportsAdvisoryFileLockingKey
  
  Ключ для определения, реализует ли объем консультацию целого файла, привязывает стиль flock, вместе с O_EXLOCK и O_SHLOCK флаги open функция, возвращенная как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLVolumeSupportsExtendedSecurityKey
  
  NSURLVolumeSupportsExtendedSecurityKey
  
  Ключ для определения, поддерживает ли объем расширенную безопасность (списки управления доступом), возвращенные как булевская переменная NSNumber объект (только для чтения) (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLVolumeIsBrowsableKey
  
  NSURLVolumeIsBrowsableKey
  
  Ключ для определения, видим ли объем в основанных на GUI просматривающих файл средах, таков как Рабочий стол или приложение Средства поиска, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLVolumeMaximumFileSizeKey
  
  NSURLVolumeMaximumFileSizeKey
  
  Ключ для самого большого размера файла, поддерживаемого объемом в байтах, возвращенных как булевская переменная NSNumber объект, или nil если это не может быть определено (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLVolumeIsEjectableKey
  
  NSURLVolumeIsEjectableKey
  
  Ключ для определения, является ли объем выбрасываемым от механизма диска при программном управлении, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLVolumeIsRemovableKey
  
  NSURLVolumeIsRemovableKey
  
  Ключ для определения, является ли объем съемным от механизма диска, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLVolumeIsInternalKey
  
  NSURLVolumeIsInternalKey
  
  Ключ для определения, подключен ли объем к внутренней шине, возвратился как булевская переменная NSNumber объект, или nil если это не может быть определено (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLVolumeIsAutomountedKey
  
  NSURLVolumeIsAutomountedKey
  
  Ключ для определения, автосмонтирован ли объем, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLVolumeIsLocalKey
  
  NSURLVolumeIsLocalKey
  
  Ключ для определения, сохранен ли объем на локальном устройстве, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLVolumeIsReadOnlyKey
  
  NSURLVolumeIsReadOnlyKey
  
  Ключ для определения, только ли объем для чтения, возвратился как булевская переменная NSNumber объект (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLVolumeCreationDateKey
  
  NSURLVolumeCreationDateKey
  
  Ключ для даты создания объема, возвращенной как NSDate объект, или NULL если это не может быть определено (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLVolumeURLForRemountingKey
  
  NSURLVolumeURLForRemountingKey
  
  Ключ для URL должен был повторно смонтировать сетевой том, возвращенный как NSURL объект, или nil если URL не доступен (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLVolumeUUIDStringKey
  
  NSURLVolumeUUIDStringKey
  
  Ключ для персистентного UUID объема, возвращенного как NSString объект, или nil если персистентный UUID не доступен (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLVolumeNameKey
  
  NSURLVolumeNameKey
  
  Имя объема, возвращенного как NSString объект (чтение-запись). Устанавливаемый, только если NSURLVolumeSupportsRenamingKey YEStrue.
  
  Доступный в OS X v10.7 и позже.
- NSURLVolumeLocalizedNameKey
  
  NSURLVolumeLocalizedNameKey
  
  Имя объема, поскольку это должно быть выведено на экран в пользовательском интерфейсе, возвратилось как NSString объект (только для чтения).
  
  Доступный в OS X v10.7 и позже.
Обсуждение

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

Объявление

Swift

struct NSURLBookmarkCreationOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var PreferFileIDResolution: NSURLBookmarkCreationOptions { get } static var MinimalBookmark: NSURLBookmarkCreationOptions { get } static var SuitableForBookmarkFile: NSURLBookmarkCreationOptions { get } static var WithSecurityScope: NSURLBookmarkCreationOptions { get } static var SecurityScopeAllowOnlyReadAccess: NSURLBookmarkCreationOptions { get } }

Objective C

enum { NSURLBookmarkCreationPreferFileIDResolution = ( 1UL << 8 ), NSURLBookmarkCreationMinimalBookmark = ( 1UL << 9 ), NSURLBookmarkCreationSuitableForBookmarkFile = ( 1UL << 10 ), NSURLBookmarkCreationWithSecurityScope = ( 1UL << 11 ), NSURLBookmarkCreationSecurityScopeAllowOnlyReadAccess = ( 1UL << 12 ) }; typedef NSUInteger NSURLBookmarkCreationOptions;

Константы
- PreferFileIDResolution
  
  NSURLBookmarkCreationPreferFileIDResolution
  
  Указывает, что, когда закладка, создаваемая с этой опцией, разрешена, ее встроенный идентификатор файла должен иметь приоритет по другим источникам информации (путь файловой системы, например) в случае конфликта.
  
  Доступный в OS X v10.6 и позже.
  Осуждаемый в OS X v10.9.
- MinimalBookmark
  
  NSURLBookmarkCreationMinimalBookmark
  
  Указывает, что закладка, создаваемая с этой опцией, должна быть создана с минимальной информацией. Это производит меньшую закладку, которая может быть разрешена меньшим количеством способов.
  
  Доступный в OS X v10.6 и позже.
- SuitableForBookmarkFile
  
  NSURLBookmarkCreationSuitableForBookmarkFile
  
  Указывает, что данные закладки должны включать свойства, требуемые создать файлы псевдонима Средства поиска.
  
  Доступный в OS X v10.6 и позже.
- WithSecurityScope
  
  NSURLBookmarkCreationWithSecurityScope
  
  Указывает, что Вы хотите создать ограниченную по объему безопасностью закладку, когда разрешено, обеспечивающую ограниченный по объему безопасностью URL, позволяющий доступ для чтения-записи к ресурсу файловой системы; для использования в приложении, принимающем Тестовую среду приложения. Для получения дополнительной информации см. Руководство по проектированию Тестовой среды приложения. Обратите внимание на то, что этот флаг не может использоваться в сочетании с также NSURLBookmarkCreationMinimalBookmark или NSURLBookmarkCreationSuitableForBookmarkFile.
  
  Доступный в OS X v10.7 и позже.
- SecurityScopeAllowOnlyReadAccess
  
  NSURLBookmarkCreationSecurityScopeAllowOnlyReadAccess
  
  Когда объединено с NSURLBookmarkCreationWithSecurityScope опция, указывает, что Вы хотите создать ограниченную по объему безопасностью закладку, когда разрешено, обеспечивающую ограниченный по объему безопасностью URL, позволяющий доступ только для чтения к ресурсу файловой системы; для использования в приложении, принимающем Тестовую среду приложения. Для получения дополнительной информации см. Руководство по проектированию Тестовой среды приложения.
  
  Доступный в OS X v10.7 и позже.
Обсуждение

При создании закладки используйте поразрядно OR операторы для объединения опций Вы хотите указать, и обеспечить их для options параметр bookmarkDataWithOptions:includingResourceValuesForKeys:relativeToURL:error: метод.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.6 и позже.
Параметры разрешения данных закладки
Опции, используемые при разрешении данных закладки.

Объявление

Swift

struct NSURLBookmarkResolutionOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var WithoutUI: NSURLBookmarkResolutionOptions { get } static var WithoutMounting: NSURLBookmarkResolutionOptions { get } static var WithSecurityScope: NSURLBookmarkResolutionOptions { get } }

Objective C

enum { NSURLBookmarkResolutionWithoutUI = ( 1UL << 8 ), NSURLBookmarkResolutionWithoutMounting = ( 1UL << 9 ), NSURLBookmarkResolutionWithSecurityScope = ( 1UL << 10 ) }; typedef NSUInteger NSURLBookmarkResolutionOptions;

Константы
- WithoutUI
  
  NSURLBookmarkResolutionWithoutUI
  
  Указывает, что никакая обратная связь UI не должна сопровождать разрешение данных закладки.
  
  Доступный в OS X v10.6 и позже.
- WithoutMounting
  
  NSURLBookmarkResolutionWithoutMounting
  
  Указывает, что никакой объем не должен быть смонтирован во время разрешения данных закладки.
  
  Доступный в OS X v10.6 и позже.
- WithSecurityScope
  
  NSURLBookmarkResolutionWithSecurityScope
  
  Указывает, что объем безопасности, применился к закладке, когда это создавалось, должен использоваться во время разрешения данных закладки.
  
  Доступный в OS X v10.7 и позже.
Обсуждение

При разрешении закладки используйте поразрядно OR операторы для объединения опций Вы хотите указать, и обеспечить их для options параметр URLByResolvingBookmarkData:options:relativeToURL:bookmarkDataIsStale:error: метод.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.6 и позже.
NSURLHandle ключи свойства FTP
Специфичные для FTP ключи свойства.

Объявление

Objective C

NSString *NSFTPPropertyUserLoginKey; NSString *NSFTPPropertyUserPasswordKey; NSString *NSFTPPropertyActiveTransferModeKey; NSString *NSFTPPropertyFileOffsetKey; NSString *NSFTPPropertyFTPProxy;

Константы
- NSFTPPropertyUserLoginKey
  
  NSFTPPropertyUserLoginKey
  
  Ключ для пользовательского входа в систему, возвращенного как NSString объект.
  
  Значение по умолчанию для этого ключа является «анонимным».
  
  Доступный в OS X v10.2 и позже.
  Осуждаемый в OS X v10.4.
- NSFTPPropertyUserPasswordKey
  
  NSFTPPropertyUserPasswordKey
  
  Ключ для пароля пользователя, возвращенного как NSString объект.
  
  Значение по умолчанию для этого ключа»NSURLHandle@apple.com".
  
  Доступный в OS X v10.2 и позже.
  Осуждаемый в OS X v10.4.
- NSFTPPropertyActiveTransferModeKey
  
  NSFTPPropertyActiveTransferModeKey
  
  Ключ для получения, перенеслась ли в активном режиме передачи, возвращенном, поскольку, булевская переменная в NSNumber объект.
  
  Значение по умолчанию для этого ключа NOfalse (пассивный режим).
  
  Доступный в OS X v10.2 и позже.
  Осуждаемый в OS X v10.4.
- NSFTPPropertyFileOffsetKey
  
  NSFTPPropertyFileOffsetKey
  
  Ключ для получения файлового смещения, возвращенного как NSNumber объект. Значение по умолчанию для этого ключа является нулем.
  
  Доступный в OS X v10.2 и позже.
  Осуждаемый в OS X v10.4.
- NSFTPPropertyFTPProxy
  
  NSFTPPropertyFTPProxy
  
  NSDictionary содержа информацию прокси для использования вместо прокси, идентифицированного в SystemConfiguration.framework.
  
  Для предотвращения любого использования прокси передайте пустой словарь.
  
  Доступный в OS X v10.3 и позже.
  Осуждаемый в OS X v10.4.
Обсуждение

Передайте эти ключи NSURLHandle getResourceValue:forKey:error: или resourceValuesForKeys:error: метод, чтобы запросить определенные данные. Все ключи являются дополнительными. Конфигурация по умолчанию позволяет анонимное, пассивный режим, одноразовую передачу указанного URL.
NSURLHandle ключи свойства HTTP
Специфичные для HTTP ключи свойства.

Объявление

Objective C

NSString * const NSHTTPPropertyStatusCodeKey; NSString * const NSHTTPPropertyStatusReasonKey; NSString * const NSHTTPPropertyServerHTTPVersionKey; NSString * const NSHTTPPropertyRedirectionHeadersKey; NSString * const NSHTTPPropertyErrorPageDataKey; NSString * const NSHTTPPropertyHTTPProxy;

Константы
- NSHTTPPropertyStatusCodeKey
  
  NSHTTPPropertyStatusCodeKey
  
  Ключ для кода состояния, возвращенного как целое число, перенесся в NSNumber объект.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.4.
- NSHTTPPropertyStatusReasonKey
  
  NSHTTPPropertyStatusReasonKey
  
  Ключ для остатка от строки состояния HTTP после кода состояния, возвращенного как NSString объект.
  
  Эта строка обычно содержит объяснение ошибки на английском языке. Поскольку эта строка взята прямо от ответа сервера, она не локализуется.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.4.
- NSHTTPPropertyServerHTTPVersionKey
  
  NSHTTPPropertyServerHTTPVersionKey
  
  Ключ для получения версии HTTP как NSString объект, содержащий начальную строку состояния сервера до первого пространства.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.4.
- NSHTTPPropertyRedirectionHeadersKey
  
  NSHTTPPropertyRedirectionHeadersKey
  
  Ключ для получения заголовков перенаправления как NSDictionary объект с каждым значением заголовка ввел к имени заголовка.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.4.
- NSHTTPPropertyErrorPageDataKey
  
  NSHTTPPropertyErrorPageDataKey
  
  Ключ для получения ошибочной страницы как NSData объект.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.4.
- NSHTTPPropertyHTTPProxy
  
  NSHTTPPropertyHTTPProxy
  
  Ключ для получения NSDictionary объект, содержащий информацию прокси для использования вместо прокси, идентифицированного в SystemConfiguration.framework.
  
  Для предотвращения любого использования прокси передайте пустой словарь.
  
  Доступный в OS X v10.2 и позже.
  Осуждаемый в OS X v10.4.
Обсуждение

Передайте эти ключи NSURLHandle getResourceValue:forKey:error: или resourceValuesForKeys:error: метод, чтобы запросить определенные данные.
Ключи NSError userInfo Словаря
Ключи в userInfo словаре NSError возразите, когда бесспорный, что методы NSURL возвращают ошибку.

Объявление

Swift

let NSURLKeysOfUnsetValuesKey: NSString!

Objective C

NSString * const NSURLKeysOfUnsetValuesKey;

Константы
- NSURLKeysOfUnsetValuesKey
  
  NSURLKeysOfUnsetValuesKey
  
  Ключ для свойств ресурса, не установленных после setResourceValues:error: метод возвращает ошибку, возвращенную как массив NSString объекты.
  
  Доступный в OS X v10.7 и позже.
Повсеместные ключи свойства элемента
Ключи, описывающие состояние хранения iCloud файла.

Объявление

Swift

let NSURLIsUbiquitousItemKey: NSString! let NSURLUbiquitousItemDownloadingErrorKey: NSString! let NSURLUbiquitousItemDownloadingStatusKey: NSString! let NSURLUbiquitousItemHasUnresolvedConflictsKey: NSString! let NSURLUbiquitousItemIsDownloadingKey: NSString! let NSURLUbiquitousItemIsUploadedKey: NSString! let NSURLUbiquitousItemIsUploadingKey: NSString! let NSURLUbiquitousItemUploadingErrorKey: NSString!

Objective C

NSString * const NSURLIsUbiquitousItemKey; NSString * const NSURLUbiquitousItemDownloadingErrorKey; NSString * const NSURLUbiquitousItemDownloadingStatusKey; NSString * const NSURLUbiquitousItemHasUnresolvedConflictsKey; NSString * const NSURLUbiquitousItemIsDownloadedKey; NSString * const NSURLUbiquitousItemIsDownloadingKey; NSString * const NSURLUbiquitousItemIsUploadedKey; NSString * const NSURLUbiquitousItemIsUploadingKey; NSString * const NSURLUbiquitousItemPercentDownloadedKey; NSString * const NSURLUbiquitousItemPercentUploadedKey; NSString * const NSURLUbiquitousItemUploadingErrorKey;

Константы
- NSURLIsUbiquitousItemKey
  
  NSURLIsUbiquitousItemKey
  
  Булевская переменная NSNumber это содержит true если этот элемент находится в хранении iCloud, false если это - локальный элемент (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLUbiquitousItemDownloadingErrorKey
  
  NSURLUbiquitousItemDownloadingErrorKey
  
  Ошибочный объект, указывающий почему, загружая элемент с отказавшего iCloud. Посмотрите Ссылку Констант Основы для возможных кодов ошибки.
  
  Доступный в OS X v10.9 и позже.
- NSURLUbiquitousItemDownloadingStatusKey
  
  NSURLUbiquitousItemDownloadingStatusKey
  
  Текущая загрузка утверждает для элемента, указывая, существует ли локальная копия и является ли та копия самой актуальной версией элемента. Возможные значения для этого ключа описаны в Повсеместных Константах Состояния Загрузки Элемента.
  
  Доступный в OS X v10.9 и позже.
- NSURLUbiquitousItemHasUnresolvedConflictsKey
  
  NSURLUbiquitousItemHasUnresolvedConflictsKey
  
  Булевская переменная NSNumber это содержит true если этот элемент имеет выдающиеся конфликты, false иначе (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLUbiquitousItemIsDownloadedKey
  
  NSURLUbiquitousItemIsDownloadedKey
  
  Булевская переменная NSNumber это содержит true если данные этого элемента были загружены на контейнер повсеместности, false иначе (только для чтения).
  
  Доступный в OS X v10.7 и позже.
  Осуждаемый в OS X v10.9.
- NSURLUbiquitousItemIsDownloadingKey
  
  NSURLUbiquitousItemIsDownloadingKey
  
  Булевская переменная NSNumber это содержит true если этот элемент загружается с iCloud, false иначе (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLUbiquitousItemIsUploadedKey
  
  NSURLUbiquitousItemIsUploadedKey
  
  Булевская переменная NSNumber это содержит true если данные этого элемента были загружены на хранение iCloud, false иначе (только для чтения).
  
  Примечание:
  
  При ожидании загрузки для завершения не опрашивайте этот ключ из блока, переданного coordinateReadingItemAtURL:options:error:byAccessor:, потому что скоординированное чтение, требуемое получить это значение, не может быть выполнено, пока тот блок не завершается и возвращается. Вместо этого используйте NSMetadataQuery или NSFilePresenter делегируйте для асинхронного уведомления приложения, когда изменится состояние.
  
  Доступный в OS X v10.7 и позже.
- NSURLUbiquitousItemIsUploadingKey
  
  NSURLUbiquitousItemIsUploadingKey
  
  Булевская переменная NSNumber это содержит true если этот элемент загружается на iCloud, false иначе (только для чтения).
  
  Доступный в OS X v10.7 и позже.
- NSURLUbiquitousItemPercentDownloadedKey
  
  NSURLUbiquitousItemPercentDownloadedKey
  
  NSNumber в диапазоне 0–100 это указывает процент данных, загруженных (только для чтения).
  
  Осуждаемый. Вместо этого используйте ключ свойства NSMetadataUbiquitousItemPercentDownloadedKey из NSMetadataQuery класс для получения информации о NSMetadataItem объект.
  
  Доступный в OS X v10.7 и позже.
  Осуждаемый в OS X v10.8.
- NSURLUbiquitousItemPercentUploadedKey
  
  NSURLUbiquitousItemPercentUploadedKey
  
  NSNumber в диапазоне 0–100 это указывает процент данных, загруженных (только для чтения).
  
  Осуждаемый. Вместо этого используйте ключ свойства NSMetadataUbiquitousItemPercentUploadedKey из NSMetadataQuery класс для получения информации о NSMetadataItem объект.
  
  Доступный в OS X v10.7 и позже.
  Осуждаемый в OS X v10.8.
- NSURLUbiquitousItemUploadingErrorKey
  
  NSURLUbiquitousItemUploadingErrorKey
  
  Ошибочный объект, указывающий почему, загружая элемент на отказавший iCloud. Посмотрите Ссылку Констант Основы для возможных кодов ошибки.
  
  Доступный в OS X v10.9 и позже.
Обсуждение

Для запроса информации о состоянии хранения iCloud элемента передайте один из этих ключей к forKey: параметр getResourceValue:forKey:error: метод экземпляра.
Повсеместные константы состояния загрузки элемента
Значения, описывающие состояние хранения iCloud файла.

Объявление

Swift

let NSURLUbiquitousItemDownloadingStatusCurrent: NSString! let NSURLUbiquitousItemDownloadingStatusDownloaded: NSString! let NSURLUbiquitousItemDownloadingStatusNotDownloaded: NSString!

Objective C

NSString * const NSURLUbiquitousItemDownloadingStatusCurrent; NSString * const NSURLUbiquitousItemDownloadingStatusDownloaded; NSString * const NSURLUbiquitousItemDownloadingStatusNotDownloaded;

Константы
- NSURLUbiquitousItemDownloadingStatusCurrent
  
  NSURLUbiquitousItemDownloadingStatusCurrent
  
  Локальная копия этого элемента существует и является самой актуальной версией, известной устройству.
  
  Доступный в OS X v10.9 и позже.
- NSURLUbiquitousItemDownloadingStatusDownloaded
  
  NSURLUbiquitousItemDownloadingStatusDownloaded
  
  Локальная копия этого элемента существует, но это является устаревшим. Как можно скорее будет загружена новая версия.
  
  Доступный в OS X v10.9 и позже.
- NSURLUbiquitousItemDownloadingStatusNotDownloaded
  
  NSURLUbiquitousItemDownloadingStatusNotDownloaded
  
  Этот элемент еще не был загружен. Использовать startDownloadingUbiquitousItemAtURL:error: загружать его.
  
  Доступный в OS X v10.9 и позже.
Обсуждение

Эти константы являются возможными значениями для NSURLUbiquitousItemDownloadingStatusKey ключ.