Table<TEntity>.Attach Метод

Определение

Пространство имен:

System.Data.Linq

Сборка:

System.Data.Linq.dll

Присоединяет сущность к DataContext.

Перегрузки

Attach(TEntity)	Присоединяет отключенную или "отсоединенную" сущность к новому контексту DataContext, когда исходные значения необходимы для проверок оптимистичного параллелизма.
Attach(TEntity, Boolean)	Присоединяет сущность к DataContext в измененном или неизмененном состоянии.
Attach(TEntity, TEntity)	Присоединяет сущность к DataContext в измененном или неизмененном состоянии, указывая сущность и ее исходное состояние.

Комментарии

Attach Используйте методы с сущностями, которые были созданы в одном DataContextобъекте , сериализованы в клиент, а затем десериализируются обратно (с намерением выполнить операцию обновления или удаления). Дополнительные сведения см. в статье Извлечение данных и операции CUD в N-уровневых приложениях (LINQ to SQL).

Не пытайтесь подключиться к Attach сущности, которая не была отсоединены с помощью сериализации. Сущности, которые не были сериализованы, по-прежнему поддерживают связи с отложенными загрузчиками, которые могут привести к непредвиденным результатам, если сущность будет отслеживаться вторым контекстом данных.

При присоединении новой сущности инициализируются отложенные загрузчики для всех дочерних коллекций (например, EntitySet коллекций сущностей из связанных таблиц). При SubmitChanges вызове метода члены дочерних коллекций Unmodified переводятся в состояние . Чтобы обновить элементы дочерней коллекции, необходимо явно вызвать Attach и указать эту сущность.

Attach присоединяет все сущности в графе объектов предоставленного объекта. Пример:

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  

При вызове AttachEmployee присоединяется сотрудник, главный и дочерний Employee элемент, так как имеет отношения как к главному, так и к дочернему. Необходимо явно вызвать , InsertOnSubmit чтобы изменить состояние с присоединенного на вставленное.

Attach(TEntity)

Присоединяет отключенную или "отсоединенную" сущность к новому контексту DataContext, когда исходные значения необходимы для проверок оптимистичного параллелизма.

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)

Параметры

entity

TEntity

Исходные значения объекта, которые следует прикрепить.

Реализации

Attach(TEntity)

Комментарии

Attach Используйте методы с сущностями, созданными в одном DataContextэкземпляре , сериализованными в клиент, а затем десериализованными обратно для выполнения операции обновления или удаления. Так как новый DataContext не может отслеживать исходные значения для отключенной сущности, клиент отвечает за предоставление этих значений. В этой версии Attachпредполагается, что сущность находится в исходном состоянии значения. После вызова этого метода можно обновить его поля, например, с помощью дополнительных данных, отправленных от клиента.

При присоединении новой сущности инициализируются отложенные загрузчики для всех дочерних коллекций (например, EntitySet коллекций сущностей из связанных таблиц). При SubmitChanges вызове метода члены дочерних коллекций Unmodified переводятся в состояние . Чтобы обновить элементы дочерней коллекции, необходимо явно вызвать Attach и указать эту сущность.

Дополнительные сведения см. в статье Извлечение данных и операции CUD в N-уровневых приложениях (LINQ to SQL).

Не пытайтесь подключиться к Attach сущности, которая не была отсоединены с помощью сериализации. Сущности, которые не были сериализованы, по-прежнему поддерживают связи с отложенными загрузчиками, которые могут привести к непредвиденным результатам, если сущность будет отслеживаться вторым контекстом данных.

Attach(TEntity, Boolean)

Присоединяет сущность к DataContext в измененном или неизмененном состоянии.

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)

Параметры

entity

TEntity

Сущность, которая будет прикреплена.

asModified

Boolean

Значение true, чтобы вложить сущность как измененную; значение false, чтобы вложить сущность как неизмененную.

Комментарии

При присоединении как измененном объект должен либо объявить член версии, либо не должен участвовать в проверке конфликтов обновлений. При присоединении новой сущности инициализируются отложенные загрузчики для всех дочерних коллекций (например, EntitySet коллекций сущностей из связанных таблиц). При SubmitChanges вызове метода члены дочерних коллекций Unmodified переводятся в состояние . Чтобы обновить элементы дочерней коллекции, необходимо явно вызвать Attach и указать эту сущность.

Attach(TEntity, TEntity)

Присоединяет сущность к DataContext в измененном или неизмененном состоянии, указывая сущность и ее исходное состояние.

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)

Параметры

entity

TEntity

Сущность, которая будет прикреплена.

original

TEntity

Экземпляр того же типа сущности с элементами данных, которые содержат исходные значения.

Примеры

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

Комментарии

В следующем примере Customer объект уже правильно настроен. Вы можете вызвать Attach без повторного воспроизведения обновлений.

При присоединении новой сущности инициализируются отложенные загрузчики для всех дочерних коллекций (например, EntitySet коллекций сущностей из связанных таблиц). При SubmitChanges вызове метода члены дочерних коллекций Unmodified переводятся в состояние . Чтобы обновить элементы дочерней коллекции, необходимо явно вызвать Attach и указать эту сущность.