File オブジェクトLink to this heading#django.core.files モジュールとそのサブモジュールでは、Django の基本的なファイルハンドリングに関するビルトインクラスが定義されています。
File クラスLink to this heading#File クラスは、Python の file object に Django 特有の追加機能を付け加えた薄いラッパーです。内部的でファイルを表現する必要がある場合には、Django はこのクラスを使います。
File オブジェクトには次の属性とメソッドを持ちます。
MEDIA_ROOT からの相対パスを含むファイル名です。
バイト単位で表されたファイルサイズ。
\nこのクラスがラッピングしている、素の file object クラスです。
\n\nファイルの読み込み/書き込みのモードです。
\nファイルを開くか再オープンします（これは File.seek(0) も行います）。 mode 引数は、Python の組み込み関数 open() と同じ値を許可します。 *args と **kwargs は、mode の後に、Python の組み込み関数 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() メソッドが一度呼び出されます。