ObjectContext.ApplyOriginalValues<TEntity>(String, TEntity) 方法

定義

命名空間:

System.Data.Objects

組件:

System.Data.Entity.dll

從提供的物件將純量值複製至 ObjectContext 中具有相同索引鍵之物件的原始值組。

public:
generic <typename TEntity>
 where TEntity : class TEntity ApplyOriginalValues(System::String ^ entitySetName, TEntity originalEntity);

public TEntity ApplyOriginalValues<TEntity> (string entitySetName, TEntity originalEntity) where TEntity : class;

member this.ApplyOriginalValues : string * 'Entity -> 'Entity (requires 'Entity : null)

Public Function ApplyOriginalValues(Of TEntity As Class) (entitySetName As String, originalEntity As TEntity) As TEntity

類型參數

TEntity

實體物件的型別。

參數

entitySetName

String

此物件所屬之實體集的名稱。

originalEntity

TEntity

具有要套用至物件之原始值的已中斷連結物件。 originalEntity 的實體索引鍵必須符合 EntityKey 中項目的 ObjectContext 屬性。

傳回

TEntity

更新的物件。

例外狀況

ArgumentNullException

entitySetName 或 original 為 null。

InvalidOperationException

entitySetName 的 EntitySet 不符合物件之 EntityKey 的 EntitySet。

-或-

ObjectStateEntry 中找不到物件的 ObjectStateManager。 -或-

物件處於 Added 或 Detached 狀態。

-或-

提供物件的實體索引鍵無效，或有屬性變更。

ArgumentException

entitySetName 為空字串。

備註

方法 ApplyOriginalValues 可用來套用對 外部 ObjectContext物件所做的變更，例如 Web 服務所接收的中斷鏈接物件。 方法會將提供的物件中的純量值複製到具有相同索引鍵的 ObjectContext 物件中。 您可以使用 EntityKey 卸離物件的 ，從數據源擷取這個物件的實例。 如需詳細資訊，請參閱 如何：使用其索引鍵傳回特定物件。 與物件目前值不同的任何值都會標示為已修改。 請注意，方法不會將目前的值套用至 的相關 originalEntity物件。

如果您有具有原始值的圖表，而且想要套用目前的值，請呼叫 ApplyCurrentValues 方法。

您也可以使用 ApplyOriginalValuesObjectSet<TEntity> 的ObjectStateEntry或 ApplyOriginalValues 方法。 如需詳細資訊，請參閱建置多層式架構應用程式。

另請參閱

• ApplyOriginalValues(TEntity)
• ApplyOriginalValues(Object)