promisedItemResourceValues(forKeys:)

func promisedItemResourceValues(forKeys keys: Set<URLResourceKey>) throws -> URLResourceValues

Discussion 議論

A promised item is not guaranteed to have its contents in the file system until you use FileCoordinator to perform a coordinated read on its URL, which causes the contents to be downloaded or otherwise generated. Promised item URLs are returned by various APIs, including currently: NSMetadataQueryUbiquitousDataScope NSMetadataQueryUbiquitousDocumentsScope A FilePresenter presenting the contents of the directory located by -URLForUbiquitousContainerIdentifier: or a subdirectory thereof プロミス項目は、それの内容をファイルシステムの中に持つことを保証されません、あなたがFileCoordinatorを使って協調読み込みをそれのURL上で実行するまでは、それはその内容がダウンロードされるかそうでなければ生成されることを引き起こします。プロミス項目URLは、様々なAPIによって返されます、現在は以下を含みます：NSMetadataQueryUbiquitousDataScope NSMetadataQueryUbiquitousDocumentsScope あるFilePresenterで-URLForUbiquitousContainerIdentifier: に位置するディレクトリまたはそれの下位ディレクトリの内容を表しているもの

The following methods behave identically to their similarly named methods above (func resourceValues(forKeys:), etc.), except that they allow you to get resource values and check for presence regardless of whether the promised item’s contents currently exist at the URL. You must use these APIs instead of the normal URL resource value APIs if and only if any of the following are true: You are using a URL that you know came directly from one of the above APIs You are inside the accessor block of a coordinated read or write that used NSFileCoordinatorReadingImmediatelyAvailableMetadataOnly, NSFileCoordinatorWritingForDeleting, NSFileCoordinatorWritingForMoving, or NSFileCoordinatorWritingContentIndependentMetadataOnly 以下のメソッドは、上のそれに似た名前のメソッド（func resourceValues(forKeys:)、など）とまったく同一に振る舞います、しかしそれらがあなたにリソース値を取得させてそしてプロミス項目のもつ内容が現在そのURLで実在するかどうかに関係なく存在を調べさせることを除きます。あなたは、これらAPIを通常のURLリソース値APIの代わりに使います、以下が真でありかつその場合に限り：あなたは上のAPIの１つから直接に来ることを知っているURLを使っている あなたはNSFileCoordinatorReadingImmediatelyAvailableMetadataOnly、NSFileCoordinatorWritingForDeleting、NSFileCoordinatorWritingForMoving、またはNSFileCoordinatorWritingContentIndependentMetadataOnlyを使った協調読み込みまたは書き込みのアクセッサブロックの内側にいる

Most of the URL resource value keys will work with these APIs. However, there are some that are tied to the item’s contents that will not work, such as contentAccessDateKey or generationIdentifierKey. If one of these keys is used, the method will return a URLResourceValues value, but the value for that property will be nil. URLリソース値キーのほとんどは、これらAPIで働くでしょう。しかしながら、項目のもつ内容に結びつけられるものがあります、それらは働かないでしょう、たとえばcontentAccessDateKeyまたはgenerationIdentifierKey。これらキーの１つが使われるならば、メソッドは URLResourceValues値を返します、しかしそのプロパティに対する値はnilでしょう。