mirror of
https://github.com/django/django.git
synced 2025-06-05 11:39:13 +00:00
Fixed #29440 -- Doc'd where the bulk argument applies in RelatedManager.
This commit is contained in:
parent
56611a96df
commit
7417929618
@ -96,7 +96,7 @@ Related objects reference
|
|||||||
parameter ``blog`` to ``create()``. Django figures out that the new
|
parameter ``blog`` to ``create()``. Django figures out that the new
|
||||||
``Entry`` object's ``blog`` field should be set to ``b``.
|
``Entry`` object's ``blog`` field should be set to ``b``.
|
||||||
|
|
||||||
.. method:: remove(*objs)
|
.. method:: remove(*objs, bulk=True)
|
||||||
|
|
||||||
Removes the specified model objects from the related object set::
|
Removes the specified model objects from the related object set::
|
||||||
|
|
||||||
@ -129,7 +129,10 @@ Related objects reference
|
|||||||
:data:`~django.db.models.signals.post_save` signals and comes at the
|
:data:`~django.db.models.signals.post_save` signals and comes at the
|
||||||
expense of performance.
|
expense of performance.
|
||||||
|
|
||||||
.. method:: clear()
|
For many-to-many relationships, the ``bulk`` keyword argument doesn't
|
||||||
|
exist.
|
||||||
|
|
||||||
|
.. method:: clear(bulk=True)
|
||||||
|
|
||||||
Removes all objects from the related object set::
|
Removes all objects from the related object set::
|
||||||
|
|
||||||
@ -143,6 +146,9 @@ Related objects reference
|
|||||||
:class:`~django.db.models.ForeignKey`\s where ``null=True`` and it also
|
:class:`~django.db.models.ForeignKey`\s where ``null=True`` and it also
|
||||||
accepts the ``bulk`` keyword argument.
|
accepts the ``bulk`` keyword argument.
|
||||||
|
|
||||||
|
For many-to-many relationships, the ``bulk`` keyword argument doesn't
|
||||||
|
exist.
|
||||||
|
|
||||||
.. method:: set(objs, bulk=True, clear=False)
|
.. method:: set(objs, bulk=True, clear=False)
|
||||||
|
|
||||||
Replace the set of related objects::
|
Replace the set of related objects::
|
||||||
@ -156,7 +162,11 @@ Related objects reference
|
|||||||
If ``clear=True``, the ``clear()`` method is called instead and the
|
If ``clear=True``, the ``clear()`` method is called instead and the
|
||||||
whole set is added at once.
|
whole set is added at once.
|
||||||
|
|
||||||
The ``bulk`` argument is passed on to :meth:`add`.
|
For :class:`~django.db.models.ForeignKey` objects, the ``bulk``
|
||||||
|
argument is passed on to :meth:`add` and :meth:`remove`.
|
||||||
|
|
||||||
|
For many-to-many relationships, the ``bulk`` keyword argument doesn't
|
||||||
|
exist.
|
||||||
|
|
||||||
Note that since ``set()`` is a compound operation, it is subject to
|
Note that since ``set()`` is a compound operation, it is subject to
|
||||||
race conditions. For instance, new objects may be added to the database
|
race conditions. For instance, new objects may be added to the database
|
||||||
|
Loading…
x
Reference in New Issue
Block a user