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

evictUbiquitousItemAtURL:error:

Removes the local copy of the specified item that’s stored in iCloud. iCloudに格納されるこの指定された項目のローカルコピーを除去します。

Declaration 宣言

- (BOOL)evictUbiquitousItemAtURL:(NSURL *)url 
                           error:(NSError * _Nullable *)error;

Parameters パラメータ

url

The URL to a file or directory in iCloud storage. iCloudストレージの中のファイルまたはディレクトリへのURL。

error

On input, a pointer to variable for an NSError object. If an error occurs, this pointer is set to an NSError object containing information about the error. You may specify nil to ignore the error information. 入力では、あるNSErrorオブジェクトに対する変数へのポインタ。エラーが発生するならば、このポインタはエラーについての情報を含んでいるNSErrorオブジェクトへと設定されます。あなたは、nilを指定して、エラー情報を無視するかもしれません。

Return Value 戻り値

YES if the local item was removed successfully or NO if it was not. If NO is returned and error is not nil, an NSError object describing the error is returned in that parameter. ローカルの項目がうまく除去されたならばYESまたはそれがそうでなかったならばNONOが返されるそしてerrornilでないならば、エラーを記述しているNSErrorオブジェクトがそのパラメータにおいて返されます。

Discussion 議論

Don’t use a coordinated write to perform this operation. In macOS 10.7 or earlier, the framework takes a coordinated write in its implementation of this method, so taking one in your app causes a deadlock. In macOS 10.8 and later, the framework detects coordination done by your app on the same thread as the call to this method, to avoid deadlocking. 協調書き込みを使ってこの演算を実行しないでください。macOS 10.7以前において、フレームワークは協調書き込みをこのメソッドのそれの実装において取ります、それであなたのアプリにおいてそれを取ることはデッドロックの原因となります。macOS 10.8以降では、フレームワークは、あなたのアプリによって同じスレッド上でこのメソッドに対する呼び出しとして行われる協調を検知します、デッドロックを避けるために。

This method doesn’t remove the item from iCloud. It removes only the local version. You can then use startDownloadingUbiquitousItemAtURL:error: to force iCloud to download a new version of the file or directory from the server. このメソッドは、項目をiCloudから取り除きません。それはローカル版だけを除去します。あなたはそれからstartDownloadingUbiquitousItemAtURL:error:を使って、iCloudにファイルやディレクトリの新しいバージョンをサーバーからダウンロードするよう強制できます。

To delete a file permanently from the user’s iCloud storage, use the regular NSFileManager routines for deleting files and directories. Remember that deleting items from iCloud can’t be undone. Once deleted, the item is gone forever. ファイルを永久にユーザのiCloudストレージから削除するには、通常のNSFileManagerルーチンをファイルとディレクトリの削除に対して使ってください。項目のiCloudからの削除は、取り消しできないのを忘れないでください。一旦削除したならば、項目は永遠に失われます。

See Also 参照

Managing iCloud-Based Items iCloud基盤の項目を管理する

Related Documentation 関連文書