Table<TEntity>.Attach Table<TEntity>.Attach Table<TEntity>.Attach Table<TEntity>.Attach Method

Definizione

Associa un'entità a DataContext.Attaches an entity to the DataContext.

Overload

Attach(TEntity) Attach(TEntity) Attach(TEntity) Attach(TEntity)

Associa un’entità scollegata o "disconnessa" a un oggetto DataContext nuovo quando sono necessari valori originali per i controlli di concorrenza ottimistica.Attaches a disconnected or "detached" entity to a new DataContext when original values are required for optimistic concurrency checks.

Attach(TEntity, Boolean) Attach(TEntity, Boolean) Attach(TEntity, Boolean) Attach(TEntity, Boolean)

Associa un'entità a DataContext in uno stato modificato o non modificato.Attaches an entity to the DataContext in either a modified or unmodified state.

Attach(TEntity, TEntity) Attach(TEntity, TEntity) Attach(TEntity, TEntity) Attach(TEntity, TEntity)

Associa un'entità a DataContext in uno stato modificato o non modificato specificando l'entità e lo stato originale.Attaches an entity to the DataContext in either a modified or unmodified state by specifying both the entity and its original state.

Commenti

Usare i Attach metodi con le entità create in uno DataContext, serializzate in un client, quindi deserializzate (con l'intenzione di eseguire un'operazione di aggiornamento o eliminazione).Use the Attach methods with entities that have been created in one DataContext, serialized to a client, and then deserialized back (with the intention to perform an update or delete operation). Per ulteriori informazioni, vedere recupero di dati e operazioni CUD in applicazioni a più livelli (LINQ to SQL).For more information, see Data Retrieval and CUD Operations in N-Tier Applications (LINQ to SQL).

Non tentare di eseguire Attach un'entità che non è stata scollegata tramite la serializzazione.Do not try to Attach an entity that has not been detached through serialization. Le entità che non sono state serializzate mantengono ancora le associazioni con caricatori posticipati che possono provocare risultati imprevisti se l'entità viene rilevata da un secondo contesto dati.Entities that have not been serialized still maintain associations with deferred loaders that can cause unexpected results if the entity becomes tracked by a second data context.

Quando viene associata una nuova entità, vengono inizializzati i caricatori posticipati per tutte le raccolte figlio EntitySet , ad esempio raccolte di entità dalle tabelle associate.When a new entity is attached, deferred loaders for any child collections (for example, EntitySet collections of entities from associated tables) are initialized. Quando SubmitChanges viene chiamato il metodo, i membri delle raccolte figlio vengono inseriti Unmodified in uno stato.When SubmitChanges is called, members of the child collections are put into an Unmodified state. Per aggiornare i membri di una raccolta figlio, è necessario chiamare Attach in modo esplicito e specificare tale entità.To update members of a child collection, you must explicitly call Attach and specify that entity.

Attachconnette tutte le entità nell'oggetto grafico dell'oggetto specificato.Attach attaches all entities in the object graph of the provided object. Ad esempio, il codice C# seguente:For example, the following C# code:

using (SampleDataContext db = new SampleDataContext()) {  
    Employee employee = new Employee { employeeId = 1 };  

    Master master = new Master();  
    master.Employee = employee;  

    Child child = new Child();  
    child.Employee = employee;  

    db.Employees.Attach(employee);  

    master.Child = child;  

    db.Masters.InsertOnSubmit(master);  

    db.SubmitChanges();  
}  

Il codice Visual Basic equivalente è:The equivalent Visual Basic code is:

Using db As New SampleDataContext()    Dim employee As New Employee With { .employeeId = 1 }  

    Dim master As New Master()  
    master.Employee = employee  

    Dim child As New Child()  
    child.Employee = employee  

    db.Employees.Attach(employee)  

    master.Child = child  

    db.Masters.InsertOnSubmit(master)  

    db.SubmitChanges()  

End Using  

La Attach chiamata Employee di su consente di alleghi dipendenti, Master e figlio Employee , in quanto dispone di relazioni con il master e il figlio.Calling Attach on Employee attaches employee, master, and child, because the Employee has relationships to both master and child. È necessario chiamare InsertOnSubmit in modo esplicito per modificare lo stato da allegato a inserito.You must explicitly call InsertOnSubmit to change the state from attached to inserted.

Attach(TEntity) Attach(TEntity) Attach(TEntity) Attach(TEntity)

Associa un’entità scollegata o "disconnessa" a un oggetto DataContext nuovo quando sono necessari valori originali per i controlli di concorrenza ottimistica.Attaches a disconnected or "detached" entity to a new DataContext when original values are required for optimistic concurrency checks.

public:
 virtual void Attach(TEntity entity);
public void Attach (TEntity entity);
abstract member Attach : 'Entity -> unit
override this.Attach : 'Entity -> unit
Public Sub Attach (entity As TEntity)

Parametri

entity
TEntity TEntity TEntity TEntity

Valori originali dell'entità da associare.The original values of the entity to be attached.

Commenti

Usare i Attach metodi con le entità create in uno DataContext, serializzate in un client, quindi deserializzate per eseguire un'operazione di aggiornamento o eliminazione.Use the Attach methods with entities that have been created in one DataContext, serialized to a client, and then deserialized back to perform an update or delete operation. Poiché il nuovo DataContext non è in grado di tenere traccia dei valori originali per un'entità disconnessa, il client è responsabile di fornire tali valori.Because the new DataContext has no way of tracking what the original values were for a disconnected entity, the client is responsible for supplying those values. In questa versione di Attach, si presuppone che l'entità si trovi nello stato del valore originale.In this version of Attach, the entity is assumed to be in its original value state. Dopo aver chiamato questo metodo, è possibile aggiornare i relativi campi, ad esempio con dati aggiuntivi inviati dal client.After calling this method, you can then update its fields, for example with additional data sent from the client.

Quando viene associata una nuova entità, vengono inizializzati i caricatori posticipati per tutte le raccolte figlio EntitySet , ad esempio raccolte di entità dalle tabelle associate.When a new entity is attached, deferred loaders for any child collections (for example, EntitySet collections of entities from associated tables) are initialized. Quando SubmitChanges viene chiamato il metodo, i membri delle raccolte figlio vengono inseriti Unmodified in uno stato.When SubmitChanges is called, members of the child collections are put into an Unmodified state. Per aggiornare i membri di una raccolta figlio, è necessario chiamare Attach in modo esplicito e specificare tale entità.To update members of a child collection, you must explicitly call Attach and specify that entity.

Per ulteriori informazioni, vedere recupero di dati e operazioni CUD in applicazioni a più livelli (LINQ to SQL).For more information, see Data Retrieval and CUD Operations in N-Tier Applications (LINQ to SQL).

Non tentare di eseguire Attach un'entità che non è stata scollegata tramite la serializzazione.Do not try to Attach an entity that has not been detached through serialization. Le entità che non sono state serializzate mantengono ancora le associazioni con caricatori posticipati che possono provocare risultati imprevisti se l'entità viene rilevata da un secondo contesto dati.Entities that have not been serialized still maintain associations with deferred loaders that can cause unexpected results if the entity becomes tracked by a second data context.

Attach(TEntity, Boolean) Attach(TEntity, Boolean) Attach(TEntity, Boolean) Attach(TEntity, Boolean)

Associa un'entità a DataContext in uno stato modificato o non modificato.Attaches an entity to the DataContext in either a modified or unmodified state.

public:
 void Attach(TEntity entity, bool asModified);
public void Attach (TEntity entity, bool asModified);
member this.Attach : 'Entity * bool -> unit
Public Sub Attach (entity As TEntity, asModified As Boolean)

Parametri

entity
TEntity TEntity TEntity TEntity

Entità da associare.The entity to be attached.

asModified
Boolean Boolean Boolean Boolean

true per associare l'entità come modificata; false per associare l'entità come invariata.true to attach the entity as modified; false to attach the entity as unmodified.

Commenti

Se la connessione viene modificata, l'entità deve dichiarare un membro della versione o non deve partecipare al controllo dei conflitti di aggiornamento.If attaching as modified, the entity must either declare a version member or must not participate in update conflict checking. Quando viene associata una nuova entità, vengono inizializzati i caricatori posticipati per tutte le raccolte figlio EntitySet , ad esempio raccolte di entità dalle tabelle associate.When a new entity is attached, deferred loaders for any child collections (for example, EntitySet collections of entities from associated tables) are initialized. Quando SubmitChanges viene chiamato il metodo, i membri delle raccolte figlio vengono inseriti Unmodified in uno stato.When SubmitChanges is called, members of the child collections are put into an Unmodified state. Per aggiornare i membri di una raccolta figlio, è necessario chiamare Attach in modo esplicito e specificare tale entità.To update members of a child collection, you must explicitly call Attach and specify that entity.

Attach(TEntity, TEntity) Attach(TEntity, TEntity) Attach(TEntity, TEntity) Attach(TEntity, TEntity)

Associa un'entità a DataContext in uno stato modificato o non modificato specificando l'entità e lo stato originale.Attaches an entity to the DataContext in either a modified or unmodified state by specifying both the entity and its original state.

public:
 void Attach(TEntity entity, TEntity original);
public void Attach (TEntity entity, TEntity original);
member this.Attach : 'Entity * 'Entity -> unit
Public Sub Attach (entity As TEntity, original As TEntity)

Parametri

entity
TEntity TEntity TEntity TEntity

Entità da associare.The entity to be attached.

original
TEntity TEntity TEntity TEntity

Istanza dello stesso tipo di entità con membri dati che contengono i valori originali.An instance of the same entity type with data members that contain the original values.

Esempi

using (Northwnd db2 = new Northwnd(@"c:\northwnd.mdf"))
{
    Customer Cust_File = new Customer();
    string xmlFile = "";
    
    // Get the original object from the deserializer.
    Customer c = SerializeHelper.Deserialize<Customer>
        (xmlFile, Cust_File);

    // Set all the desired properties to the entity to be attached.
    Customer c_updated = new Customer() { CustomerID = c.CustomerID,
        Phone = "425-123-4567", CompanyName = "Microsoft" };
    db2.Customers.Attach(c_updated, c);

    // Perform last minute updates, which will still take effect. 
    c_updated.Phone = "425-765-4321";

    // SubmitChanges()sets the phoneNumber and CompanyName of
    // customer with customerID=Cust. to "425-765-4321" and
    // "Microsoft" respectively.
    db2.SubmitChanges();  
}
Using db = New Northwnd("...")
    Dim Cust_File As New Customer()
    Dim xmlFile As String = ""

    'Get the original object from the deserializer.
    Dim c As Customer = SerializeHelper.Deserialize(Of Customer)(xmlFile, Cust_File)

    ' Set all the desired properties to the entity to be attached.
    Dim c_updated As New Customer With {.CustomerID = c.CustomerID, _
    .Phone = "425-123-4567", .CompanyName = "Microsoft"}
    db.Customers.Attach(c_updated, c)

    ' Perform last minute updates, which will still take effect. 
    c_updated.Phone = "425-765-4321"

    ' SubmitChanges()sets the phoneNumber and CompanyName of
    ' customer with customerID=Cust. to "425-765-4321" and
    ' "Microsoft" respectively.
    db.SubmitChanges()
End Using

Commenti

Nell'esempio seguente l' Customer oggetto è già configurato correttamente.In the following example, the Customer object is already correctly configured. È possibile chiamare Attach senza dover riprodurre gli aggiornamenti.You can call Attach without having to replay the updates.

Quando viene associata una nuova entità, vengono inizializzati i caricatori posticipati per tutte le raccolte figlio EntitySet , ad esempio raccolte di entità dalle tabelle associate.When a new entity is attached, deferred loaders for any child collections (for example, EntitySet collections of entities from associated tables) are initialized. Quando SubmitChanges viene chiamato il metodo, i membri delle raccolte figlio vengono inseriti Unmodified in uno stato.When SubmitChanges is called, members of the child collections are put into an Unmodified state. Per aggiornare i membri di una raccolta figlio, è necessario chiamare Attach in modo esplicito e specificare tale entità.To update members of a child collection, you must explicitly call Attach and specify that entity.

Si applica a