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

setUbiquitous:itemAtURL:destinationURL:error:

Indicates whether the item at the specified URL should be stored in iCloud. 指定されたURLでの項目がiCloudに格納されるべきかどうかを指し示します。

Declaration 宣言

- (BOOL)setUbiquitous:(BOOL)flag 
            itemAtURL:(NSURL *)url 
       destinationURL:(NSURL *)destinationURL 
                error:(NSError * _Nullable *)error;

Parameters パラメータ

flag

YES to move the item to iCloud or NO to remove it from iCloud (if it is there currently). 項目をiCloudに移動するにはYES、もしくはそれをiCloudから取り除くにはNO(それが現在あるならば)。

url

The URL of the item (file or directory) that you want to store in iCloud. あなたがiCloudに格納したい項目(ファイルまたはディレクトリ)のURL。

destinationURL

Moving a file into iCloud The location in iCloud at which to store the file or directory. This URL must be constructed from a URL returned by the URLForUbiquityContainerIdentifier: method, which you use to retrieve the desired iCloud container directory. The URL you specify may contain additional subdirectories so that you can organize your files hierarchically in iCloud. However, you are responsible for creating those intermediate subdirectories (using the NSFileManager class) in your iCloud container directory. あるファイルをiCloudへと移動する iCloudでの場所、そこでファイルまたはディレクトリを格納します。あなたが要望するiCloudコンテナディレクトリを捜してくるために使うURLForUbiquityContainerIdentifier:メソッドによって返されるURLから、このURLは組み立てられなければなりません。あなたが指定するURLは追加の下位ディレクトリを含むかもしれません、それであなたがiCloudにおいて階層的にあなたのファイルを組織化できるように。しかしながら、あなたは、あなたのiCloudコンテナディレクトリにおいて(NSFileManagerクラスを使って)それら中間的な下位ディレクトリを作成することに対する責任があります。

Moving a file out of iCloud The location on the local device. あるファイルをiCloudの外に移動する ローカルデバイス上の場所。

errorOut

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 item’s status was updated successfully or NO if an error occurred. If this method returns NO and you specified a value for the errorOut parameter, this method returns an error object in the provided pointer. YES、もし項目の状態がうまく更新されたならば、またはNO、もしエラーが発生したならば。このメソッドがNOを返すそしてあなたがある値をerrorOutパラメータに指定したならば、このメソッドは提供されたポインタにおいてエラーオブジェクトを返します。

Discussion 議論

Use this method to move a file from its current location to iCloud. For files located in an app’s sandbox, this involves physically removing the file from the sandbox container. (The system extends your app’s sandbox privileges to give it access to files it moves to iCloud.) You can also use this method to move files out of iCloud and back into a local directory. このメソッドを使ってファイルをそれの現在の場所からiCloudへ移動してください。アプリのサンドボックスの中に位置するファイルに対して、これは物理的にファイルをサンドボックスコンテナから削除することを伴います。(システムは、あなたのアプリの持つサンドボックス特権を拡張して、それがiCloudに移動するファイルへのアクセスをそれに与えます。)あなたはまたこのメソッドを使ってファイルをiCloudの外に移動して、そしてローカルディレクトリに戻すことができます。

If your app is presenting the file’s contents to the user, it must have an active file presenter object configured to monitor the specified file or directory before calling this method. When you specify YES for the flag parameter, this method attempts to move the file or directory to the cloud and returns YES if it is successful. Calling this method also notifies your file presenter of the new location of the file so that your app can continue to operate on it. あなたのアプリがファイルの内容をユーザに提示するならば、このメソッドを呼び出す前に、それは指定されたファイルやディレクトリを監視するために構成設定されたアクティブなファイルプレゼンタオブジェクトを持たなければなりません。あなたがYESflagパラメータに指定する場合、このメソッドはファイルやディレクトリをクラウドに移動することを試みて、それが成功するならばYESを返します。このメソッドを呼び出すことはまた、ファイルの新しい場所のあなたのファイルプレゼンタに通知します、それであなたのアプリはそれに関する操作を続けられます。

See Also 参照

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