Fixed #2264: the docs now mention that delete() cascades. Thanks, Ubernostrum
git-svn-id: http://code.djangoproject.com/svn/django/trunk@4636 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
parent
6dfd32d4e8
commit
a419079347
|
@ -1621,6 +1621,15 @@ For example, this deletes all ``Entry`` objects with a ``pub_date`` year of
|
||||||
|
|
||||||
Entry.objects.filter(pub_date__year=2005).delete()
|
Entry.objects.filter(pub_date__year=2005).delete()
|
||||||
|
|
||||||
|
When Django deletes an object, it emulates the behavior of the SQL
|
||||||
|
constraint ``ON DELETE CASCADE`` -- in other words, any objects which
|
||||||
|
had foreign keys pointing at the object to be deleted will be deleted
|
||||||
|
along with it. For example::
|
||||||
|
|
||||||
|
b = Blog.objects.get(pk=1)
|
||||||
|
# This will delete the Blog and all of its Entry objects.
|
||||||
|
b.delete()
|
||||||
|
|
||||||
Note that ``delete()`` is the only ``QuerySet`` method that is not exposed on a
|
Note that ``delete()`` is the only ``QuerySet`` method that is not exposed on a
|
||||||
``Manager`` itself. This is a safety mechanism to prevent you from accidentally
|
``Manager`` itself. This is a safety mechanism to prevent you from accidentally
|
||||||
requesting ``Entry.objects.delete()``, and deleting *all* the entries. If you
|
requesting ``Entry.objects.delete()``, and deleting *all* the entries. If you
|
||||||
|
|
Loading…
Reference in New Issue