Instance Method インスタンスメソッド

item(at:willMoveTo:)

Announces that your app is moving a file to a new URL. あなたのアプリがあるファイルを新しいURLに移動するところであるのを告知します。

Declaration 宣言 

func item(at oldURL: URL, 
willMoveTo newURL: URL)

Parameters パラメータ

oldURL

The old location of the file or directory. ファイルまたはディレクトリの古い位置。

newURL

The new location of the file or directory. ファイルまたはディレクトリの新しい位置。

Discussion 議論

This method is intended for apps that adopt App Sandbox. このメソッドは、App Sandboxを採用するアプリに対して意図されるものです。

Some apps need to rename files while saving them. For example, when a user adds an attachment to a rich text document, TextEdit changes the document’s filename extension from .rtf to .rtfd. In such a case, in a sandboxed app, you must call this method to declare your intent to rename a file without user approval. いくつかのアプリは、ファイルの名前を変更し、と同時にそれを保存することが必要です。例えば、ユーザが添付書類をリッチテキスト書類に加える場合、TextEditはその書類のファイル名拡張子を.rtfから.rtfdへ変更します。その場合には、サンドボックス化アプリでは、あなたはこのメソッドを呼び出して、あなたの意図を宣言して、ファイルをユーザ承認なしに名前変更する必要があります。

After the renaming process succeeds, call the item(at:didMoveTo:) method, with the same arguments, to provide your app with continued access to the file under its new name, while also giving up access to any file that appears with the old name. 名前変更処理がうまくいった後、item(at:didMoveTo:)メソッドを、同じ引数で呼び出して、あなたのアプリにそのファイルへの継続したアクセスをその新しい名前の下で提供してください、同時にまた古い名前で存在するどんなファイルへのアクセスも断念してください。

If your macOS app is not sandboxed, this method serves no purpose. This method is nonfunctional in iOS. あなたのmacOSアプリがサンドボックス化されないならば、このメソッドは用をなしません。このメソッドは、iOSでは機能しません。

See Also 参照

Coordinating File Operations Synchronously ファイル操作を同期的に協調させる（コーディネートする）

func coordinate(readingItemAt: URL, options: NSFileCoordinator.ReadingOptions, error: NSErrorPointer, byAccessor: (URL) -> Void)
Initiates a read operation on a single file or directory using the specified options. 読み出し演算をある単一のファイルまたはディレクトリ上でこの指定されたオプションを使って開始します。
func coordinate(writingItemAt: URL, options: NSFileCoordinator.WritingOptions, error: NSErrorPointer, byAccessor: (URL) -> Void)
Initiates a write operation on a single file or directory using the specified options. 書き込み演算をある単一のファイルまたはディレクトリ上でこの指定されたオプションを使って開始します。
func coordinate(readingItemAt: URL, options: NSFileCoordinator.ReadingOptions, writingItemAt: URL, options: NSFileCoordinator.WritingOptions, error: NSErrorPointer, byAccessor: (URL, URL) -> Void)
Initiates a read operation that contains a follow-up write operation. 読み出し演算を開始します、それは追記的書き込み演算を含みます。
func coordinate(writingItemAt: URL, options: NSFileCoordinator.WritingOptions, writingItemAt: URL, options: NSFileCoordinator.WritingOptions, error: NSErrorPointer, byAccessor: (URL, URL) -> Void)
Initiates a write operation that involves a secondary write operation. 書き込み演算を開始します、それは副次的書き込み演算を伴います。
func prepare(forReadingItemsAt: [URL], options: NSFileCoordinator.ReadingOptions, writingItemsAt: [URL], options: NSFileCoordinator.WritingOptions, error: NSErrorPointer, byAccessor: (() -> Void) -> Void)
Prepare to read or write from multiple files in a single batch operation. 複数のファイルからある単一のバッチ演算で読み出しまたは書き込みを準備します。
func item(at: URL, didMoveTo: URL)
Notifies relevant file presenters that the location of a file or directory changed. あるファイルまたはディレクトリの場所が変更されたことを関連のあるファイルプレゼンタそれらに通知します。
func cancel()
Cancels any active file coordination calls. 何らかの現行のファイル協調呼び出しをキャンセルします。