ObjectContext.CreateEntityKey(String, Object) Méthode

Définition

Espace de noms:
System.Data.Objects
Assembly:
System.Data.Entity.dll

Crée la clé d’entité pour un objet spécifique ou retourne la clé d’entité s’il existe déjà.

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

Paramètres

entitySetName
String

Nom complet de l’ensemble d’entités auquel appartient l’objet d’entité.

entity
Object

Objet pour lequel la clé d’entité est récupérée.

Retours

EntityKey

De EntityKey l’objet.

Exceptions

ArgumentNullException

Lorsque l’un ou l’autre paramètre est null.

ArgumentException

Quand entitySetName est vide.

- ou -

Lorsque le type de l’objet entity n’existe pas dans l’ensemble d’entités.

- ou -

Lorsque l’élément entitySetName n’est pas complet.

InvalidOperationException

Lorsque la clé d’entité ne peut pas être construite avec succès en fonction des paramètres fournis.

Exemples

Dans cet exemple, CreateEntityKey est utilisé pour récupérer la clé d’entité d’un objet existant.

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();
    }
}

Remarques

EntityKey S’il n’existe pas pour le entity, la CreateEntityKey méthode crée une nouvelle clé pour celle-ci.

Cette méthode est utilisée pour déterminer si un objet qui a le même EntityKey objet est déjà attaché au ObjectContext. Si un objet qui a le même EntityKey objet est déjà attaché, une exception est levée. Utilisez la CreateEntityKey méthode pour essayer de récupérer l’objet EntityKey détaché avant d’appeler la Attach méthode.

S’applique à