HOW TO：以自訂物件使用物件服務 (Entity Framework)

發行項
08/21/2008

即使您使用自訂資料類別，仍然可以利用由 Entity Framework 工具產生的資料類所別提供的物件服務功能。這包括下列功能：

具現化 Entity Data Model (EDM) 特有之 ObjectContext (包括預先定義的連接) 的功能。
可傳回型別特有 ObjectQuery 物件的屬性。
將物件加入至特定實體集的自訂方法。

充分運用物件服務功能最簡單的辦法就是將產生的類別 (繼承自 ObjectContext) 加入到您的專案。這個類別是根據您的 EDM 由 Entity Framework 工具所產生的。

若要在 C# 專案中使用產生的物件程式碼

從命令提示字元，巡覽至模型之概念結構定義語言 (CSDL) 檔案的位置，然後執行下列命令並移除分行符號：
```
%windir%\Microsoft.NET\Framework\v3.5\edmgen.exe /mode:EntityClassGeneration 
/incsdl:.\YourModel.csdl /outobjectlayer:.\YourModel.context.cs /language:CSharp
```
這樣會根據指定的 CSDL 檔案，使用 C# 重新產生物件層。
開啟新產生的程式碼檔案、複製繼承自 ObjectContext 的類別，然後將這個類別貼入自訂資料類別程式碼檔案中。

附註

您也可以移除這些資料類別並將其餘類別加入至專案。

附註
您也可以移除這些資料類別並將其餘類別加入至專案。

若要在 Visual Basic 專案中使用產生的物件程式碼

從命令提示字元，巡覽至模型之 CSDL 檔案的位置，然後執行下列命令並移除分行符號：
```
%windir%\Microsoft.NET\Framework\v3.5\edmgen.exe /mode:EntityClassGeneration 
/incsdl:.\YourModel.csdl /outobjectlayer:.\YourModel.context.vb /language:VB
```
這樣會根據指定的 CSDL 檔案，使用 Visual Basic 重新產生物件層。
開啟新產生的程式碼檔案、複製繼承自 ObjectContext 的類別，然後將這個類別貼入自訂資料類別程式碼檔案中。

附註

您也可以移除這些資料類別並將其餘類別加入至專案。

附註
您也可以移除這些資料類別並將其餘類別加入至專案。

範例

這個範例會說明支援 Order 和 LineItem 自訂資料類別的產生物件內容程式碼。

Option Strict Off
Option Explicit On

<Assembly: Global.System.Data.Objects.DataClasses.EdmSchemaAttribute("9f3bb474-6454-4ff1-911e-4a8be227e97c")> 

Namespace Microsoft.Samples.Edm
    '''<summary>
    '''There are no comments for SalesOrdersEntities in the schema.
    '''</summary>
    Partial Public Class SalesOrdersEntities
        Inherits Global.System.Data.Objects.ObjectContext
        '''<summary>
        '''Initializes a new SalesOrdersEntities object using the connection string found in the 'SalesOrdersEntities' section of the application configuration file.
        '''</summary>
        Public Sub New()
            MyBase.New("name=SalesOrdersEntities", "SalesOrdersEntities")
        End Sub
        '''<summary>
        '''Initialize a new SalesOrdersEntities object.
        '''</summary>
        Public Sub New(ByVal connectionString As String)
            MyBase.New(connectionString, "SalesOrdersEntities")
        End Sub
        '''<summary>
        '''Initialize a new SalesOrdersEntities object.
        '''</summary>
        Public Sub New(ByVal connection As Global.System.Data.EntityClient.EntityConnection)
            MyBase.New(connection, "SalesOrdersEntities")
        End Sub
        '''<summary>
        '''There are no comments for LineItem in the schema.
        '''</summary>
        <Global.System.ComponentModel.BrowsableAttribute(False)> _
        Public ReadOnly Property LineItem() As Global.System.Data.Objects.ObjectQuery(Of LineItem)
            Get
                If (Me._LineItem Is Nothing) Then
                    Me._LineItem = MyBase.CreateQuery(Of LineItem)("[LineItem]")
                End If
                Return Me._LineItem
            End Get
        End Property
        Private _LineItem As Global.System.Data.Objects.ObjectQuery(Of LineItem) = Nothing
        '''<summary>
        '''There are no comments for Order in the schema.
        '''</summary>
        <Global.System.ComponentModel.BrowsableAttribute(False)> _
        Public ReadOnly Property Order() As Global.System.Data.Objects.ObjectQuery(Of Order)
            Get
                If (Me._Order Is Nothing) Then
                    Me._Order = MyBase.CreateQuery(Of Order)("[Order]")
                End If
                Return Me._Order
            End Get
        End Property
        Private _Order As Global.System.Data.Objects.ObjectQuery(Of Order) = Nothing
        '''<summary>
        '''There are no comments for LineItem in the schema.
        '''</summary>
        Public Sub AddToLineItem(ByVal lineItem As LineItem)
            MyBase.AddObject("LineItem", lineItem)
        End Sub
        '''<summary>
        '''There are no comments for Order in the schema.
        '''</summary>
        Public Sub AddToOrder(ByVal order As Order)
            MyBase.AddObject("Order", order)
        End Sub
    End Class
End Namespace

[assembly: System.Data.Objects.DataClasses.EdmSchemaAttribute()]

namespace Microsoft.Samples.Edm
{

    /// <summary>
    /// There are no comments for SalesOrdersEntities in the schema.
    /// </summary>
    public partial class SalesOrdersEntities : global::System.Data.Objects.ObjectContext
    {
        /// <summary>
        /// Initializes a new SalesOrdersEntities object using the connection string found in the 'SalesOrdersEntities' section of the application configuration file.
        /// </summary>
        public SalesOrdersEntities() :
            base("name=SalesOrdersEntities", "SalesOrdersEntities")
        {
        }
        /// <summary>
        /// Initialize a new SalesOrdersEntities object.
        /// </summary>
        public SalesOrdersEntities(string connectionString) :
            base(connectionString, "SalesOrdersEntities")
        {
        }
        /// <summary>
        /// Initialize a new SalesOrdersEntities object.
        /// </summary>
        public SalesOrdersEntities(global::System.Data.EntityClient.EntityConnection connection) :
            base(connection, "SalesOrdersEntities")
        {
        }
        /// <summary>
        /// There are no comments for LineItem in the schema.
        /// </summary>
        [global::System.ComponentModel.BrowsableAttribute(false)]
        public global::System.Data.Objects.ObjectQuery<LineItem> LineItem
        {
            get
            {
                if ((this._LineItem == null))
                {
                    this._LineItem = base.CreateQuery<LineItem>("[LineItem]");
                }
                return this._LineItem;
            }
        }
        private global::System.Data.Objects.ObjectQuery<LineItem> _LineItem = null;
        /// <summary>
        /// There are no comments for Order in the schema.
        /// </summary>
        [global::System.ComponentModel.BrowsableAttribute(false)]
        public global::System.Data.Objects.ObjectQuery<Order> Order
        {
            get
            {
                if ((this._Order == null))
                {
                    this._Order = base.CreateQuery<Order>("[Order]");
                }
                return this._Order;
            }
        }
        private global::System.Data.Objects.ObjectQuery<Order> _Order = null;
        /// <summary>
        /// There are no comments for LineItem in the schema.
        /// </summary>
        public void AddToLineItem(LineItem lineItem)
        {
            base.AddObject("LineItem", lineItem);
        }
        /// <summary>
        /// There are no comments for Order in the schema.
        /// </summary>
        public void AddToOrder(Order order)
        {
            base.AddObject("Order", order);
        }
    }
}

另請參閱

HOW TO：以自訂物件使用物件服務 (Entity Framework)

若要在 C# 專案中使用產生的物件程式碼

若要在 Visual Basic 專案中使用產生的物件程式碼

範例

另請參閱

工作

參考

概念

其他資源