LINQ to SQL 物件模型

更新： November 2007

在 LINQ to SQL 中，以開發人員之程式語言表示的物件模型 (Object Model) 會對應至關聯式資料庫的資料模型。然後就會根據物件模型對資料執行作業。

在這種情況下，您不會發出資料庫命令 (例如，INSERT) 至資料庫。而是在您的物件模型中變更值和執行方法。當您要查詢資料庫或將變更傳送至資料庫時，LINQ to SQL 會將您的要求轉譯為正確的 SQL 命令，並將這些命令傳送至資料庫。

下表摘要說明 LINQ to SQL 物件模型中最基本的項目，以及其與關聯式資料模型中項目的關聯性：

LINQ to SQL 物件模型	關聯式資料模型
實體類別	資料表
類別成員	資料行
關聯	外部索引鍵關聯性
方法	預存程序或函式

注意事項：
下列說明假設您對於關聯式資料模型和規則有基本知識。

LINQ to SQL 實體類別和資料庫資料表

在 LINQ to SQL 中，資料庫資料表是由「實體類別」(Entity Class) 所表示。實體類別就像您可能建立的任何其他類別，但您會使用能讓類別與資料庫資料表產生關聯的特殊資訊來標註此類別。您可將自訂屬性 (TableAttribute) 加入至您的類別宣告，藉以產生此附註，如下列範例所示：

範例

<Table(Name:="Customers")> _
Public Class Customer
    Public CustomerID As String
    ' ...
    Public City As String
End Class

[Table(Name = "Customers")]
public class Customerzz
{
    public string CustomerID;
    // ...
    public string City;
}

只有宣告為資料表的類別執行個體 (也就是實體類別) 可以儲存至資料庫。

如需詳細資訊，請參閱以屬性為基礎的對應 (LINQ to SQL) 的＜資料表屬性＞一節。

LINQ to SQL 類別成員和資料庫資料行

除了使類別和資料表產生關聯以外，您還會指定欄位或屬性，以表示資料庫資料行。基於這個目的，LINQ to SQL 會定義 ColumnAttribute 屬性，如下列範例所示：

範例

<Table(Name:="Customers")> _
Public Class Customer
    <Column(IsPrimaryKey:=True)> _
    Public CustomerID As String

    <Column()> _
    Public City As String
End Class

[Table(Name = "Customers")]
public class Customer
{
    [Column(IsPrimaryKey = true)]
    public string CustomerID;
    [Column]
    public string City;
}

只有對應到資料行的欄位和屬性會保存至資料庫或自資料庫擷取。至於未宣告為資料行者，則會被視為應用程式邏輯的暫時性部分。

ColumnAttribute 屬性 (Attribute) 具有各種屬性 (Property)，您可以用於自訂表示資料行的這些成員 (例如，指定成員以表示主索引鍵資料行)。如需詳細資訊，請參閱以屬性為基礎的對應 (LINQ to SQL) 的＜資料行屬性＞一節。

LINQ to SQL 關聯和資料庫外部索引鍵關聯性

在 LINQ to SQL 中，您可藉由套用 AssociationAttribute 屬性來表示資料庫關聯 (例如，外部索引鍵和主索引鍵的關聯性)。在下列程式碼區段中，Order 類別包含具有 AssociationAttribute 屬性 (Attribute) 的 Customer 屬性 (Property)。這個屬性 (Property) 與其屬性 (Attribute) 提供了與 Customer 類別有關的 Order 類別。

下列程式碼範例顯示 Order 類別中的 Customer 屬性 (Property)。

範例

   <Association(Name:="FK_Orders_Customers", Storage:="_Customer", ThisKey:="CustomerID", IsForeignKey:=true)>  _
    Public Property Customer() As Customer
        Get
            Return Me._Customer.Entity
        End Get
        Set
            Dim previousValue As Customer = Me._Customer.Entity
            If (((previousValue Is value)  _
                        = false)  _
                        OrElse (Me._Customer.HasLoadedOrAssignedValue = false)) Then
                Me.SendPropertyChanging
                If ((previousValue Is Nothing)  _
                            = false) Then
                    Me._Customer.Entity = Nothing
                    previousValue.Orders.Remove(Me)
                End If
                Me._Customer.Entity = value
                If ((value Is Nothing)  _
                            = false) Then
                    value.Orders.Add(Me)
                    Me._CustomerID = value.CustomerID
                Else
                    Me._CustomerID = CType(Nothing, String)
                End If
                Me.SendPropertyChanged("Customer")
            End If
        End Set
    End Property

 [Association(Name="FK_Orders_Customers", Storage="_Customer", ThisKey="CustomerID", IsForeignKey=true)]
    public Customer Customer
    {
        get
        {
            return this._Customer.Entity;
        }
        set
        {
            Customer previousValue = this._Customer.Entity;
            if (((previousValue != value) 
                        || (this._Customer.HasLoadedOrAssignedValue == false)))
            {
                this.SendPropertyChanging();
                if ((previousValue != null))
                {
                    this._Customer.Entity = null;
                    previousValue.Orders.Remove(this);
                }
                this._Customer.Entity = value;
                if ((value != null))
                {
                    value.Orders.Add(this);
                    this._CustomerID = value.CustomerID;
                }
                else
                {
                    this._CustomerID = default(string);
                }
                this.SendPropertyChanged("Customer");
            }
        }
    }

如需詳細資訊，請參閱以屬性為基礎的對應 (LINQ to SQL) 的＜關聯屬性＞一節。

LINQ to SQL 方法和資料庫預存程序

LINQ to SQL 支援預存程序和使用者定義函式。在 LINQ to SQL 中，您可將這些資料庫定義的抽象對應至用戶端物件，便可以強型別的方式從用戶端程式碼存取這些抽象。方法簽章與資料庫中定義的程序和函式簽章十分相似。您可以使用 IntelliSense 來探索這些方法。

呼叫對應程序所傳回的結果集是強型別集合。

LINQ to SQL 會使用 FunctionAttribute 和 ParameterAttribute 屬性，將預存程序和函式對應至方法。IsComposable 屬性可以區分表示預存程序的方法和表示使用者定義函式的方法。如果此屬性設為 false (預設值)，則此方法表示預存程序。如果設為 true，則此方法表示資料庫函式。

注意事項：
如果您使用的是 Visual Studio，就可以使用物件關聯式設計工具來建立對應至預存程序和使用者定義函式的方法。

範例

   ' This is an example of a stored procedure in the Northwind
   ' sample database. The IsComposable property defaults to false.
   <FunctionAttribute(Name:="dbo.CustOrderHist")> _
Public Function CustOrderHist(<Parameter(Name:="CustomerID", DbType:="NChar(5)")> ByVal customerID As String) As ISingleResult(Of CustOrderHistResult)
       Dim result As IExecuteResult = Me.ExecuteMethodCall(Me, CType(MethodInfo.GetCurrentMethod, MethodInfo), customerID)
       Return CType(result.ReturnValue, ISingleResult(Of CustOrderHistResult))
   End Function

    // This is an example of a stored procedure in the Northwind
    // sample database. The IsComposable property defaults to false.
    [Function(Name="dbo.CustOrderHist")]
    public ISingleResult<CustOrderHistResult> CustOrderHist([Parameter(Name="CustomerID", DbType="NChar(5)")] string customerID)
    {
        IExecuteResult result = this.ExecuteMethodCall(this, ((MethodInfo)(MethodInfo.GetCurrentMethod())), customerID);
        return ((ISingleResult<CustOrderHistResult>)(result.ReturnValue));
    }

如需詳細資訊，請參閱以屬性為基礎的對應 (LINQ to SQL) 和預存程序 (LINQ to SQL) 的＜函式屬性＞、＜預存程序屬性＞和＜參數屬性＞各節。

請參閱

參考

以屬性為基礎的對應 (LINQ to SQL)

其他資源

背景資訊 (LINQ to SQL)