p15693087
/
django
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Fix #15646: Document that a FileField's full path can't be relied upon until its model has been saved to the database. Thanks poirier. 

git-svn-id: http://code.djangoproject.com/svn/django/trunk@17113 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Karen Tracey 2011-11-19 15:08:07 +00:00
parent 549c495875
commit c8c71057aa
2 changed files with 11 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
docs/ref/models/fields.txt
View File

@ -572,6 +572,11 @@ information on the available attributes and methods, see the
:class:`~django.core.files.File` class reference and the :doc:`/topics/files` :class:`~django.core.files.File` class reference and the :doc:`/topics/files`
topic guide. topic guide.
.. note::
The file is saved as part of saving the model in the database, so the actual
file name used on disk cannot be relied on until after the model has been
saved.
The uploaded file's relative URL can be obtained using the The uploaded file's relative URL can be obtained using the
:attr:`~django.db.models.fields.FileField.url` attribute. Internally, :attr:`~django.db.models.fields.FileField.url` attribute. Internally,
this calls the :meth:`~django.core.files.storage.Storage.url` method of the this calls the :meth:`~django.core.files.storage.Storage.url` method of the

6
docs/topics/files.txt
View File

@ -45,6 +45,12 @@ the details of the attached photo::
This object -- ``car.photo`` in the example -- is a ``File`` object, which means This object -- ``car.photo`` in the example -- is a ``File`` object, which means
it has all the methods and attributes described below. it has all the methods and attributes described below.
.. note::
The file is saved as part of saving the model in the database, so the actual
file name used on disk cannot be relied on until after the model has been
saved.
The ``File`` object The ``File`` object
=================== ===================