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, in einen Client serialisiert und dann deserialisiert wurden (mit der Absicht, einen Update- oder Löschvorgang auszuführen). Weitere Informationen finden Sie unter Datenabruf und CUD-Vorgänge in N-Tier-Anwendungen (LINQ to SQL).

Versuchen Sie nicht, eine Entität zu Attach verwenden, die nicht über die Serialisierung getrennt wurde. Entitäten, die nicht serialisiert wurden, behalten weiterhin Zuordnungen mit verzögerten Ladevorgängen 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 Ladevorgänge für alle untergeordneten Sammlungen (z. B. EntitySet Sammlungen von Entitäten aus zugeordneten Tabellen) initialisiert. Wenn SubmitChanges aufgerufen wird, werden Elemente der untergeordneten Auflistungen in einen Unmodified Zustand versetzt. Um Mitglieder einer untergeordneten Auflistung zu aktualisieren, müssen Sie diese Entität explizit aufrufen Attach und angeben.

Attach fügt alle Entitäten im Objektdiagramm 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 Employee fügt Mitarbeiter, Master und untergeordnete Elemente an, da die Employee Beziehungen zu Master und untergeordnetem Element aufweist. Sie müssen explizit aufrufen InsertOnSubmit , um den Zustand von angefügt in 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 einer DataContexterstellt wurden, die auf einen 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. Nachdem Sie diese Methode aufgerufen haben, 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-Vorgänge in N-Tier-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 die Entität als geändert angefügt wird, muss sie entweder einen Versionsmember deklarieren oder darf nicht an der Überprüfung von Updatekonflikten teilnehmen. Wenn eine neue Entität angefügt wird, werden verzögerte Ladevorgänge für alle untergeordneten Sammlungen (z. B. EntitySet Sammlungen von Entitäten aus zugeordneten Tabellen) initialisiert. Wenn SubmitChanges aufgerufen wird, werden Elemente der untergeordneten Auflistungen in einen Unmodified Zustand versetzt. Um Mitglieder 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 anrufen Attach , ohne die Updates wiedergeben zu müssen.

Gilt für:

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:

Feedback

Zusätzliche Ressourcen