Added a bit to 'Saving ManyToMany Fields' explicitly explaining how to add multiple relations in one statement

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16689 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Adrian Holovaty 2011-08-26 04:34:40 +00:00
parent 5eeb2d56d5
commit 804a6db86e
1 changed files with 9 additions and 0 deletions

View File

@ -113,6 +113,15 @@ method on the field to add a record to the relation. This example adds the
>>> joe = Author.objects.create(name="Joe")
>>> entry.authors.add(joe)
To add multiple records to a ``ManyToManyField`` in one go, include multiple
arguments in the call to ``add()``, like this::
>>> john = Author.objects.create(name="John")
>>> paul = Author.objects.create(name="Paul")
>>> george = Author.objects.create(name="George")
>>> ringo = Author.objects.create(name="Ringo")
>>> entry.authors.add(john, paul, george, ringo)
Django will complain if you try to assign or add an object of the wrong type.
Retrieving objects