File オブジェクトLink to this heading#django.core.files モジュールとそのサブモジュールでは、Django の基本的なファイルハンドリングに関するビルトインクラスが定義されています。
File クラスLink to this heading#The File class is a thin wrapper around a Python\nfile object with some Django-specific additions.\nInternally, Django uses this class when it needs to represent a file.
File オブジェクトには次の属性とメソッドを持ちます。
MEDIA_ROOT からの相対パスを含むファイル名です。
バイト単位で表されたファイルサイズ。
\nThe underlying file object that this class wraps.
\n\nファイルの読み込み/書き込みのモードです。
\nOpen or reopen the file (which also does File.seek(0)).\nThe mode argument allows the same values\nas Python's built-in open(). *args and **kwargs\nare passed after mode to Python's built-in open().
ファイルを再オープンする際、 mode はファイルが元々開かれていたモードを上書きします。 None はオリジナルのモードで再オープンすることを意味します。
コンテキストマネージャとして使用できます。たとえば、 with file.open() as f: のようにです。
ファイルをイテレートして、1行ずつ返します。
\nファイルをイテレートし、指定されたサイズの「チャンク」を生成します。 chunk_size のデフォルトは 64 KB です。
これは非常に大きなファイルに特に便利であり、ディスクからストリーミングしてメモリ全体にファイルを保存することを避けることができます。
\nchunk_size (一括サイズ) で指定されたファイルの全内容にアクセスするために複数のチャンクが必要な場合は True を返します。
ファイルを閉じてください。
\nリストされたメソッドに加えて、File は、その file オブジェクトの以下の属性とメソッドを公開しています: encoding, fileno, flush, isatty, newlines, read, readinto, readline, readlines, seek, tell, truncate, write, writelines, readable(), writable(), および seekable() 。
ContentFile クラスLink to this heading#ContentFile クラスは File を継承していますが、File とは異なり、実際のファイルではなく文字列コンテンツ(バイトもサポート)で操作します。例えば：
from django.core.files.base import ContentFile\n\nf1 = ContentFile("esta frase está en español")\nf2 = ContentFile(b"these are bytes")\nImageFile クラスLink to this heading#Django には画像専用の組み込みクラスがあります。 django.core.files.images.ImageFile は File のすべての属性とメソッドを継承し、さらに次のものを提供します:
画像の幅 (ピクセル単位)。
\n画像の高さ(ピクセル単位)。
\nオブジェクト（以下の Car.photo のように）に関連付けられた File には、いくつかの追加メソッドも用意されています。
提供されたファイル名と内容で新しいファイルを保存します。これは既存のファイルを置き換えるものではありませんが、新しいファイルを作成し、オブジェクトがそれを指すように更新します。 save が True の場合、ファイルが保存されたらモデルの save() メソッドが一度呼び出されます。つまり、次の二行です:
>>> car.photo.save("myphoto.jpg", content, save=False)\n>>> car.save()\nこれは以下と同等です:
\n>>> car.photo.save("myphoto.jpg", content, save=True)\ncontent 引数は、 File または File のサブクラス（例えば、 ContentFile など）のインスタンスでなければなりません。
モデルインスタンスからファイルを削除し、基になるファイルも削除します。 save が True の場合、ファイルが削除された後にモデルの save() メソッドが一度呼び出されます。