[1.1.X] Fixed #12620 - Refer to better fieldname in defer docs. Thanks, dwillis.
Backport of r12462. git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.1.X@12479 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
parent
71897bf300
commit
4261efdc67
|
@ -804,7 +804,7 @@ the database.
|
||||||
|
|
||||||
This is done by passing the names of the fields to not load to ``defer()``::
|
This is done by passing the names of the fields to not load to ``defer()``::
|
||||||
|
|
||||||
Entry.objects.defer("lede", "body")
|
Entry.objects.defer("headline", "body")
|
||||||
|
|
||||||
A queryset that has deferred fields will still return model instances. Each
|
A queryset that has deferred fields will still return model instances. Each
|
||||||
deferred field will be retrieved from the database if you access that field
|
deferred field will be retrieved from the database if you access that field
|
||||||
|
@ -814,7 +814,7 @@ You can make multiple calls to ``defer()``. Each call adds new fields to the
|
||||||
deferred set::
|
deferred set::
|
||||||
|
|
||||||
# Defers both the body and lede fields.
|
# Defers both the body and lede fields.
|
||||||
Entry.objects.defer("body").filter(headline="Lennon").defer("lede")
|
Entry.objects.defer("body").filter(rating=5).defer("headline")
|
||||||
|
|
||||||
The order in which fields are added to the deferred set does not matter. Calling ``defer()`` with a field name that has already been deferred is harmless (the field will still be deferred).
|
The order in which fields are added to the deferred set does not matter. Calling ``defer()`` with a field name that has already been deferred is harmless (the field will still be deferred).
|
||||||
|
|
||||||
|
@ -822,7 +822,7 @@ You can defer loading of fields in related models (if the related models are
|
||||||
loading via ``select_related()``) by using the standard double-underscore
|
loading via ``select_related()``) by using the standard double-underscore
|
||||||
notation to separate related fields::
|
notation to separate related fields::
|
||||||
|
|
||||||
Blog.objects.select_related().defer("entry__lede", "entry__body")
|
Blog.objects.select_related().defer("entry__headline", "entry__body")
|
||||||
|
|
||||||
If you want to clear the set of deferred fields, pass ``None`` as a parameter
|
If you want to clear the set of deferred fields, pass ``None`` as a parameter
|
||||||
to ``defer()``::
|
to ``defer()``::
|
||||||
|
|
Loading…
Reference in New Issue