ObjectContext.CreateEntityKey(String, Object) メソッド

定義

名前空間:
System.Data.Objects
アセンブリ:
System.Data.Entity.dll

特定のオブジェクトのエンティティ キーを作成するか、エンティティ キーが既に存在する場合は返します。

public:
 System::Data::EntityKey ^ CreateEntityKey(System::String ^ entitySetName, System::Object ^ entity);
public System.Data.EntityKey CreateEntityKey(string entitySetName, object entity);
member this.CreateEntityKey : string * obj -> System.Data.EntityKey
Public Function CreateEntityKey (entitySetName As String, entity As Object) As EntityKey

パラメーター

entitySetName
String

エンティティ オブジェクトが属するエンティティ セットの完全修飾名。

entity
Object

エンティティ キーを取得する対象のオブジェクト。

返品

EntityKey

オブジェクトの EntityKey 。

例外

ArgumentNullException

いずれかのパラメーターが null場合。

ArgumentException

entitySetNameが空の場合。

-又は-

entity オブジェクトの型がエンティティ セットに存在しない場合。

-又は-

entitySetNameが完全修飾されていない場合。

InvalidOperationException

指定されたパラメーターに基づいてエンティティ キーを正常に構築できない場合。

例

この例では、 CreateEntityKey を使用して、既存のオブジェクトのエンティティ キーを取得します。

private static void ApplyItemUpdates(SalesOrderDetail updatedItem)
{
    // Define an ObjectStateEntry and EntityKey for the current object.
    EntityKey key = default(EntityKey);
    object originalItem = null;

    using (AdventureWorksEntities context = new AdventureWorksEntities())
    {
        // Create the detached object's entity key.
        key = context.CreateEntityKey("SalesOrderDetails", updatedItem);

        // Get the original item based on the entity key from the context
        // or from the database.
        if (context.TryGetObjectByKey(key, out originalItem))
        {
            // Call the ApplyCurrentValues method to apply changes
            // from the updated item to the original version.
            context.ApplyCurrentValues(key.EntitySetName, updatedItem);
        }

        context.SaveChanges();
    }
}

注釈

entityのEntityKeyが存在しない場合、CreateEntityKey メソッドによって新しいキーが作成されます。

このメソッドは、同じ EntityKey を持つオブジェクトが既に ObjectContextにアタッチされているかどうかを判断するために使用されます。 同じ EntityKey を持つオブジェクトが既にアタッチされている場合は、例外が発生します。 Attach メソッドを呼び出す前に、CreateEntityKey メソッドを使用してデタッチされたオブジェクトのEntityKeyを取得します。

適用対象