Table<TEntity>.Attach Metodo

Definizione

Spazio dei nomi:

System.Data.Linq

Assembly:

System.Data.Linq.dll

Associa un'entità a DataContext.

Overload

Attach(TEntity)	Associa un’entità scollegata o "disconnessa" a un oggetto DataContext nuovo quando sono necessari valori originali per i controlli di concorrenza ottimistica.
Attach(TEntity, Boolean)	Associa un'entità a DataContext in uno stato modificato o non modificato.
Attach(TEntity, TEntity)	Associa un'entità a DataContext in uno stato modificato o non modificato specificando l'entità e lo stato originale.

Commenti

Usare i Attach metodi con le entità create in un DataContextclient, serializzate in un client e quindi deserializzate (con l'intenzione di eseguire un'operazione di aggiornamento o eliminazione). Per altre informazioni, vedere Operazioni di recupero dati e 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 provare a un'entità Attach che non è stata scollegata tramite la serializzazione. Le entità che non sono state serializzate mantengono ancora associazioni con caricatori posticipati che possono causare risultati imprevisti se l'entità viene rilevata da un secondo contesto dati.

Quando viene associata una nuova entità, vengono inizializzati i caricatori posticipati per tutte le raccolte figlio (ad esempio raccolte EntitySet di entità da tabelle associate). Quando SubmitChanges viene chiamato, i membri delle raccolte figlio vengono inseriti in uno Unmodified stato. Per aggiornare i membri di una raccolta figlio, è necessario chiamare Attach in modo esplicito e specificare tale entità.

Attach associa tutte le entità nel grafico degli oggetti dell'oggetto specificato. Ad esempio:

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

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

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

    db.Employees.Attach(employee);  

    master.Child = child;  

    db.Masters.InsertOnSubmit(master);  

    db.SubmitChanges();  
} 

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 chiamata Attach a Employee associa dipendenti, master e figlio, perché ha relazioni sia con il master che con l'elemento Employee figlio. È necessario chiamare InsertOnSubmit in modo esplicito per modificare lo stato da associato a inserito.

Attach(TEntity)

Associa un’entità scollegata o "disconnessa" a un oggetto DataContext nuovo quando sono necessari valori originali per i controlli di concorrenza ottimistica.

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

Valori originali dell'entità da associare.

Implementazioni

Attach(TEntity)

Commenti

Usare i Attach metodi con le entità create in un DataContextclient, serializzate in un client e quindi deserializzate per eseguire un'operazione di aggiornamento o eliminazione. Poiché il nuovo DataContext non ha modo di tenere traccia dei valori originali per un'entità disconnessa, il client è responsabile della fornitura di tali valori. In questa versione di Attachsi presuppone che l'entità sia nello stato del valore originale. Dopo aver chiamato questo metodo, è possibile aggiornarne i campi, ad esempio con dati aggiuntivi inviati dal client.

Quando viene associata una nuova entità, vengono inizializzati i caricatori posticipati per tutte le raccolte figlio (ad esempio raccolte EntitySet di entità da tabelle associate). Quando SubmitChanges viene chiamato, i membri delle raccolte figlio vengono inseriti in uno Unmodified stato. Per aggiornare i membri di una raccolta figlio, è necessario chiamare Attach in modo esplicito e specificare tale entità.

Per altre informazioni, vedere Operazioni di recupero dati e 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 provare a un'entità Attach che non è stata scollegata tramite la serializzazione. Le entità che non sono state serializzate mantengono ancora associazioni con caricatori posticipati che possono causare risultati imprevisti se l'entità viene rilevata da un secondo contesto dati.

Attach(TEntity, Boolean)

Associa un'entità a DataContext in uno stato modificato o non modificato.

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

Entità da associare.

asModified

Boolean

true per associare l'entità come modificata; false per associare l'entità come invariata.

Commenti

Se il collegamento viene modificato, l'entità deve dichiarare un membro della versione o non deve partecipare al controllo dei conflitti di aggiornamento. Quando viene associata una nuova entità, vengono inizializzati i caricatori posticipati per tutte le raccolte figlio (ad esempio raccolte EntitySet di entità da tabelle associate). Quando SubmitChanges viene chiamato, i membri delle raccolte figlio vengono inseriti in uno Unmodified stato. Per aggiornare i membri di una raccolta figlio, è necessario chiamare Attach in modo esplicito e specificare tale entità.

Attach(TEntity, TEntity)

Associa un'entità a DataContext in uno stato modificato o non modificato specificando l'entità e lo stato originale.

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

Entità da associare.

original

TEntity

Istanza dello stesso tipo di entità con membri dati che contengono i valori originali.

Esempio

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'oggetto Customer è già configurato correttamente. È possibile chiamare Attach senza dover riprodurre gli aggiornamenti.

Quando viene associata una nuova entità, vengono inizializzati i caricatori posticipati per tutte le raccolte figlio (ad esempio raccolte EntitySet di entità da tabelle associate). Quando SubmitChanges viene chiamato, i membri delle raccolte figlio vengono inseriti in uno Unmodified stato. Per aggiornare i membri di una raccolta figlio, è necessario chiamare Attach in modo esplicito e specificare tale entità.