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") >>> joe = Author.objects.create(name="Joe")
>>> entry.authors.add(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. Django will complain if you try to assign or add an object of the wrong type.
Retrieving objects Retrieving objects