Author: gabrielhurley Date: 2010-10-09 03:20:56 -0500 (Sat, 09 Oct 2010) New Revision: 14070
Modified: django/trunk/docs/topics/db/queries.txt Log: Fixes #13538 -- Clarified query examples with more explicit import statements and model vs. instance differentiation. Thanks to [email protected] and kmtracey for the report, and timo for the patch. Modified: django/trunk/docs/topics/db/queries.txt =================================================================== --- django/trunk/docs/topics/db/queries.txt 2010-10-09 08:12:50 UTC (rev 14069) +++ django/trunk/docs/topics/db/queries.txt 2010-10-09 08:20:56 UTC (rev 14070) @@ -94,18 +94,23 @@ Saving ``ForeignKey`` and ``ManyToManyField`` fields ---------------------------------------------------- -Updating ``ForeignKey`` fields works exactly the same way as saving a normal -field; simply assign an object of the right type to the field in question:: +Updating a ``ForeignKey`` field works exactly the same way as saving a normal +field; simply assign an object of the right type to the field in question. +This example updates the ``blog`` attribute of an ``Entry`` instance ``entry``:: + >>> from mysite.blog.models import Entry + >>> entry = Entry.objects.get(pk=1) >>> cheese_blog = Blog.objects.get(name="Cheddar Talk") >>> entry.blog = cheese_blog >>> entry.save() Updating a ``ManyToManyField`` works a little differently; use the ``add()`` -method on the field to add a record to the relation:: +method on the field to add a record to the relation. This example adds the +``Author`` instance ``joe`` to the ``entry`` object:: - >> joe = Author.objects.create(name="Joe") - >> entry.authors.add(joe) + >>> from mysite.blog.models import Author + >>> joe = Author.objects.create(name="Joe") + >>> entry.authors.add(joe) Django will complain if you try to assign or add an object of the wrong type. -- You received this message because you are subscribed to the Google Groups "Django updates" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/django-updates?hl=en.
