Class

FileManager

A convenient interface to the contents of the file system, and the primary means of interacting with it. ファイルシステムの内容、そしてそれと相互作用することの主要な手段に対する便利なインターフェイス。

Declaration 宣言

class FileManager : NSObject

Overview 概要

A file manager object lets you examine the contents of the file system and make changes to it. The FileManager class provides convenient access to a shared file manager object that is suitable for most types of file-related manipulations. A file manager object is typically your primary mode of interaction with the file system. You use it to locate, create, copy, and move files and directories. You also use it to get information about a file or directory or change some of its attributes. ファイルマネージャオブジェクトは、あなたにファイルシステムの内容を調査させます、そしてそれを変更させます。FileManagerクラスは、便利なアクセスを共有ファイルマネージャオブジェクトに対して提供します、それはファイル関連操作のほとんどの型に適します。ファイルマネージャオブジェクトは、一般的にファイルシステムとのやりとりのあなたの主要なモードです。あなたはそれを使って、ファイルとディレクトリの位置を突き止める、作成する、コピーする、そして移動をします。あなたはまた、それを使ってファイルやディレクトリの情報を得たり、それの属性の幾つかを変更します。

When specifying the location of files, you can use either NSURL or NSString objects. The use of the NSURL class is generally preferred for specifying file-system items because URLs can convert path information to a more efficient representation internally. You can also obtain a bookmark from an NSURL object, which is similar to an alias and offers a more sure way of locating the file or directory later. ファイルの位置を指定する場合、あなたはNSURLまたはNSStringオブジェクトのどちらかを使用できます。NSURLクラスは、さまざまなファイルシステム項目を指定するのに一般的に好まれます、なぜならURLそれらはパス情報をもっと効率の良い表現に内部的に変換できるからです。あなたはまた、NSURLオブジェクトからブックマークを得ることができます、それはエイリアスに似ています、そして後でファイルやディレクトリの位置決めをするいっそう確実な方法を提供します。

If you are moving, copying, linking, or removing files or directories, you can use a delegate in conjunction with a file manager object to manage those operations. The delegate’s role is to affirm the operation and to decide whether to proceed when errors occur. In macOS 10.7 and later, the delegate must conform to the FileManagerDelegate protocol. あなたがファイルやディレクトリの移動、コピー、リンク、または削除をしようとするならば、あなたはある委任先をファイルマネージャオブジェクトと連係して使用してそれら操作を管理できます。委任先の持つ役割は、操作を肯定すること、そしてエラーが発生した場合に続けるかどうかを決めることです。macOS 10.7以降では、委任先はFileManagerDelegateプロトコルに準拠しなければなりません。

In iOS 5.0 and later and in macOS 10.7 and later, FileManager includes methods for managing items stored in iCloud. Files and directories tagged for cloud storage are synced to iCloud so that they can be made available to the user’s iOS devices and Macintosh computers. Changes to an item in one location are propagated to all other locations to ensure the items stay in sync. iOS 5.0以降とmacOS 10.7以降では、FileManagerはiCloudに格納されるアイテムの管理のためのメソッドを含みます。クラウドストレージに対するタグをつけられるファイルとディレクトリは、iCloudと同期します、それでそれらはユーザの持つiOSデバイスとMacintoshコンピュータに利用可能にされます。ある場所でアイテムに加えられる変更は、全ての他の場所に伝えられて、アイテムが同期されたままであるのを保証します。

Threading Considerations スレッドの考察

The methods of the shared FileManager object can be called from multiple threads safely. However, if you use a delegate to receive notifications about the status of move, copy, remove, and link operations, you should create a unique instance of the file manager object, assign your delegate to that object, and use that file manager to initiate your operations. 共有FileManagerオブジェクトのメソッドは、複数のスレッドから安全に呼び出されることができます。しかしながら、あなたが移動、コピー、除去、そしてリンク操作の状況についての通知を受け取るのに委任先を使うならば、あなたはファイルマネージャオブジェクトのある固有のインスタンスを作成して、そのオブジェクトにあなたの委任先の役を割り当てて、そしてそのファイルマネージャを使ってあなたの操作を開始するべきです。

Topics 話題

Creating a File Manager あるファイルマネージャを作成する

Accessing User Directories ユーザディレクトリにアクセスする

Locating System Directories システムディレクトリの位置を突き止める

Locating Application Group Container Directories アプリケーショングループコンテナディレクトリの位置決めをする

Discovering Directory Contents ディレクトリ内容を発見する

Creating and Deleting Items 項目の作成と消去

Replacing Items 項目を置き換える

Moving and Copying Items 項目の移動とコピー

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

Accessing File Provider Services ファイルプロバイダサービスにアクセスする

Creating Symbolic and Hard Links シンボリックおよびハードリンクを作成する

Determining Access to Files ファイルへのアクセスを決定する

Getting and Setting Attributes 属性の取得と設定

Getting and Comparing File Contents ファイル内容の取得と比較

Getting the Relationship Between Items 項目間の関係を取得する

Converting File Paths to Strings ファイルパスを文字列へ変換する

Managing the Delegate 委任先を管理する

Managing the Current Directory 現在のディレクトリを管理する

Unmounting Volumes ボリュームをアンマウントする

Working with HFS File Types HFSファイル型を扱う

Determining Resource Fork Support リソースフォークサポートを決定する

Supporting Types 支援を行う型

Notifications 通知

Deprecated Methods 非推奨メソッド

Relationships 関係

Inherits From 継承元

See Also 参照

File System Operations ファイルシステム演算