Type Method 型メソッド

URLByResolvingBookmarkData:options:relativeToURL:bookmarkDataIsStale:error:

Returns a new URL made by resolving bookmark data. ブックマークを解決することによって作られる新しいURLを返します。

Declaration 宣言 

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

Parameters パラメータ

bookmarkData

The bookmark data the URL is derived from. URLがそれから引き出されるブックマークデータ。

options オプション

Options taken into account when resolving the bookmark data. ブックマークデータを解決する時に考慮に入れるオプション。

To resolve a security-scoped bookmark to support App Sandbox, you must include (by way of bitwise OR operators with any other options in this parameter) the NSURLBookmarkResolutionWithSecurityScope option. 保安作用域ブックマークを解決してApp Sandboxをサポートするには、あなたは（このパラメータの中のあらゆる他のオプションとビット単位OR演算子というやり方で）NSURLBookmarkResolutionWithSecurityScopeオブションを含めなければなりません。

relativeURL

The base URL that the bookmark data is relative to. ブックマークデータがそれに相対的である基準URL。

If you are resolving a security-scoped bookmark to obtain a security-scoped URL, use this parameter as follows: あなたが保安作用域ブックマークを解決することである保安作用域URLを入手しているところならば、このパラメータを使ってください、次のように：

  • To resolve an app-scoped bookmark, use a value of nil. アプリ作用域ブックマークを解決するには、nilの値を使ってください。

  • To resolve a document-scoped bookmark, use the absolute path (despite this parameter’s name) to the document from which you retrieved the bookmark. 書類作用域ブックマークを解決するには、それからあなたがブックマークを回収した書類への絶対パスを（このパラメータの持つ名前にもかかわらず）使ってください。

App Sandbox does not restrict which URL values may be passed to this parameter. App Sandboxは、どのURL値がこのパラメータに渡されるかを制限しません。

isStale

On return, if YES, the bookmark data is stale. Your app should create a new bookmark using the returned URL and use it in place of any stored copies of the existing bookmark. 戻りでは、YESならば、ブックマークデータは失効しています。あなたのアプリは、新しいブックマークをその返されるURLを使って作成して、それを既存のブックマークのあらゆる格納されたコピーそれらの代わりに使うべきです。

error

The error that occurred in the case that the URL cannot be created. URLが作成されることができないという事情で発生したエラー。

Return Value 戻り値

A new URL made by resolving bookmarkData. bookmarkDataを解決することによって作られる新しいURL。

Discussion 議論

This method fails if the original file or directory could not be located or is on a volume that could not be mounted. If this method fails, you can use the resourceValuesForKeys:fromBookmarkData: method to obtain information about the bookmark, such as the last known path (NSURLPathKey) to help the user decide how to proceed. このメソッドは、元のファイルまたはディレクトリが位置を特定されることができないまたはマウントされることができないボリューム上にあるならば失敗します。このメソッドが失敗するならば、あなたはresourceValuesForKeys:fromBookmarkData:メソッドを使ってそのブックマークについての情報を入手して、例えば最後の知られるパス（NSURLPathKey）、どのように続行するかユーザが決定する助けとできます。

To obtain a security-scoped URL from a security-scoped bookmark, call this method using the NSURLBookmarkResolutionWithSecurityScope option. In addition, to use security scope, you must first have enabled the appropriate entitlements for your app, as described in Enabling Security-Scoped Bookmark and URL Access. 保安作用域URLを保安作用域ブックマークから入手するには、このメソッドをNSURLBookmarkResolutionWithSecurityScopeオブションを使って呼び出してください。加えて、保安作用域を使うには、あなたは最初にあなたのアプリに対する適切な資格付与を作動させなければなりません、Enabling Security-Scoped Bookmark and URL Accessで記述されるように。

To then obtain access to the file-system resource pointed to by a security-scoped URL (in other words, to bring the resource into your app’s sandbox), call the startAccessingSecurityScopedResource method (or its Core Foundation equivalent, the CFURLStartAccessingSecurityScopedResource function) on the URL. それから保安作用域URLによって指し示されるファイルシステムリソースへのアクセスを入手するには（言い換えれば、リソースをあなたのアプリの持つサンドボックスへと持って来るには）、startAccessingSecurityScopedResourceメソッド（またはそれのCore Foundation相当物、 CFURLStartAccessingSecurityScopedResource関数）をそのURL上で呼び出してください。

For an app-scoped bookmark, no sandboxed app other than the one that created the bookmark can obtain access to the file-system resource that the URL (obtained from the bookmark) points to. アプリ作用域ブックマークに対して、ブックマークを作成したものとは異なるサンドボックスアプリは、URL（ブックマークから得られた）が指し示すファイルシステムリソースに対するアクセスを獲得できません。

For a document-scoped bookmark, any sandboxed app that has access to the bookmark data itself, and has access to the document that owns the bookmark, can obtain access to the resource. 書類作用域ブックマークに対して、ブックマークデータへのアクセスを持つ、そしてブックマークを所有する書類へのアクセスを持つあらゆるサンドボックスアプリは、リソースへのアクセスを獲得できます。

See Also 参照

Creating an NSURL Object NSURLオブジェクトを作成する

+ URLWithString:
Creates and returns an NSURL object initialized with a provided URL string. 提供されたURL文字列で初期化されるNSURLを作成して返します。
- initWithString:
Initializes an NSURL object with a provided URL string. NSURLオブジェクトをある提供されたURL文字列で初期化します。
+ URLWithString:relativeToURL:
Creates and returns an NSURL object initialized with a base URL and a relative string. 基準URLと相対文字列でNSURLオブジェクトを作成して返します。
- initWithString:relativeToURL:
Initializes an NSURL object with a base URL and a relative string. NSURLオブジェクトをある基準URLと相対文字列で初期化します。
+ fileURLWithPath:isDirectory:
Initializes and returns a newly created NSURL object as a file URL with a specified path. 新しく作成されたNSURLオブジェクトをファイルURLとして初期化して返します、ある指定されたパスを持ちます。
- initFileURLWithPath:isDirectory:
Initializes a newly created NSURL referencing the local file or directory at path. 新しく作成されたNSURLを初期化します、pathでのローカルのファイルまたはディレクトリを参照しています。
+ fileURLWithPath:relativeToURL:
- initFileURLWithPath:relativeToURL:
+ fileURLWithPath:isDirectory:relativeToURL:
- initFileURLWithPath:isDirectory:relativeToURL:
+ fileURLWithPath:
Initializes and returns a newly created NSURL object as a file URL with a specified path. 新しく作成されたNSURLオブジェクトをファイルURLとして初期化して返します、ある指定されたパスを持ちます。
- initFileURLWithPath:
Initializes a newly created NSURL referencing the local file or directory at path. 新しく作成されたNSURLを初期化します、pathでのローカルのファイルまたはディレクトリを参照しています。
+ fileURLWithPathComponents:
Initializes and returns a newly created NSURL object as a file URL with specified path components. 新しく作成されたNSURLオブジェクトをファイルURLとして初期化して返します、指定されたパス構成要素いくらかを持ちます。
+ URLByResolvingAliasFileAtURL:options:error:
Returns a new URL made by resolving the alias file at url. 新しいURLを返します、urlでのエイリアスファイルを解決することによって作られます。
- initByResolvingBookmarkData:options:relativeToURL:bookmarkDataIsStale:error:
Initializes a newly created NSURL that points to a location specified by resolving bookmark data. 新しく作成されたNSURLを初期化します、それはブックマークデータを解決することによって指定されるある位置を指し示します。
+ fileURLWithFileSystemRepresentation:isDirectory:relativeToURL:
Returns a new URL object initialized with a C string representing a local file system path. 新しいURLオブジェクトを返します、あるローカルファイルシステムパスを表しているC文字列表現で初期化されます。
- getFileSystemRepresentation:maxLength:
Fills the provided buffer with a C string representing a local file system path. 提供されたバッファをあるローカルファイルシステムパスを表しているC文字列で満たします。
- initFileURLWithFileSystemRepresentation:isDirectory:relativeToURL:
Initializes a URL object with a C string representing a local file system path. URLオブジェクトをあるローカルファイルシステムパスを表しているC文字列で初期化します。
+ absoluteURLWithDataRepresentation:relativeToURL:
- initAbsoluteURLWithDataRepresentation:relativeToURL:
+ URLWithDataRepresentation:relativeToURL:
- initWithDataRepresentation:relativeToURL:
dataRepresentation

Related Documentation 関連文書

- bookmarkDataWithOptions:includingResourceValuesForKeys:relativeToURL:error:
Returns a bookmark for the URL, created with specified options and resource values. URLに対するブックマークを返します、指定されたオプションとリソース値で作成されます。