模型類別參考

本文件涵蓋 Model 類別的功能。有關模型的更多資訊，請參閱模型參考指南的完整清單。

屬性

DoesNotExist

exception Model.DoesNotExist

當找不到預期的物件時，ORM 會引發此例外。例如，當沒有找到給定查詢的物件時，QuerySet.get() 將會引發此例外。

Django 提供一個 DoesNotExist 例外，作為每個模型類別的屬性，用以識別找不到的物件類別，讓您可以針對特定的模型類別捕獲例外。此例外是 django.core.exceptions.ObjectDoesNotExist 的子類別。

MultipleObjectsReturned

exception Model.MultipleObjectsReturned

當為給定查詢找到多個物件時，QuerySet.get() 會引發此例外。

Django 提供一個 MultipleObjectsReturned 例外，作為每個模型類別的屬性，用以識別找到多個物件的物件類別，讓您可以針對特定的模型類別捕獲例外。此例外是 django.core.exceptions.MultipleObjectsReturned 的子類別。

objects

Model.objects

每個非抽象 Model 類別都必須加入一個 Manager 實例。Django 會確保您的模型類別中至少有一個指定的預設 Manager。如果您沒有新增自己的 Manager，Django 會新增一個包含預設 Manager 實例的 objects 屬性。如果您新增自己的 Manager 實例屬性，則預設屬性不會出現。請考慮以下範例

from django.db import models


class Person(models.Model):
    # Add manager with another name
    people = models.Manager()

有關模型管理器的更多詳細資訊，請參閱管理器和擷取物件。

相關物件參考
模型 Meta 選項
回到頂端