Class

NSFileWrapper

A representation of a node (a file, directory, or symbolic link) in the file system. ファイルシステムの中のあるノード（あるファイル、ディレクトリ、またはシンボリックリンク）の表現。

Declaration 宣言 

@interface NSFileWrapper : NSObject

Overview 概要

The NSFileWrapper class provides access to the attributes and contents of file system nodes. A file system node is a file, directory, or symbolic link. Instances of this class are known as file wrappers. NSFileWrapperクラスは、ファイルシステム・ノードの属性と内容へのアクセスを提供します。ファイルシステムノードは、ファイル、ディレクトリ、またはシンボリックリンクです。このクラスのインスタンスは、ファイルラッパーとして知られます。

File wrappers represent a file system node as an object that can be displayed as an image (and possibly edited in place), saved to the file system, or transmitted to another application. ファイルラッパーは、ファイルシステムノードを、画像として表示（そしておそらくは場に合わせて手直し）されること、ファイルシステムに保存されること、または別のアプリケーションに伝えられることが可能なオブジェクトとして表します。

There are three types of file wrappers: ３つの方のファイルラッパーがあります：

  • Regular-file file wrapper: Represents a regular file. 通常ファイルファイルラッパー： 通常のファイルを表します。

  • Directory file wrapper: Represents a directory. ディレクトリファイルラッパー： ディレクトリを表します。

  • Symbolic-link file wrapper: Represents a symbolic link. シンボリックリンクファイルラッパー： シンボリックリンクを表します。

A file wrapper has these attributes: ファイルラッパーは、これらの属性を持ちます：

  • Filename. Name of the file system node the file wrapper represents. ファイル名。 ファイルラッパーが表すファイルシステムノードの名前。

  • file-system attributes. See NSFileManager for information on the contents of the attributes dictionary. ファイルシステム属性。 NSFileManagerをattributes辞書の内容に関する情報として見てください。

  • Regular-file contents. Applicable only to regular-file file wrappers. 通常ファイル内容。 通常ファイルファイルラッパーに対してのみ適用可能です。

  • File wrappers. Applicable only to directory file wrappers. ファイルラッパー。 ディレクトリファイルラッパーに対してのみ適用可能です。

  • Destination node. Applicable only to symbolic-link file wrappers. 行き先ノード。 シンボリックリンクファイルラッパーに対してのみ適用可能です。

Topics 話題

Creating File Wrappers ファイルラッパーを作成する

This class has several designated initializers. このクラスは、いくつかの指定イニシャライザを持ちます。
- initWithURL:options:error:
Initializes a file wrapper instance whose kind is determined by the type of file-system node located by the URL. ファイルラッパーインスタンスを初期化します、それのもつ種類はURLによって位置決めされるファイルシステムノードの型によって決定されます。
- initWithPath:
Initializes a file wrapper instance whose kind is determined by the type of file-system node located by the path. ファイルラッパーインスタンスを初期化します、それのもつ種類はパスによって位置決めされるファイルシステムノードの型によって決定されます。
Deprecated 非推奨
- initDirectoryWithFileWrappers:
Initializes the receiver as a directory file wrapper, with a given file-wrapper list. 与えられたファイルラッパーリストで、レシーバをディレクトリファイルラッパーとして初期化します。
- initRegularFileWithContents:
Initializes the receiver as a regular-file file wrapper. レシーバを通常ファイルファイルラッパーとして初期化します。
- initSymbolicLinkWithDestination:
Initializes the receiver as a symbolic-link file wrapper. レシーバをシンボリックリンクファイルラッパーとして初期化します。
Deprecated 非推奨
- initSymbolicLinkWithDestinationURL:
Initializes the receiver as a symbolic-link file wrapper that links to a specified file. レシーバをシンボリックリンクファイルラッパーとして初期化します、それは指定されたファイルにリンクされます。
- initWithSerializedRepresentation:
Initializes the receiver as a regular-file file wrapper from given serialized data. 与えられたシリアライズされたデータから、レシーバを通常ファイルファイルラッパーとして初期化します。

Querying File Wrappers ファイルラッパーに問い合わせる

regularFile
This property contains a boolean value that indicates whether the file wrapper object is a regular-file. このプロパティはブール値を含みます、それはファイルラッパーオブジェクトが通常ファイルかどうかを指し示します。
directory
This property contains a boolean value indicating whether the file wrapper is a directory file wrapper. このプロパティはブール値を含みます、ファイルラッパーがディレクトリファイルラッパーかどうかを指し示しています。
symbolicLink
A boolean that indicates whether the file wrapper object is a symbolic-link file wrapper. ブール値、それはファイルラッパーオブジェクトがシンボリックリンクファイルラッパーかどうかを指し示します。

Accessing File-Wrapper Information ファイルラッパー情報にアクセスする

fileWrappers
The file wrappers contained by a directory file wrapper. ファイルラッパーは、ディレクトリファイルラッパーによって含まれます。
- addFileWrapper:
Adds a child file wrapper to the receiver, which must be a directory file wrapper. 子ファイルラッパーをレシーバに追加します、それはディレクトリファイルラッパーでなければなりません。
- removeFileWrapper:
Removes a child file wrapper from the receiver, which must be a directory file wrapper. 子ファイルラッパーをレシーバから取り除きます、それはディレクトリファイルラッパーでなければなりません。
- addFileWithPath:
Creates a file wrapper from a given file-system node and adds it to the receiver, which must be a directory file wrapper. ファイルラッパーをある与えられたファイルシステムノードから作成してそれをレシーバに加えます、それはディレクトリファイルラッパーでなければなりません。
Deprecated 非推奨
- addRegularFileWithContents:preferredFilename:
Creates a regular-file file wrapper with the given contents and adds it to the receiver, which must be a directory file wrapper. 与えられた内容を持つ通常ファイルファイルラッパーを作成してそれをレシーバに加えます、それはディレクトリファイルラッパーでなければなりません。
- addSymbolicLinkWithDestination:preferredFilename:
Creates a symbolic-link file wrapper pointing to a given file-system node and adds it to the receiver, which must be a directory file wrapper. ある与えられたファイルシステムノードを指すシンボリックリンクファイルラッパーを作成してそれをレシーバに加えます、それはディレクトリファイルラッパーでなければなりません。
Deprecated 非推奨
- keyForFileWrapper:
Returns the dictionary key used by a directory to identify a given file wrapper. 与えられたファイルラッパーを識別する、ディレクトリによって使われる辞書キーを返します。
- symbolicLinkDestination
Provides the pathname referenced by the file wrapper object, which must be a symbolic-link file wrapper. ファイルラッパーオブジェクト、それはシンボリックリンクファイルラッパーである必要があります、によって参照されるパス名を提供します。
Deprecated 非推奨
symbolicLinkDestinationURL
The URL referenced by the file wrapper object, which must be a symbolic-link file wrapper. ファイルラッパーオブジェクトによって参照されるURL、それはシンボリックリンクファイルラッパーでなければなりません。

Updating File Wrappers ファイルラッパーを更新する

- needsToBeUpdatedFromPath:
Indicates whether the file wrapper needs to be updated to match a given file-system node. 与えられたファイルシステムノードに合致するためにファイルラッパーが更新されることを必要とするかどうかを指し示します。
Deprecated 非推奨
- matchesContentsOfURL:
Indicates whether the contents of a file wrapper matches a directory, regular file, or symbolic link on disk. ファイルラッパーの内容がディスク上のディレクトリ、通常ファイル、またはシンボリックリンクと合致するかどうかを指し示します。
- updateFromPath:
Updates the file wrapper to match a given file-system node. ファイルラッパーをある与えられたファイルシステムノードと合致するよう更新します。
Deprecated 非推奨
- readFromURL:options:error:
Recursively rereads the entire contents of a file wrapper from the specified location on disk. ディスク上の指定された場所から、ファイルラッパーの全内容を再帰的に再読み込みします。

Serializing シリアライズ

serializedRepresentation
The contents of the file wrapper as an opaque data object. ファイルラッパーの内容、不透明データオブジェクトとして。

Accessing Files ファイルにアクセスする

filename
The filename of the file wrapper object ファイルラッパーオブジェクトのファイル名。
preferredFilename
The preferred filename for the file wrapper object. ファイルラッパーオブジェクトに対する優先ファイル名。
fileAttributes
A dictionary of file attributes. ファイル属性の辞書。
regularFileContents
The contents of the file-system node associated with a regular-file file wrapper. 通常ファイルファイルラッパーと結び付けられるファイルシステムノードの内容。

Writing Files ファイル書き出し

- writeToFile:atomically:updateFilenames:
Writes a file wrapper’s contents to a given file-system node. ファイルラッパーの持つ内容をある与えられたファイルシステムノードに書き込みます。
Deprecated 非推奨
- writeToURL:options:originalContentsURL:error:
Recursively writes the entire contents of a file wrapper to a given file-system URL. 与えられたファイルシステムURLへと、ファイルラッパーの全内容を再帰的に書き込みます。

Working with Icons アイコンを扱う

icon
The icon that represents the file wrapper. ファイルラッパーを表すアイコン。

Constants 定数

NSFileWrapperReadingOptions
Reading options that can be set by the initWithURL:options:error: and readFromURL:options:error: methods. initWithURL:options:error:とreadFromURL:options:error:メソッドによって設定されることが可能である読み出しオプション。
NSFileWrapperWritingOptions
Writing options that can be set by the writeToURL:options:originalContentsURL:error: method. writeToURL:options:originalContentsURL:error:メソッドによって設定されることが可能である書き込みオプション。

Initializers イニシャライザ

- initWithCoder:

Relationships 関係

Inherits From 継承元

Conforms To 次に準拠

See Also 参照

Managed File Access ファイルアクセスを管理する

NSFileHandle
An object-oriented wrapper for a file descriptor. ファイル記述子のためのオブジェクト指向のラッパー。
NSFileSecurity
A stub class that encapsulates security information about a file. あるファイルについての保安情報をカプセル化するスタブクラス。
NSFileVersion
A snapshot of a file at a specific point in time. 特定の時点でのあるファイルのスナップショット。