Table<TEntity>.Attach Methode

Referenz

Definition

Namespace:: System.Data.Linq

Assembly:: System.Data.Linq.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt eine Entität an den DataContext an.

Überlädt

Attach(TEntity)	Fügt eine getrennte Entität einem neuen DataContext an, wenn ursprüngliche Werte für Prüfungen der vollständigen Parallelität benötigt werden.
Attach(TEntity, Boolean)	Fügt eine Entität im veränderten oder unveränderten Zustand an den DataContext an.
Attach(TEntity, TEntity)	Fügt eine Entität im veränderten oder unveränderten Zustand an den DataContext an, indem sowohl die Entität als auch ihr ursprünglicher Zustand angegeben werden.

Hinweise

Verwenden Sie die Attach Methoden mit Entitäten, die in einem DataContexterstellt wurden, mit einem Client serialisiert und dann wieder deserialisiert wurden (mit der Absicht, einen Aktualisierungs- oder Löschvorgang auszuführen). Weitere Informationen finden Sie unter Datenabruf und CUD-Operationen in n-schichtigen Anwendungen (LINQ to SQL).

Versuchen Sie nicht, eine Entität zu Attach erstellen, die nicht über die Serialisierung getrennt wurde. Entitäten, die nicht serialisiert wurden, behalten weiterhin Zuordnungen zu verzögerten Ladeprogrammen bei, die zu unerwarteten Ergebnissen führen können, wenn die Entität von einem zweiten Datenkontext nachverfolgt wird.

Wenn eine neue Entität angefügt wird, werden verzögerte Ladeprogramme für alle untergeordneten Auflistungen (z. EntitySet B. Auflistungen von Entitäten aus zugeordneten Tabellen) initialisiert. Wenn SubmitChanges aufgerufen wird, werden Member der untergeordneten Auflistungen in einen Unmodified Zustand versetzt. Um Elemente einer untergeordneten Auflistung zu aktualisieren, müssen Sie diese Entität explizit aufrufen Attach und angeben.

Attach Fügt alle Entitäten im Objektgraphen des bereitgestellten Objekts an. Beispiel:

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

Das Aufrufen Attach von auf Employee fügt Mitarbeiter, master und untergeordnete Elemente an, da sowohl Employee beziehungen zu master als auch zu untergeordneten Elementen bestehen. Sie müssen explizit aufrufen InsertOnSubmit , um den Status von angefügt an eingefügt zu ändern.

Attach(TEntity)

Fügt eine getrennte Entität einem neuen DataContext an, wenn ursprüngliche Werte für Prüfungen der vollständigen Parallelität benötigt werden.

public:
 void Attach(TEntity entity);

public:
 virtual void Attach(TEntity entity);

public void Attach (TEntity entity);

member this.Attach : 'Entity -> unit

abstract member Attach : 'Entity -> unit
override this.Attach : 'Entity -> unit

Public Sub Attach (entity As TEntity)

Parameter

entity: TEntity

Die ursprünglichen Werte der Entität, die angefügt werden soll.

Implementiert

Attach(TEntity)

Hinweise

Verwenden Sie die Attach Methoden mit Entitäten, die in einem DataContexterstellt wurden, mit einem Client serialisiert und dann wieder deserialisiert wurden, um einen Aktualisierungs- oder Löschvorgang auszuführen. Da der neue DataContext keine Möglichkeit hat, die ursprünglichen Werte für eine getrennte Entität nachzuverfolgen, ist der Client für die Bereitstellung dieser Werte verantwortlich. In dieser Version von Attachwird davon ausgegangen, dass sich die Entität im ursprünglichen Wertzustand befindet. Nach dem Aufrufen dieser Methode können Sie ihre Felder aktualisieren, z. B. mit zusätzlichen Daten, die vom Client gesendet werden.

Weitere Informationen finden Sie unter Datenabruf und CUD-Operationen in n-schichtigen Anwendungen (LINQ to SQL).

Gilt für:

Attach(TEntity, Boolean)

Fügt eine Entität im veränderten oder unveränderten Zustand an den DataContext an.

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)

Parameter

entity: TEntity

Die Entität, die angefügt werden soll.

asModified: Boolean

true, um die Entität als geändert anzufügen; false, um die Entität als nicht geändert anzufügen.

Hinweise

Wenn sie als geändert angefügt wird, muss die Entität entweder ein Versionselement deklarieren oder darf nicht an der Überprüfung von Updatekonflikten teilnehmen. Wenn eine neue Entität angefügt wird, werden verzögerte Ladeprogramme für alle untergeordneten Auflistungen (z. EntitySet B. Auflistungen von Entitäten aus zugeordneten Tabellen) initialisiert. Wenn SubmitChanges aufgerufen wird, werden Member der untergeordneten Auflistungen in einen Unmodified Zustand versetzt. Um Elemente einer untergeordneten Auflistung zu aktualisieren, müssen Sie diese Entität explizit aufrufen Attach und angeben.

Gilt für:

Attach(TEntity, TEntity)

Fügt eine Entität im veränderten oder unveränderten Zustand an den DataContext an, indem sowohl die Entität als auch ihr ursprünglicher Zustand angegeben werden.

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)

Parameter

entity: TEntity

Die Entität, die angefügt werden soll.

original: TEntity

Eine Instanz des gleichen Entitätstyps mit Datenmembern, die die ursprünglichen Werte enthalten.

Beispiele

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

Hinweise

Im folgenden Beispiel ist das Customer -Objekt bereits ordnungsgemäß konfiguriert. Sie können aufrufen Attach , ohne die Updates wiedergeben zu müssen.

Gilt für:

Freigeben über

Table<TEntity>.Attach Methode

Definition

Überlädt

Hinweise

Attach(TEntity)

Parameter

Implementiert

Hinweise

Gilt für:

Attach(TEntity, Boolean)

Parameter

Hinweise

Gilt für:

Attach(TEntity, TEntity)

Parameter

Beispiele

Hinweise

Gilt für:

Zusätzliche Ressourcen