Enumeration Case 列挙ケース

NSFileWrapperReadingImmediate

The option to read files immediately after creating a file wrapper. ファイルラッパーを作成した後に直ちにファイルを読み出すためのオプション。

Declaration 宣言

NSFileWrapperReadingImmediate = 1 << 0

Discussion 議論

When you create a file wrapper and pass the NSFileWrapperReadingImmediate reading option, the content of the file is read immediately. Otherwise, file content is read only when requested, such as by accessing the regularFileContents, fileWrappers, serializedRepresentation, or symbolicLinkDestinationURL properties. あなたがファイルラッパーを作成してNSFileWrapperReadingImmediate読み出しオプションを渡す場合、ファイルの内容は直ちに読み出されます。そうでなければ、ファイル内容は要請された場合にのみ読み出されます、たとえばregularFileContentsfileWrappersserializedRepresentation、またはsymbolicLinkDestinationURLプロパティにアクセスすることによって。

Reading a file immediately rather than lazily can help mitigate against reading errors caused by the user moving or deleting the file after a file wrapper is created. However, passing this option can result in unnecessary disk or network access—particularly when opening a document file package, which causes all of its directory contents to be enumerated and read preemptively. ファイルを遅延にではなく直ちに読み出すことは、ファイルラッパーが作成された後にユーザがファイルを移動または削除することによって起こる読み出しエラーを緩和する助けとなりえます。しかしながら、このオプションを渡すことは不必要なディスクまたはネットワークアクセスという結果になりえます — とりわけ書類ファイルパッケージを開いている時に、それはそれのディレクトリ内容の全てが列挙されるそして先制して読み出されることを引き起こします。

Even when NSFileWrapperReadingImmediate is specified, NSFileWrapper may not read the contents of some file packages immediately. For example, because the contents of bundles are immutable to the user, NSFileWrapper may read the children of such a directory lazily as a performance optimization. NSFileWrapperReadingImmediateが指定される場合でさえ、NSFileWrapperはいくつかのファイルパッケージの内容を直ぐに読み出さないかもしれません。例えば、バンドルの内容がそのユーザに対して変更できないことから、NSFileWrapperはそのようなディレクトリの子を性能最適化として遅延に読み出すかもしれません。

You can use this option to take a snapshot of a file or folder for writing later. For example, an application like TextEdit can use this option when creating new file wrappers to represent attachments that the user creates by copying and pasting or dragging and dropping from the Finder to a TextEdit document. あなたはこのオプションを使って、ファイルまたはフォルダの寸描を取ることができます、もっと後で書き出すために。例えば、TextEditのようなアプリケーションは、ユーザがFinderからTextEdit書類にコピー&ペーストまたはドラッグ&ドロップすることで作成する、さまざまな添付書類を表すために新しいファイルラッパーを作成する場合は、このオプションを使うことができます。