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

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

Разработчик

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

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

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

NSURL

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


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


Swift

import Foundation

Objective C

@import Foundation;

Доступность


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

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.

  • // 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];
  • Инициализирует недавно создаваемый 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

    Доступность

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

  • Создает и возвращает объект 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;

    Доступность

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

  • Инициализирует объект 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.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    URLWithString:

  • Создает и возвращает объект 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 папки как основного пути (с запаздывающей наклонной чертой) и имя файла как строковая часть.

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в iOS 2.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.

    Обсуждение

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

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Инициализирует и возвращает недавно создаваемый объект 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

    Доступность

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

    См. также

    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

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

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

    isDir

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

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

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    fileURLWithPath:

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    path

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

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

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

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

    Обсуждение

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    initFileURLWithPath:

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

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

    Объявление

    Swift

    init?(fileURLWithPath path: String)

    Objective C

    - (instancetype)initFileURLWithPath:(NSString *)path

    Параметры

    path

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

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

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

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

    Обсуждение

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

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    fileURLWithPath:

  • Инициализирует и возвращает недавно создаваемый объект 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

    Доступность

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

  • Возвращает новый 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

    Доступность

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

  • Возвращает новый 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.

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

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

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в iOS 5.0 и позже. (Символ присутствует в iOS 4, но не выполняет работы.)

  • Инициализирует недавно создаваемый 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

    Доступность

    Доступный в iOS 5.0 и позже. (Символ присутствует в iOS 4, но не выполняет работы.)

  • Возвращает новый объект 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

    Доступность

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

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

    Объявление

    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

    Доступность

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

  • Инициализирует объект 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

    Доступность

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

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

    Объявление

    Objective C

    - (BOOL)isEqual:(id)anObject

    Параметры

    anObject

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

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

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

    Обсуждение

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

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

    Объявление

    Swift

    func checkResourceIsReachableAndReturnError(_ error: NSErrorPointer) -> Bool

    Objective C

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

    Параметры

    error

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

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

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

    Обсуждение

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

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 5.0 и позже. (Символ присутствует в iOS 4, но не выполняет работы.)

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

    Объявление

    Swift

    func isFileReferenceURL() -> Bool

    Objective C

    - (BOOL)isFileReferenceURL

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 5.0 и позже. (Символ присутствует в iOS 4, но не выполняет работы.)

  • 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

    Доступность

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

  • absoluteString Свойство

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

    Объявление

    Swift

    var absoluteString: String? { get }

    Objective C

    @property(readonly, copy) NSString *absoluteString

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • 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

    Доступность

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

  • 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

    Доступность

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

  • 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

    Доступность

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

  • fragment Свойство

    Идентификатор фрагмента, приспосабливая 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

    Доступность

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

  • host Свойство

    Узел, приспосабливая 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

    Доступность

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

  • 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

    Доступность

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

  • 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

    Доступность

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

  • password Свойство

    Пароль, соответствующий 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

    Доступность

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

  • path Свойство

    Путь, приспосабливая 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

    Доступность

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

  • 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

    Доступность

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

  • 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

    Доступность

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

  • port Свойство

    Порт, приспосабливая 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

    Доступность

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

  • query Свойство

    Строка запроса, приспосабливая 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

    Доступность

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

  • 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

    Доступность

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

  • relativeString Свойство

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

    Объявление

    Swift

    var relativeString: String? { get }

    Objective C

    @property(readonly, copy) NSString *relativeString

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • 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

    Доступность

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

  • scheme Свойство

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

    Объявление

    Swift

    var scheme: String? { get }

    Objective C

    @property(readonly, copy) NSString *scheme

    Обсуждение

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • 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

    Доступность

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

  • user Свойство

    Имя пользователя, приспосабливая 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

    Доступность

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

  • 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

    Доступность

    Доступный в iOS 5.0 и позже. (Символ присутствует в iOS 4, но не выполняет работы.)

  • Возвращает новую ссылку на файл 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.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 5.0 и позже. (Символ присутствует в iOS 4, но не выполняет работы.)

  • Возвращает новый 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

    Доступность

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

  • Если компонент определяется каталог, возвращает новый 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 добавленный.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает новый 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

    Доступность

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

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

    Объявление

    Swift

    @NSCopying var URLByDeletingLastPathComponent: NSURL? { get }

    Objective C

    @property(readonly, copy) NSURL *URLByDeletingLastPathComponent

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • URLByDeletingPathExtension Свойство

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

    Объявление

    Swift

    @NSCopying var URLByDeletingPathExtension: NSURL? { get }

    Objective C

    @property(readonly, copy) NSURL *URLByDeletingPathExtension

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • 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

    Доступность

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

  • 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

    Доступность

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

  • Инициализирует и возвращает данные закладки, полученные из файла псевдонима, на который указывает указанный 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

    Доступность

    Доступный в iOS 5.0 и позже. (Символ присутствует в iOS 4, но не выполняет работы.)

  • Возвращает закладку для 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

    Доступность

    Доступный в iOS 5.0 и позже. (Символ присутствует в iOS 4, но не выполняет работы.)

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

    Объявление

    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

    Доступность

    Доступный в iOS 5.0 и позже. (Символ присутствует в iOS 4, но не выполняет работы.)

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

    Объявление

    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

    Доступность

    Доступный в iOS 5.0 и позже. (Символ присутствует в iOS 4, но не выполняет работы.)

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

    Объявление

    Swift

    func startAccessingSecurityScopedResource() -> Bool

    Objective C

    - (BOOL)startAccessingSecurityScopedResource

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

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

    Обсуждение

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    func stopAccessingSecurityScopedResource()

    Objective C

    - (void)stopAccessingSecurityScopedResource

    Обсуждение

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    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

    Доступность

    Доступный в iOS 5.0 и позже. (Символ присутствует в iOS 4, но не выполняет работы.)

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

    Объявление

    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

    Доступность

    Доступный в iOS 5.0 и позже. (Символ присутствует в iOS 4, но не выполняет работы.)

  • Устанавливает свойство ресурса 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

    Доступность

    Доступный в iOS 5.0 и позже. (Символ присутствует в iOS 4, но не выполняет работы.)

  • Устанавливает свойства ресурса 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

    Доступность

    Доступный в iOS 5.0 и позже. (Символ присутствует в iOS 4, но не выполняет работы.)

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

    Объявление

    Swift

    func removeAllCachedResourceValues()

    Objective C

    - (void)removeAllCachedResourceValues

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    func removeCachedResourceValueForKey(_ key: String)

    Objective C

    - (void)removeCachedResourceValueForKey:(NSString *)key

    Параметры

    key

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

    Обсуждение

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Устанавливает временное значение ресурса на объекте 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

    Доступность

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

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

    Объявление

    Swift

    func checkPromisedItemIsReachableAndReturnError(_ error: NSErrorPointer) -> Bool

    Objective C

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

    Параметры

    error

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

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

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

    Обсуждение

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    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, включая:

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    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, включая:

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Типы данных

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

    Объявление

    Swift

    typealias NSURLBookmarkFileCreationOptions = Int

    Objective C

    typedef NSUInteger NSURLBookmarkFileCreationOptions;

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

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

    Объявление

    Swift

    let NSURLFileScheme: String

    Objective C

    NSString * const NSURLFileScheme;

    Константы

    • NSURLFileScheme

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

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

    Обсуждение

    Для получения дополнительной информации см. initWithScheme:host:path:.

  • Ключи, применяющиеся к файловой системе URLs.

    Объявление

    Swift

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

    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 NSURLThumbnailDictionaryKey NSString * const NSURLTypeIdentifierKey; NSString * const NSURLVolumeIdentifierKey; NSString * const NSURLVolumeURLKey;

    Константы

    • NSURLAddedToDirectoryDateKey

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

      Доступный в OS X v10.10 и iOS 8.0.

    • NSURLAttributeModificationDateKey

      Время, в которое были последний раз изменены атрибуты ресурса, возвратилось как NSDate возразите, поддерживает ли объем даты модификации атрибута, или nil если даты модификации атрибута не поддерживаются (чтение-запись).

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

    • NSURLContentAccessDateKey

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

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

    • NSURLContentModificationDateKey

      Время, в которое был последний раз изменен ресурс, возвратилось как NSDate возразите, поддерживает ли объем даты модификации, или nil если даты модификации не поддерживаются (чтение-запись).

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

    • NSURLCreationDateKey

      Дата создания ресурса, возвращенная как NSDate возразите, поддерживает ли объем даты создания, или nil если даты создания не поддерживаются (чтение-запись).

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

    • NSURLCustomIconKey

      Значок, сохраненный ресурсом, возвращенным как NSImage объект, или nil если ресурс не имеет никакого пользовательского значка.

      Не доступный в iOS; символ присутствует, но не выполняет работы.

    • NSURLDocumentIdentifierKey

      Идентификатор документа возвратился как NSNumber (только для чтения).

      Идентификатор документа является значением, присвоенным ядром файлу или каталогу. Это значение используется для идентификации документа независимо от того, куда это перемещено в объем. Идентификатор сохраняется через системные перезапуски. Это не передается, когда файл копируется, но это остается в силе «после безопасного сохранения” операции. Например, это остается на пути, которому это было присвоено, даже после вызова replaceItemAtURL:withItemAtURL:backupItemName:options:resultingItemURL:error: метод. Идентификаторы документа только уникальны в единственном объеме. Это свойство не поддерживается всеми объемами.

      Доступный в OS X v10.10 и iOS 8.0.

    • NSURLEffectiveIconKey

      Нормальный значок ресурса, возвращенный как NSImage объект (только для чтения).

      Не доступный в iOS; символ присутствует, но не выполняет работы.

    • NSURLFileResourceIdentifierKey

      Уникальный идентификатор ресурса, возвращенный как id (только для чтения).

      Этот идентификатор может использоваться для определения равенства между ресурсами файловой системы с isEqual: метод. Два ресурса равны, если у них есть тот же путь файловой системы или если их пути соединяются с тем же inode в той же файловой системе.

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

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

    • NSURLFileResourceTypeKey

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

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

    • NSURLFileSecurityKey

      Информация о безопасности ресурса, возвращенная как NSFileSecurity объект (чтение-запись).

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

    • NSURLGenerationIdentifierKey

      Непрозрачный идентификатор генерации, возвращенный как id <NSCopying, NSCoding, NSObject> (только для чтения)

      Идентификатор генерации может быть сравнен с помощью isEqual: определить, были ли изменены данные в документе. Для URLs, относящегося к тому же файлу inode, изменения идентификатора генерации, когда изменяются данные в ветви данных файла. Изменения в расширенных атрибутах или других метаданных файловой системы не изменяют идентификатор. Для URLs, обращающегося к тому же каталогу inode, изменения идентификатора генерации, когда прямые дочерние элементы того каталога добавлены, удалены или переименованы. Изменения в данных прямых дочерних элементов того каталога не изменяют идентификатор генерации. Идентификатор сохраняется через системные перезапуски. Когда документ копируется в другой объем, это связывается к определенному документу об удельном объеме и не передается. Это свойство не поддерживается всеми объемами.

      Доступный в OS X v10.10 и iOS 8.0.

    • NSURLHasHiddenExtensionKey

      Ключ для определения, удаляется ли расширение ресурса обычно из его локализованного имени, возвратился как булевская переменная NSNumber объект (чтение-запись).

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

    • NSURLIsDirectoryKey

      Ключ для определения, является ли ресурс каталогом, возвратился как булевская переменная NSNumber объект (только для чтения).

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

    • NSURLIsExcludedFromBackupKey

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

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

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

    • NSURLIsExecutableKey

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

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

    • NSURLIsHiddenKey

      Ключ для определения, не выводится ли ресурс обычно на экран пользователям, возвратился как булевская переменная NSNumber объект (чтение-запись).

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

    • NSURLIsMountTriggerKey

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

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

    • NSURLIsPackageKey

      Ключ для определения, является ли ресурс пакетом файла, возвратился как булевская переменная NSNumber объект (чтение-запись в OS X v10.8 и позже, только для чтения в предыдущих версиях). A true оцените означает, что ресурс является пакетом файла.

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

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

    • NSURLIsReadableKey

      Ключ для определения, может ли текущий процесс (как определено EUID) считать ресурс, возвратился как булевская переменная NSNumber объект (только для чтения).

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

    • NSURLIsRegularFileKey

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

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

    • NSURLIsSymbolicLinkKey

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

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

    • NSURLIsSystemImmutableKey

      Ключ для определения, установлена ли система ресурса неизменный бит, возвратился как булевская переменная NSNumber объект (чтение-запись).

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

    • NSURLIsUserImmutableKey

      Ключ для определения, установлен ли пользователь ресурса неизменный бит, возвратился как булевская переменная NSNumber объект (чтение-запись).

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

    • NSURLIsVolumeKey

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

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

    • NSURLIsWritableKey

      Ключ для определения, может ли текущий процесс (как определено EUID) записать в ресурс, возвратился как булевская переменная NSNumber объект (только для чтения).

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

    • NSURLLabelColorKey

      Цвет метки ресурса, возвращенный как NSColor объект, или nil если ресурс не имеет никакого цвета метки (только для чтения).

      Не доступный в iOS; символ присутствует, но не выполняет работы.

    • NSURLLabelNumberKey

      Номер метки ресурса, возвращенный как NSNumber объект (чтение-запись).

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

    • NSURLLinkCountKey

      Число жестких ссылок на ресурс, возвращенный как NSNumber объект (только для чтения).

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

    • NSURLLocalizedLabelKey

      Локализованный текст метки ресурса, возвращенный как NSString объект, или nil если ресурс не имеет никакого локализованного текста метки (только для чтения).

      Не доступный в iOS; символ присутствует, но не выполняет работы.

    • NSURLLocalizedNameKey

      Локализованное или скрытое от расширения имя ресурса, возвращенное как NSString объект (только для чтения).

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

    • NSURLLocalizedTypeDescriptionKey

      Локализованное описание типа ресурса, возвращенное как NSString объект (только для чтения).

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

    • NSURLNameKey

      Имя ресурса в файловой системе, возвращенной как NSString объект (чтение-запись).

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

    • NSURLParentDirectoryURLKey

      Родительский каталог ресурса, возвращенного как NSURL объект, или nil если ресурс является корневым каталогом своего объема (только для чтения).

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

    • NSURLPathKey

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

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

    • NSURLPreferredIOBlockSizeKey

      Оптимальный размер блока для использования при чтении или записи данных этого файла, возвратился как NSNumber объект, или nil если предпочтительный размер не доступен (только для чтения).

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

    • NSURLThumbnailDictionaryKey

      Словарь объектов NSImage/UIImage, включенных размером (чтение-запись). Посмотрите Ключи Свойства Миниатюры для списка возможных ключей.

      Доступный в OS X v10.10 и iOS 8.0.

    • NSURLTypeIdentifierKey

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

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

    • NSURLVolumeIdentifierKey

      Уникальный идентификатор объема ресурса, возвращенного как id (только для чтения).

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

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

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

    • NSURLVolumeURLKey

      Корневой каталог объема ресурса, возвращенного как NSURL объект (только для чтения).

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

    Обсуждение

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

  • Возможные значения для NSURLFileResourceTypeKey ключ.

    Объявление

    Swift

    let NSURLFileResourceTypeNamedPipe: String let NSURLFileResourceTypeCharacterSpecial: String let NSURLFileResourceTypeDirectory: String let NSURLFileResourceTypeBlockSpecial: String let NSURLFileResourceTypeRegular: String let NSURLFileResourceTypeSymbolicLink: String let NSURLFileResourceTypeSocket: String let NSURLFileResourceTypeUnknown: String

    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

      Ресурс является именованным каналом.

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

    • NSURLFileResourceTypeCharacterSpecial

      Ресурс является символьным специальным файлом.

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

    • NSURLFileResourceTypeDirectory

      Ресурс является каталогом.

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

    • NSURLFileResourceTypeBlockSpecial

      Ресурс является блоком специальный файл.

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

    • NSURLFileResourceTypeRegular

      Ресурс является регулярным файлом.

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

    • NSURLFileResourceTypeSymbolicLink

      Ресурс является символьной ссылкой.

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

    • NSURLFileResourceTypeSocket

      Ресурс является сокетом.

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

    • NSURLFileResourceTypeUnknown

      Тип ресурса неизвестен.

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

  • Возможные ключи для NSURLThumbnailDictionaryKey словарь.

    Объявление

    Swift

    let NSThumbnail1024x1024SizeKey: String

    Objective C

    NSString * const NSThumbnail1024x1024SizeKey

    Константы

    • NSThumbnail1024x1024SizeKey

      Миниатюра на 1024 x 1 024 пикселя как a UIImage на iOS или NSImage на OS X.

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

  • Ключи, применяющиеся к свойствам файлов.

    Объявление

    Swift

    let NSURLFileSizeKey: String let NSURLFileAllocatedSizeKey: String let NSURLTotalFileSizeKey: String let NSURLTotalFileAllocatedSizeKey: String let NSURLIsAliasFileKey: String

    Objective C

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

    Константы

    • NSURLFileSizeKey

      Ключ для размера файла в байтах, возвращенных как NSNumber объект (только для чтения).

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

    • NSURLFileAllocatedSizeKey

      Ключ для общего размера, выделенного на диске для файла, возвращенного как NSNumber объект (только для чтения).

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

    • NSURLTotalFileSizeKey

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

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

    • NSURLTotalFileAllocatedSizeKey

      Ключ для общего выделенного размера файла в байтах, возвращенных как NSNumber объект (только для чтения). Это включает размер любых метаданных файла.

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

    • NSURLIsAliasFileKey

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

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

  • Ключи, применяющиеся к объемам.

    Объявление

    Swift

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

    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

      Ключ для дескриптивного имени формата объема, возвращенного как NSString объект (только для чтения).

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

    • NSURLVolumeTotalCapacityKey

      Ключ для способности объема в байтах, возвращенных как NSNumber объект (только для чтения).

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

    • NSURLVolumeAvailableCapacityKey

      Ключ для полезной мощности объема в байтах, возвращенных как NSNumber объект (только для чтения).

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

    • NSURLVolumeResourceCountKey

      Ключ для общего количества ресурсов на объеме, возвращенном как NSNumber объект (только для чтения).

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

    • NSURLVolumeSupportsPersistentIDsKey

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

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

    • NSURLVolumeSupportsSymbolicLinksKey

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

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

    • NSURLVolumeSupportsHardLinksKey

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

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

    • NSURLVolumeSupportsJournalingKey

      Ключ для определения, поддерживает ли объем журналирование, возвратился как булевская переменная NSNumber объект (только для чтения).

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

    • NSURLVolumeIsJournalingKey

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

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

    • NSURLVolumeSupportsSparseFilesKey

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

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

    • NSURLVolumeSupportsZeroRunsKey

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

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

    • NSURLVolumeSupportsCaseSensitiveNamesKey

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

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

    • NSURLVolumeSupportsCasePreservedNamesKey

      Ключ для определения, поддерживает ли объем сохраненные случаем имена, возвратился как булевская переменная NSNumber объект (только для чтения).

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

    • NSURLVolumeSupportsRootDirectoryDatesKey

      Ключ для определения, поддерживает ли объем надежное хранение времен для корневого каталога, возвратился как булевская переменная NSNumber объект (только для чтения).

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

    • NSURLVolumeSupportsVolumeSizesKey

      Ключ для определения, ли поддержки объема, возвращая информацию о размере тома, возвращенную как булевская переменная NSNumber объект (только для чтения). Если true, информация о размере тома доступна как значения NSURLVolumeTotalCapacityKey иNSURLVolumeAvailableCapacityKey ключи.

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

    • NSURLVolumeSupportsRenamingKey

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

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

    • NSURLVolumeSupportsAdvisoryFileLockingKey

      Ключ для определения, реализует ли объем консультацию целого файла, привязывает стиль flock, вместе с O_EXLOCK и O_SHLOCK флаги open функция, возвращенная как булевская переменная NSNumber объект (только для чтения).

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

    • NSURLVolumeSupportsExtendedSecurityKey

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

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

    • NSURLVolumeIsBrowsableKey

      Ключ для определения, видим ли объем в основанных на GUI просматривающих файл средах, таков как Рабочий стол или приложение Средства поиска, возвратился как булевская переменная NSNumber объект (только для чтения).

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

    • NSURLVolumeMaximumFileSizeKey

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

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

    • NSURLVolumeIsEjectableKey

      Ключ для определения, является ли объем выбрасываемым от механизма диска при программном управлении, возвратился как булевская переменная NSNumber объект (только для чтения).

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

    • NSURLVolumeIsRemovableKey

      Ключ для определения, является ли объем съемным от механизма диска, возвратился как булевская переменная NSNumber объект (только для чтения).

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

    • NSURLVolumeIsInternalKey

      Ключ для определения, подключен ли объем к внутренней шине, возвратился как булевская переменная NSNumber объект, или nil если это не может быть определено (только для чтения).

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

    • NSURLVolumeIsAutomountedKey

      Ключ для определения, автосмонтирован ли объем, возвратился как булевская переменная NSNumber объект (только для чтения).

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

    • NSURLVolumeIsLocalKey

      Ключ для определения, сохранен ли объем на локальном устройстве, возвратился как булевская переменная NSNumber объект (только для чтения).

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

    • NSURLVolumeIsReadOnlyKey

      Ключ для определения, только ли объем для чтения, возвратился как булевская переменная NSNumber объект (только для чтения).

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

    • NSURLVolumeCreationDateKey

      Ключ для даты создания объема, возвращенной как NSDate объект, или NULL если это не может быть определено (только для чтения).

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

    • NSURLVolumeURLForRemountingKey

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

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

    • NSURLVolumeUUIDStringKey

      Ключ для персистентного UUID объема, возвращенного как NSString объект, или nil если персистентный UUID не доступен (только для чтения).

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

    • NSURLVolumeNameKey

      Имя объема, возвращенного как NSString объект (чтение-запись). Устанавливаемый, только если NSURLVolumeSupportsRenamingKey YEStrue.

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

    • NSURLVolumeLocalizedNameKey

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

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

    Обсуждение

    Как удобство, значения свойств ресурса объема можно требовать от любой файловой системы 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 ), }; typedef NSUInteger NSURLBookmarkCreationOptions;

    Константы

    • NSURLBookmarkCreationPreferFileIDResolution

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

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

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

    • MinimalBookmark

      NSURLBookmarkCreationMinimalBookmark

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

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

    • SuitableForBookmarkFile

      NSURLBookmarkCreationSuitableForBookmarkFile

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

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Опции, используемые при разрешении данных закладки.

    Объявление

    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 ), }; typedef NSUInteger NSURLBookmarkResolutionOptions;

    Константы

    • WithoutUI

      NSURLBookmarkResolutionWithoutUI

      Указывает, что никакая обратная связь UI не должна сопровождать разрешение данных закладки.

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

    • WithoutMounting

      NSURLBookmarkResolutionWithoutMounting

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

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

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Ключи в userInfo словаре NSError возразите, когда бесспорный, что методы NSURL возвращают ошибку.

    Объявление

    Swift

    let NSURLKeysOfUnsetValuesKey: String

    Objective C

    NSString * const NSURLKeysOfUnsetValuesKey;

    Константы

    • NSURLKeysOfUnsetValuesKey

      Ключ для свойств ресурса, не установленных после setResourceValues:error: метод возвращает ошибку, возвращенную как массив NSString объекты.

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

  • Ключи, описывающие состояние хранения iCloud файла.

    Объявление

    Swift

    let NSURLIsUbiquitousItemKey: String let NSURLUbiquitousItemDownloadingErrorKey: String let NSURLUbiquitousItemDownloadingStatusKey: String let NSURLUbiquitousItemHasUnresolvedConflictsKey: String let NSURLUbiquitousItemIsDownloadingKey: String let NSURLUbiquitousItemIsUploadedKey: String let NSURLUbiquitousItemIsUploadingKey: String let NSURLUbiquitousItemUploadingErrorKey: String let NSURLUbiquitousItemDownloadRequestedKey: String let NSURLUbiquitousItemContainerDisplayNameKey: String

    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 NSURLUbiquitousItemUploadingErrorKey; NSString * const NSURLUbiquitousItemDownloadRequestedKey; NSString * const NSURLUbiquitousItemContainerDisplayNameKey; // Deprecated NSString * const NSURLUbiquitousItemPercentDownloadedKey; NSString * const NSURLUbiquitousItemPercentUploadedKey;

    Константы

    • NSURLIsUbiquitousItemKey

      Булевская переменная NSNumber это содержит true если этот элемент находится в хранении iCloud, false если это - локальный элемент (только для чтения).

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

    • NSURLUbiquitousItemDownloadingErrorKey

      Ошибочный объект, указывающий почему, загружая элемент с отказавшего iCloud. Посмотрите Ссылку Констант Основы для возможных кодов ошибки.

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

    • NSURLUbiquitousItemDownloadingStatusKey

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

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

    • NSURLUbiquitousItemHasUnresolvedConflictsKey

      Булевская переменная NSNumber это содержит true если этот элемент имеет выдающиеся конфликты, false иначе (только для чтения).

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

    • NSURLUbiquitousItemIsDownloadedKey

      Булевская переменная NSNumber это содержит true если данные этого элемента были загружены на контейнер повсеместности, false иначе (только для чтения).

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

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

    • NSURLUbiquitousItemIsDownloadingKey

      Булевская переменная NSNumber это содержит true если этот элемент загружается с iCloud, false иначе (только для чтения).

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

    • NSURLUbiquitousItemIsUploadedKey

      Булевская переменная NSNumber это содержит true если данные этого элемента были загружены на хранение iCloud, false иначе (только для чтения).

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

    • NSURLUbiquitousItemIsUploadingKey

      Булевская переменная NSNumber это содержит true если этот элемент загружается на iCloud, false иначе (только для чтения).

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

    • NSURLUbiquitousItemPercentDownloadedKey

      NSNumber в диапазоне 0–100 это указывает процент данных, загруженных (только для чтения).

      Используйте NSMetadataQuery класс поиска NSMetadataItem объекты, имеющие NSMetadataUbiquitousItemPercentDownloadedKey атрибут вместо этого.

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

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

    • NSURLUbiquitousItemPercentUploadedKey

      NSNumber в диапазоне 0–100 это указывает процент данных, загруженных (только для чтения).

      Используйте NSMetadataQuery класс поиска NSMetadataItem объекты, имеющие NSMetadataUbiquitousItemPercentUploadedKey атрибут вместо этого.

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

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

    • NSURLUbiquitousItemUploadingErrorKey

      Ошибочный объект, указывающий почему, загружая элемент на отказавший iCloud. Посмотрите Ссылку Констант Основы для возможных кодов ошибки.

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

    • NSURLUbiquitousItemDownloadRequestedKey

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

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

    • NSURLUbiquitousItemContainerDisplayNameKey

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

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

    Обсуждение

    Для запроса информации о состоянии хранения iCloud элемента передайте один из этих ключей к forKey: параметр getResourceValue:forKey:error: метод экземпляра.

  • Значения, описывающие состояние хранения iCloud файла.

    Объявление

    Swift

    let NSURLUbiquitousItemDownloadingStatusCurrent: String let NSURLUbiquitousItemDownloadingStatusDownloaded: String let NSURLUbiquitousItemDownloadingStatusNotDownloaded: String

    Objective C

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

    Константы

    • NSURLUbiquitousItemDownloadingStatusCurrent

      Локальная копия этого элемента существует и является самой актуальной версией, известной устройству.

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

    • NSURLUbiquitousItemDownloadingStatusDownloaded

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

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

    • NSURLUbiquitousItemDownloadingStatusNotDownloaded

      Этот элемент еще не был загружен. Использовать startDownloadingUbiquitousItemAtURL:error: загружать его.

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

    Обсуждение

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