{"title":"关联对象参考","version":"5.1","locale":"zh-hans","docname":"ref/models/relations","url":"/zh-hans/5.1/ref/models/relations/","canonical":"https://djangodocs.dev/zh-hans/5.1/ref/models/relations/","summary":"“关系管理器”是一个用于处理一对多和多对多关系的管理器。在以下两种情况用到：ForeignKey 关系的“另一边”。即、在上面的例子中，以下方法将在管理器 blog.entry_set…","html":"<h1>关联对象参考<a class=\"heading-anchor\" href=\"#related-objects-reference\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.fields.related.RelatedManager\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-name descname\">RelatedManager</span><a class=\"heading-anchor\" href=\"#django.db.models.fields.related.RelatedManager\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>“关系管理器”是一个用于处理一对多和多对多关系的管理器。在以下两种情况用到：</p>\n<ul>\n<li><p><a class=\"reference internal\" href=\"/zh-hans/5.1/ref/models/fields/#django.db.models.ForeignKey\" title=\"django.db.models.ForeignKey\"><code class=\"xref py py-class docutils literal notranslate\">ForeignKey</code></a> 关系的“另一边”。即：</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"kn\">from</span> <span class=\"nn\">django.db</span> <span class=\"kn\">import</span> models\n\n\n<span class=\"k\">class</span> <span class=\"nc\">Blog</span><span class=\"p\">(</span>models<span class=\"o\">.</span>Model<span class=\"p\">):</span>\n    <span class=\"c1\"># ...</span>\n    <span class=\"k\">pass</span>\n\n\n<span class=\"k\">class</span> <span class=\"nc\">Entry</span><span class=\"p\">(</span>models<span class=\"o\">.</span>Model<span class=\"p\">):</span>\n    blog <span class=\"o\">=</span> models<span class=\"o\">.</span>ForeignKey<span class=\"p\">(</span>Blog<span class=\"p\">,</span> on_delete<span class=\"o\">=</span>models<span class=\"o\">.</span>CASCADE<span class=\"p\">,</span> null<span class=\"o\">=</span><span class=\"kc\">True</span><span class=\"p\">)</span>\n</code></pre></div>\n<p>在上面的例子中，以下方法将在管理器 <code class=\"docutils literal notranslate\">blog.entry_set</code> 上可用。</p>\n</li>\n<li><p><a class=\"reference internal\" href=\"/zh-hans/5.1/ref/models/fields/#django.db.models.ManyToManyField\" title=\"django.db.models.ManyToManyField\"><code class=\"xref py py-class docutils literal notranslate\">ManyToManyField</code></a> 关系的两端：</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"k\">class</span> <span class=\"nc\">Topping</span><span class=\"p\">(</span>models<span class=\"o\">.</span>Model<span class=\"p\">):</span>\n    <span class=\"c1\"># ...</span>\n    <span class=\"k\">pass</span>\n\n\n<span class=\"k\">class</span> <span class=\"nc\">Pizza</span><span class=\"p\">(</span>models<span class=\"o\">.</span>Model<span class=\"p\">):</span>\n    toppings <span class=\"o\">=</span> models<span class=\"o\">.</span>ManyToManyField<span class=\"p\">(</span>Topping<span class=\"p\">)</span>\n</code></pre></div>\n<p>在这个例子中，下文列出的方法在 <code class=\"docutils literal notranslate\">topping.pizza_set</code> 和 <code class=\"docutils literal notranslate\">pizza.toppings</code> 中均可用。</p>\n</li>\n</ul>\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.fields.related.RelatedManager.add\">\n<span class=\"sig-name descname\">add</span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"o\">*</span>objs</em>, <em class=\"sig-param\">bulk<span class=\"o\">=</span><span class=\"default_value\">True</span></em>, <em class=\"sig-param\">through_defaults<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.db.models.fields.related.RelatedManager.add\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.fields.related.RelatedManager.aadd\">\n<span class=\"sig-name descname\">aadd</span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"o\">*</span>objs</em>, <em class=\"sig-param\">bulk<span class=\"o\">=</span><span class=\"default_value\">True</span></em>, <em class=\"sig-param\">through_defaults<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.db.models.fields.related.RelatedManager.aadd\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>异步版本</em>: <code class=\"docutils literal notranslate\">aadd</code></p>\n<p>将指定的模型对象加入关联对象集。</p>\n<p>例如：</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span>b <span class=\"o\">=</span> Blog<span class=\"o\">.</span>objects<span class=\"o\">.</span>get<span class=\"p\">(</span><span class=\"nb\">id</span><span class=\"o\">=</span><span class=\"mi\">1</span><span class=\"p\">)</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>e <span class=\"o\">=</span> Entry<span class=\"o\">.</span>objects<span class=\"o\">.</span>get<span class=\"p\">(</span><span class=\"nb\">id</span><span class=\"o\">=</span><span class=\"mi\">234</span><span class=\"p\">)</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>b<span class=\"o\">.</span>entry_set<span class=\"o\">.</span>add<span class=\"p\">(</span>e<span class=\"p\">)</span>  <span class=\"c1\"># Associates Entry e with Blog b.</span>\n</code></pre></div>\n<p>上述例子中，由于有 <a class=\"reference internal\" href=\"/zh-hans/5.1/ref/models/fields/#django.db.models.ForeignKey\" title=\"django.db.models.ForeignKey\"><code class=\"xref py py-class docutils literal notranslate\">ForeignKey</code></a> 关系，才可以使用 <a class=\"reference internal\" href=\"/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.update\" title=\"django.db.models.query.QuerySet.update\"><code class=\"xref py py-meth docutils literal notranslate\">QuerySet.update()</code></a> 更新数据。这要求对象事先已经被保存在数据库内了。</p>\n<p>你可以使用 <code class=\"docutils literal notranslate\">bulk=False</code> 参数让关系管理器通过调用 <code class=\"docutils literal notranslate\">e.save()</code> 来执行更新操作。</p>\n<p>但是，在多对多关系中使用 <code class=\"docutils literal notranslate\">add()</code>，不会调用任何 <code class=\"docutils literal notranslate\">save()</code> 方法（<code class=\"docutils literal notranslate\">bulk</code> 参数不存在），而是使用 <code class=\"xref py py-meth docutils literal notranslate\">QuerySet.bulk_create()</code> 创建关系。如果需要在创建关系时执行一些自定义逻辑，可以监听 <a class=\"reference internal\" href=\"/zh-hans/5.1/ref/signals/#django.db.models.signals.m2m_changed\" title=\"django.db.models.signals.m2m_changed\"><code class=\"xref py py-data docutils literal notranslate\">m2m_changed</code></a> 信号，它将触发 <code class=\"docutils literal notranslate\">pre_add</code> 和 <code class=\"docutils literal notranslate\">post_add</code> 动作。</p>\n<p>在已经存在的关系上使用 <code class=\"docutils literal notranslate\">add()</code> 不会重复关系，但仍然会触发信号。</p>\n<p>对于多对多关系，<code class=\"docutils literal notranslate\">add()</code> 接受模型实例或字段值，通常是主键，作为 <code class=\"docutils literal notranslate\">*objs</code> 参数。</p>\n<p>如果需要的话，使用 <code class=\"docutils literal notranslate\">through_defaults</code> 参数为新的 <a class=\"reference internal\" href=\"/zh-hans/5.1/topics/db/models/#intermediary-manytomany\"><span class=\"std std-ref\">中间模型</span></a> 实例指定值。你可以使用可调用对象作为 <code class=\"docutils literal notranslate\">through_defaults</code> 字典中的值，它们将在创建任何中间实例之前被执行一次。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.fields.related.RelatedManager.create\">\n<span class=\"sig-name descname\">create</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">through_defaults<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\"><span class=\"o\">**</span>kwargs</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.db.models.fields.related.RelatedManager.create\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.fields.related.RelatedManager.acreate\">\n<span class=\"sig-name descname\">acreate</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">through_defaults<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\"><span class=\"o\">**</span>kwargs</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.db.models.fields.related.RelatedManager.acreate\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>异步版本</em>: <code class=\"docutils literal notranslate\">acreate</code></p>\n<p>创建一个新对象，保存它并将它放入相关对象集中。返回新创建的对象：</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span>b <span class=\"o\">=</span> Blog<span class=\"o\">.</span>objects<span class=\"o\">.</span>get<span class=\"p\">(</span><span class=\"nb\">id</span><span class=\"o\">=</span><span class=\"mi\">1</span><span class=\"p\">)</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>e <span class=\"o\">=</span> b<span class=\"o\">.</span>entry_set<span class=\"o\">.</span>create<span class=\"p\">(</span>\n<span class=\"gp\">... </span>    headline<span class=\"o\">=</span><span class=\"s2\">&quot;Hello&quot;</span><span class=\"p\">,</span> body_text<span class=\"o\">=</span><span class=\"s2\">&quot;Hi&quot;</span><span class=\"p\">,</span> pub_date<span class=\"o\">=</span>datetime<span class=\"o\">.</span>date<span class=\"p\">(</span><span class=\"mi\">2005</span><span class=\"p\">,</span> <span class=\"mi\">1</span><span class=\"p\">,</span> <span class=\"mi\">1</span><span class=\"p\">)</span>\n<span class=\"gp\">... </span><span class=\"p\">)</span>\n\n<span class=\"go\"># No need to call e.save() at this point -- it&#39;s already been saved.</span>\n</code></pre></div>\n<p>这等同于（但比以下方式更简单）：</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span>b <span class=\"o\">=</span> Blog<span class=\"o\">.</span>objects<span class=\"o\">.</span>get<span class=\"p\">(</span><span class=\"nb\">id</span><span class=\"o\">=</span><span class=\"mi\">1</span><span class=\"p\">)</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>e <span class=\"o\">=</span> Entry<span class=\"p\">(</span>blog<span class=\"o\">=</span>b<span class=\"p\">,</span> headline<span class=\"o\">=</span><span class=\"s2\">&quot;Hello&quot;</span><span class=\"p\">,</span> body_text<span class=\"o\">=</span><span class=\"s2\">&quot;Hi&quot;</span><span class=\"p\">,</span> pub_date<span class=\"o\">=</span>datetime<span class=\"o\">.</span>date<span class=\"p\">(</span><span class=\"mi\">2005</span><span class=\"p\">,</span> <span class=\"mi\">1</span><span class=\"p\">,</span> <span class=\"mi\">1</span><span class=\"p\">))</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>e<span class=\"o\">.</span>save<span class=\"p\">(</span>force_insert<span class=\"o\">=</span><span class=\"kc\">True</span><span class=\"p\">)</span>\n</code></pre></div>\n<p>无需指定定义了模型间关系的关键字参数。在上述例子中，我们并未向 <code class=\"docutils literal notranslate\">create()</code> 传递参数 <code class=\"docutils literal notranslate\">blog</code>。Django 知道要将新 <code class=\"docutils literal notranslate\">Entry</code> 对象的 <code class=\"docutils literal notranslate\">blog</code> 字段设置为 <code class=\"docutils literal notranslate\">b</code>。</p>\n<p>如果需要的话，使用 <code class=\"docutils literal notranslate\">through_defaults</code> 参数为新的 <a class=\"reference internal\" href=\"/zh-hans/5.1/topics/db/models/#intermediary-manytomany\"><span class=\"std std-ref\">中间模型</span></a> 实例指定值。你可以使用可调用对象作为 <code class=\"docutils literal notranslate\">through_defaults</code> 字典中的值。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.fields.related.RelatedManager.remove\">\n<span class=\"sig-name descname\">remove</span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"o\">*</span>objs</em>, <em class=\"sig-param\">bulk<span class=\"o\">=</span><span class=\"default_value\">True</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.db.models.fields.related.RelatedManager.remove\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.fields.related.RelatedManager.aremove\">\n<span class=\"sig-name descname\">aremove</span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"o\">*</span>objs</em>, <em class=\"sig-param\">bulk<span class=\"o\">=</span><span class=\"default_value\">True</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.db.models.fields.related.RelatedManager.aremove\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>异步版本</em>: <code class=\"docutils literal notranslate\">aremove</code></p>\n<p>从相关对象集中删除指定的模型对象：</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span>b <span class=\"o\">=</span> Blog<span class=\"o\">.</span>objects<span class=\"o\">.</span>get<span class=\"p\">(</span><span class=\"nb\">id</span><span class=\"o\">=</span><span class=\"mi\">1</span><span class=\"p\">)</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>e <span class=\"o\">=</span> Entry<span class=\"o\">.</span>objects<span class=\"o\">.</span>get<span class=\"p\">(</span><span class=\"nb\">id</span><span class=\"o\">=</span><span class=\"mi\">234</span><span class=\"p\">)</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>b<span class=\"o\">.</span>entry_set<span class=\"o\">.</span>remove<span class=\"p\">(</span>e<span class=\"p\">)</span>  <span class=\"c1\"># Disassociates Entry e from Blog b.</span>\n</code></pre></div>\n<p>与 <a class=\"reference internal\" href=\"#django.db.models.fields.related.RelatedManager.add\" title=\"django.db.models.fields.related.RelatedManager.add\"><code class=\"xref py py-meth docutils literal notranslate\">add()</code></a> 类似，在上面的例子中调用 <code class=\"docutils literal notranslate\">e.save()</code> 来执行更新。但是，对多对多关系使用 <code class=\"docutils literal notranslate\">remove()</code>，将使用 <a class=\"reference internal\" href=\"/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.delete\" title=\"django.db.models.query.QuerySet.delete\"><code class=\"xref py py-meth docutils literal notranslate\">QuerySet.delete()</code></a> 删除关系，这意味着没有调用模型 <code class=\"docutils literal notranslate\">save()</code> 方法；如果想在删除关系时执行自定义代码，请监听 <a class=\"reference internal\" href=\"/zh-hans/5.1/ref/signals/#django.db.models.signals.m2m_changed\" title=\"django.db.models.signals.m2m_changed\"><code class=\"xref py py-data docutils literal notranslate\">m2m_changed</code></a> 信号。</p>\n<p>对于多对多关系，<code class=\"docutils literal notranslate\">remove()</code> 接受模型实例或字段值，通常是主键，作为 <code class=\"docutils literal notranslate\">*objs</code> 参数。</p>\n<p>对于 <a class=\"reference internal\" href=\"/zh-hans/5.1/ref/models/fields/#django.db.models.ForeignKey\" title=\"django.db.models.ForeignKey\"><code class=\"xref py py-class docutils literal notranslate\">ForeignKey</code></a> 对象，只有当 <code class=\"docutils literal notranslate\">null=True</code> 时，这个方法才存在。如果相关字段不能设置为 <code class=\"docutils literal notranslate\">None</code> （<code class=\"docutils literal notranslate\">NULL</code>），那么一个对象就不能从一个关系中删除而不被添加到另一个关系中。在上面的例子中，从 <code class=\"docutils literal notranslate\">b.entry_set()</code> 中删除 <code class=\"docutils literal notranslate\">e</code> 相当于做了 <code class=\"docutils literal notranslate\">e.blog = None</code>，由于 <code class=\"docutils literal notranslate\">blog</code> <code class=\"xref py py-class docutils literal notranslate\">ForeignKey`</code> 没有 <code class=\"docutils literal notranslate\">null=True</code>，所以这是无效的。</p>\n<p>对于 <a class=\"reference internal\" href=\"/zh-hans/5.1/ref/models/fields/#django.db.models.ForeignKey\" title=\"django.db.models.ForeignKey\"><code class=\"xref py py-class docutils literal notranslate\">ForeignKey</code></a> 对象，这个方法接受一个 <code class=\"docutils literal notranslate\">bulk</code> 参数来控制如何执行操作。如果 <code class=\"docutils literal notranslate\">True</code> （默认），则使用 <code class=\"docutils literal notranslate\">QuerySet.update()</code>。如果 <code class=\"docutils literal notranslate\">bulk=False</code>，则调用每个单独模型实例的 <code class=\"docutils literal notranslate\">save()</code> 方法。这将触发 <a class=\"reference internal\" href=\"/zh-hans/5.1/ref/signals/#django.db.models.signals.pre_save\" title=\"django.db.models.signals.pre_save\"><code class=\"xref py py-data docutils literal notranslate\">pre_save</code></a> 和 <a class=\"reference internal\" href=\"/zh-hans/5.1/ref/signals/#django.db.models.signals.post_save\" title=\"django.db.models.signals.post_save\"><code class=\"xref py py-data docutils literal notranslate\">post_save</code></a> 信号，并以牺牲性能为代价。</p>\n<p>对于多对多关系，<code class=\"docutils literal notranslate\">bulk</code> 关键字参数不存在。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.fields.related.RelatedManager.clear\">\n<span class=\"sig-name descname\">clear</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">bulk<span class=\"o\">=</span><span class=\"default_value\">True</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.db.models.fields.related.RelatedManager.clear\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.fields.related.RelatedManager.aclear\">\n<span class=\"sig-name descname\">aclear</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">bulk<span class=\"o\">=</span><span class=\"default_value\">True</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.db.models.fields.related.RelatedManager.aclear\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>异步版本</em>: <code class=\"docutils literal notranslate\">aclear</code></p>\n<p>从相关对象集中删除所有对象：</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span>b <span class=\"o\">=</span> Blog<span class=\"o\">.</span>objects<span class=\"o\">.</span>get<span class=\"p\">(</span><span class=\"nb\">id</span><span class=\"o\">=</span><span class=\"mi\">1</span><span class=\"p\">)</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>b<span class=\"o\">.</span>entry_set<span class=\"o\">.</span>clear<span class=\"p\">()</span>\n</code></pre></div>\n<p>请注意，这并不会删除相关的对象——只是将它们脱离关联。</p>\n<p>和 <code class=\"docutils literal notranslate\">remove()</code> 一样，<code class=\"docutils literal notranslate\">clear()</code> 只在 <a class=\"reference internal\" href=\"/zh-hans/5.1/ref/models/fields/#django.db.models.ForeignKey\" title=\"django.db.models.ForeignKey\"><code class=\"xref py py-class docutils literal notranslate\">ForeignKey</code></a> 上可用，其中 <code class=\"docutils literal notranslate\">null=True</code>，而且它还接受 <code class=\"docutils literal notranslate\">bulk</code> 关键字参数。</p>\n<p>对于多对多关系，<code class=\"docutils literal notranslate\">bulk</code> 关键字参数不存在。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.fields.related.RelatedManager.set\">\n<span class=\"sig-name descname\">set</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">objs</em>, <em class=\"sig-param\">bulk<span class=\"o\">=</span><span class=\"default_value\">True</span></em>, <em class=\"sig-param\">clear<span class=\"o\">=</span><span class=\"default_value\">False</span></em>, <em class=\"sig-param\">through_defaults<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.db.models.fields.related.RelatedManager.set\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.fields.related.RelatedManager.aset\">\n<span class=\"sig-name descname\">aset</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">objs</em>, <em class=\"sig-param\">bulk<span class=\"o\">=</span><span class=\"default_value\">True</span></em>, <em class=\"sig-param\">clear<span class=\"o\">=</span><span class=\"default_value\">False</span></em>, <em class=\"sig-param\">through_defaults<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.db.models.fields.related.RelatedManager.aset\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>异步版本</em>: <code class=\"docutils literal notranslate\">aset</code></p>\n<p>替换相关对象的集合：</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span>new_list <span class=\"o\">=</span> <span class=\"p\">[</span>obj1<span class=\"p\">,</span> obj2<span class=\"p\">,</span> obj3<span class=\"p\">]</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>e<span class=\"o\">.</span>related_set<span class=\"o\">.</span>set<span class=\"p\">(</span>new_list<span class=\"p\">)</span>\n</code></pre></div>\n<p>本方法接受一个 <code class=\"docutils literal notranslate\">clear</code> 参数来控制如何执行操作。如果 <code class=\"docutils literal notranslate\">False</code> （默认），则使用 <code class=\"docutils literal notranslate\">remove()</code> 删除新集合中缺少的元素，只添加新元素。如果 <code class=\"docutils literal notranslate\">clear=True</code>，则调用 <code class=\"docutils literal notranslate\">clear()</code> 方法，一次性添加整个集合。</p>\n<p>对于 <a class=\"reference internal\" href=\"/zh-hans/5.1/ref/models/fields/#django.db.models.ForeignKey\" title=\"django.db.models.ForeignKey\"><code class=\"xref py py-class docutils literal notranslate\">ForeignKey</code></a> 对象，<code class=\"docutils literal notranslate\">bulk</code> 参数被传递给 <a class=\"reference internal\" href=\"#django.db.models.fields.related.RelatedManager.add\" title=\"django.db.models.fields.related.RelatedManager.add\"><code class=\"xref py py-meth docutils literal notranslate\">add()</code></a> 和 <a class=\"reference internal\" href=\"#django.db.models.fields.related.RelatedManager.remove\" title=\"django.db.models.fields.related.RelatedManager.remove\"><code class=\"xref py py-meth docutils literal notranslate\">remove()</code></a>。</p>\n<p>对于多对多关系，<code class=\"docutils literal notranslate\">bulk</code> 关键字参数不存在。</p>\n<p>请注意，由于 <code class=\"docutils literal notranslate\">set()</code> 是一个复合操作，它受到竞争条件的影响。例如，在调用 <code class=\"docutils literal notranslate\">clear()</code> 和调用 <code class=\"docutils literal notranslate\">add()</code> 之间可能会向数据库中添加新的对象。</p>\n<p>对于多对多关系，<code class=\"docutils literal notranslate\">set()</code> 接受一个模型实例或字段值的列表，通常是主键，作为 <code class=\"docutils literal notranslate\">objs</code> 参数。</p>\n<p>如果需要的话，使用 <code class=\"docutils literal notranslate\">through_defaults</code> 参数为新的 <a class=\"reference internal\" href=\"/zh-hans/5.1/topics/db/models/#intermediary-manytomany\"><span class=\"std std-ref\">中间模型</span></a> 实例指定值。你可以使用可调用对象作为 <code class=\"docutils literal notranslate\">through_defaults</code> 字典中的值，它们将在创建任何中间实例之前被执行一次。</p>\n</dd></dl>\n\n<aside class=\"admonition admonition-note\" role=\"note\">\n<p class=\"admonition-title\">Note</p>\n<p>请注意，<code class=\"docutils literal notranslate\">add()</code>, <code class=\"docutils literal notranslate\">aadd()</code>, <code class=\"docutils literal notranslate\">create()</code>, <code class=\"docutils literal notranslate\">acreate()</code>, <code class=\"docutils literal notranslate\">remove()</code>, <code class=\"docutils literal notranslate\">aremove()</code>, <code class=\"docutils literal notranslate\">clear()</code>, <code class=\"docutils literal notranslate\">aclear()</code>, <code class=\"docutils literal notranslate\">set()</code>, 和 <code class=\"docutils literal notranslate\">aset()</code> 对于所有类型的相关字段都会立即应用数据库更改。换句话说，在关系的两端都不需要调用 <code class=\"docutils literal notranslate\">save()</code>/<code class=\"docutils literal notranslate\">asave()</code>。</p>\n<p>如果你使用 <a class=\"reference internal\" href=\"/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.prefetch_related\" title=\"django.db.models.query.QuerySet.prefetch_related\"><code class=\"xref py py-meth docutils literal notranslate\">prefetch_related()</code></a>，那么 <code class=\"docutils literal notranslate\">add()</code>, <code class=\"docutils literal notranslate\">aadd()</code>, <code class=\"docutils literal notranslate\">remove()</code>, <code class=\"docutils literal notranslate\">aremove()</code>, <code class=\"docutils literal notranslate\">clear()</code>, <code class=\"docutils literal notranslate\">aclear()</code>, <code class=\"docutils literal notranslate\">set()</code>, 和 <code class=\"docutils literal notranslate\">aset()</code> 方法会清除预取的缓存。</p>\n</aside>\n</dd></dl>","rootId":"related-objects-reference","toc":[],"breadcrumbs":[{"docname":"ref/index","title":"API 参考","url":"/zh-hans/5.1/ref/"},{"docname":"ref/models/index","title":"模型","url":"/zh-hans/5.1/ref/models/"}],"prev":{"docname":"ref/models/meta","title":"模型 _meta API","url":"/zh-hans/5.1/ref/models/meta/"},"next":{"docname":"ref/models/class","title":"模型类参考","url":"/zh-hans/5.1/ref/models/class/"},"formats":{"html":"/zh-hans/5.1/ref/models/relations/","markdown":"/zh-hans/5.1/ref/models/relations.md","json":"/zh-hans/5.1/ref/models/relations.json"},"source":"https://github.com/django/django/blob/stable/5.1.x/docs/ref/models/relations.txt","official":"https://docs.djangoproject.com/zh-hans/5.1/ref/models/relations/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}