개체 추가, 수정 및 삭제(Entity Framework)

  • 아티클

개체 컨텍스트의 개체는 데이터 소스의 데이터를 나타내는 엔터티 형식의 인스턴스입니다. 개체 컨텍스트에서 개체를 수정, 생성 및 삭제할 수 있으며, 개체 서비스는 이러한 개체의 변경 내용을 추적합니다. SaveChanges 메서드를 호출하면 개체 서비스는 데이터 소스에 대해 해당 insert, update, delete 문을 수행하는 명령을 생성하고 실행합니다. 자세한 내용은 변경 내용 저장 및 동시성 관리(Entity Framework)를 참조하십시오.

예를 들어 SalesOrderHeader 개체 및 관련된 SalesOrderDetail 개체 컬렉션을 반환하는 쿼리를 실행한다고 가정합니다. 컬렉션을 열거하고 다음 작업을 수행할 수 있습니다.

  • 주문의 ShipDate 속성을 변경합니다.

  • DeleteObject 메서드를 호출하여 특정 항목을 삭제합니다.

  • Add 메서드를 호출하여 줄 항목을 주문에 추가합니다.

  • 개체 변경 내용을 데이터 소스에 다시 저장하려는 경우 개체 컨텍스트에서 SaveChanges 메서드를 호출합니다.

다음 예제에서는 개체 컨텍스트 내의 개체에 대한 다양한 변경 내용을 보여 줍니다.

Dim order As SalesOrderHeader = _
context.SalesOrderHeader.Where( _
        "it.SalesOrderID = @id", New ObjectParameter( _
         "id", orderId)).First()

' Change the status and ship date of an existing order.
order.Status = 1
order.ShipDate = DateAndTime.Today

' Load items for the order, if not already loaded.
If Not order.SalesOrderDetail.IsLoaded Then
    order.SalesOrderDetail.Load()
End If

' Delete the first item in the order.
context.DeleteObject(order.SalesOrderDetail.First())

' Create a new item using the static Create method
' and add it to the order.
order.SalesOrderDetail.Add( _
    SalesOrderDetail.CreateSalesOrderDetail( _
    1, 0, 2, 750, 1, CDec(2171.2942), 0, 0, Guid.NewGuid(), _
    DateAndTime.Today))

' Save changes in the object context to the database.
Dim changes As Integer = context.SaveChanges()

SalesOrderHeader order =
    context.SalesOrderHeader.Where
    ("it.SalesOrderID = @id", new ObjectParameter(
     "id", orderId)).First();

// Change the status and ship date of an existing order.
order.Status = 1;
order.ShipDate = DateTime.Today;

// Load items for the order, if not already loaded.
if (!order.SalesOrderDetail.IsLoaded)
{
    order.SalesOrderDetail.Load();
}

// Delete the first item in the order.
context.DeleteObject(order.SalesOrderDetail.First());

// Create a new item using the static Create method 
// and add it to the order.
order.SalesOrderDetail.Add(
    SalesOrderDetail.CreateSalesOrderDetail(0,
    0, 2, 750, 1, (decimal)2171.2942, 0, 0,
    Guid.NewGuid(), DateTime.Today));

// Save changes in the object context to the database.
int changes = context.SaveChanges();

개체 추가

데이터 소스에 데이터를 삽입하려는 경우 엔터티 형식의 인스턴스를 만들고 개체 컨텍스트에 개체를 추가해야 합니다. 새 개체를 추가하려면 먼저 null 값을 지원하지 않는 모든 속성을 설정해야 합니다. 엔터티 형식의 정적 CreateObjectName 메서드를 사용하여 엔터티 형식의 새 인스턴스를 만드는 것이 좋습니다. 엔터티 데이터 모델 도구에서 엔터티 형식을 생성하면 각 클래스에 이 메서드가 포함됩니다. 이 만들기 메서드는 개체 인스턴스를 만들고 null이 될 수 없는 클래스의 모든 속성을 설정하는 데 사용됩니다. 메서드에는 CSDL 파일에서 Nullable="false" 특성이 적용된 모든 속성에 대한 매개 변수가 포함됩니다.

다음 예제에서는 정적 CreateSalesOrderHeader 메서드를 사용하여 SalesOrderHeader 클래스의 새 인스턴스를 만듭니다.

' Create a new SalesOrderHeader using the static 
' CreateSalesOrderHeader method.
Dim order As SalesOrderHeader = _
    SalesOrderHeader.CreateSalesOrderHeader( _
    1, Convert.ToByte(1), DateTime.Now, DateTime.Today.AddMonths(2), _
    Convert.ToByte(1), False, String.Empty, customer.ContactID, shipMethod, _
    0, 0, 0, 0, Guid.NewGuid(), DateTime.Now)

// Create a new SalesOrderHeader using the static 
// CreateSalesOrderHeader method.
SalesOrderHeader order = SalesOrderHeader.CreateSalesOrderHeader(0,
    Convert.ToByte(1), DateTime.Now, DateTime.Today.AddMonths(2),
    Convert.ToByte(1), false, string.Empty, customer.ContactID, shipMethod, 
    0, 0, 0, 0, Guid.NewGuid(), DateTime.Now);

자세한 내용은 방법: 정적 create 메서드를 사용하여 개체 만들기(Entity Framework)를 참조하십시오.

AddObject 메서드를 호출하여 또는 형식화된 ObjectContext에서 AddToEntitySetName 메서드 중 하나를 호출하여 개체 컨텍스트에 새 개체를 추가할 수 있습니다. 기존 EntityCollection에 추가하여 개체 컨텍스트에 개체를 추가할 수도 있습니다. 개체 컨텍스트에 연결된 EntityCollection에서 Add 메서드를 호출하면 추가 중인 개체가 동일한 ObjectContext에 추가됩니다. 마찬가지로, 새 개체 인스턴스를 EntityReference의 Value로 설정하여 개체를 추가할 수 있습니다.

탐색 속성은 개체 간의 관계를 정의합니다. 개체 컨텍스트에서 개체가 다른 개체와 관련된 경우 이러한 속성을 설정하는 것이 좋습니다. 예를 들어, 새 SalesOrderDetail 개체의 SalesOrderHeader 관계 속성을 줄 항목이 속한 주문 인스턴스에 설정합니다. 개체 컨텍스트 내의 다른 개체와 연관된 새 개체를 만들 때는 다음 메서드 중 하나를 사용하여 개체를 추가합니다.

  • 일 대 다 또는 다 대 다 관계의 경우 EntityCollection에서 Add를 호출하고 관련 개체를 지정합니다.

  • 일 대 일 또는 다 대 일 관계의 경우 EntityReference의 Value 속성을 관련 개체로 설정합니다.

  • AddObject 메서드를 호출하여 개체 컨텍스트에 새 개체를 추가한 다음 앞의 두 메서드 중 하나를 사용하여 관계를 정의합니다.

새 개체를 추가할 때는 다음 사항을 고려해야 합니다.

  • SaveChanges를 호출하기 전에 개체 서비스는 AddObject 메서드를 사용하여 추가된 모든 새 개체에 대해 임시 키 값을 생성합니다. SaveChanges를 호출한 후 새 행을 삽입할 때 키 값이 데이터 소스에서 할당된 ID 값으로 바뀝니다.

  • 데이터 소스에서 엔터티의 키 값이 생성되지 않는 경우 고유한 값을 할당해야 합니다. 두 개체의 사용자 지정 키 값이 같은 경우 SaveChanges를 호출하면 InvalidOperationException이 발생합니다. 이 예외가 발생하면 고유한 값을 할당하고 작업을 재시도해야 합니다.

  • 개체 간에 관계를 정의하고 SaveChanges를 호출하면 엔터티 프레임워크에서 자동으로 데이터 소스에 외래 키 값을 설정합니다. 그러나 엔터티가 삽입, 업데이트 및 삭제를 수행하는 저장 프로시저에 매핑된 경우에는 외래 키 값이 자동으로 설정되지 않습니다. 이 경우 외래 키에 해당하는 속성을 관련 개체의 올바른 값으로 적절하게 설정해야 합니다. 자세한 내용은 저장 프로시저 지원(Entity Framework)을 참조하십시오.

개체 수정

개체의 스칼라, 복합 또는 탐색 속성을 변경하고 SaveChanges를 호출하면 업데이트가 데이터 소스로 전송됩니다. EntityReference 값 변경 또는 EntityCollection에서 개체 제거와 같은 탐색 속성을 변경하여 개체 간의 관계를 변경합니다. 자세한 내용은 방법: 개체 간 관계 변경(Entity Framework)을 참조하십시오.

개체 서비스는 IEntityChangeTracker 인스턴스를 사용하여 ObjectContext에 연결된 개체의 변경 내용을 추적합니다. 추적되는 각 개체에 대해 하나의 IEntityChangeTracker 인스턴스가 있습니다. 쿼리에서 NoTracking으로 설정된 MergeOption을 사용하지 않는 경우 쿼리는 Unchanged 상태의 개체를 반환합니다. 엔터티 데이터 모델 도구는 엔터티 형식의 각 속성에 대한 속성 setter(다음 예제에서는 SalesOrderHeader 클래스의 Status 속성에 대한 속성 setter)에서 추적 메서드를 변경하는 호출을 생성합니다.

Set(ByVal value As Byte)
    Me.OnStatusChanging(value)
    Me.ReportPropertyChanging("Status")
    Me._Status = Global.System.Data.Objects.DataClasses.StructuralObject.SetValidValue(value)
    Me.ReportPropertyChanged("Status")
    Me.OnStatusChanged()
End Set

set
{
    this.OnStatusChanging(value);
    this.ReportPropertyChanging("Status");
    this._Status = global::System.Data.Objects.DataClasses.StructuralObject.SetValidValue(value);
    this.ReportPropertyChanged("Status");
    this.OnStatusChanged();
}

ReportPropertyChanging 메서드와 ReportPropertyChanged 메서드는 속성 변경 내용을 IEntityChangeTracker에 보고합니다. EDM(엔터티 데이터 모델)에서 사용자 지정 데이터 클래스를 사용하는 경우 속성 변경 내용도 보고하여 개체 서비스의 추적을 사용하도록 설정해야 합니다. 자세한 내용은 사용자 지정 데이터 클래스의 변경 내용 보고(Entity Framework)를 참조하십시오.

속성 setter를 호출할 때마다 개체의 상태가 Unchanged에서 Modified로 변경됩니다. 이는 설정되는 값이 현재 값과 같은 경우에도 마찬가지입니다. AcceptAllChanges 메서드를 호출한 후 상태가 Unchanged로 돌아갑니다. 기본적으로 AcceptAllChanges는 SaveChanges 작업 중에 호출됩니다.

엔터티 데이터 모델 도구는 On속성Changing 및 On속성Changed라는 한 쌍의 부분 메서드(Partial Method)도 생성합니다. 이 메서드는 속성 setter에서 호출됩니다. 속성 변경 중에 사용자 지정 비즈니스 논리를 삽입하려면 partial 클래스에서 이러한 메서드를 확장합니다. 자세한 내용은 방법: 속성 변경 중 비즈니스 논리 실행(Entity Framework)을 참조하십시오.

개체를 수정할 때는 다음 사항을 고려해야 합니다.

  • 복합 개체의 스칼라 또는 복합 속성을 변경하면 최상위 엔터티 개체의 상태가 Modified로 변경됩니다.

  • 개체가 Detached 상태에 있으면 변경 내용이 추적되지 않습니다. NoTracking 병합 옵션을 사용하는 쿼리에서 반환될 때 또는 Detach를 호출하여 ObjectContext에서 분리된 후 개체가 이 상태에 있습니다.

  • 새 개체에 EntityReference 값을 할당하여 두 개체 간의 관계를 변경할 수 있습니다. 이 경우 SaveChanges를 호출하면 엔터티 프레임워크에서 자동으로 데이터 소스의 외래 키 값을 업데이트합니다. 그러나 엔터티가 삽입, 업데이트 및 삭제를 수행하는 저장 프로시저에 매핑된 경우에는 외래 키 값이 자동으로 업데이트되지 않습니다. 이 경우 외래 키에 해당하는 속성을 새 관계의 올바른 값으로 적절하게 설정해야 합니다. 자세한 내용은 저장 프로시저 지원(Entity Framework)을 참조하십시오.

개체 삭제

ObjectContext에서 DeleteObject 메서드를 호출하면 삭제를 위해 지정된 개체가 표시됩니다. SaveChanges를 호출해야 데이터 소스에서 행이 삭제됩니다.

개체를 삭제할 때는 다음 사항을 고려해야 합니다.

  • 개체를 삭제하면 다른 개체에 대한 관계도 모두 삭제됩니다.

  • 두 개체가 제약 조건 관계에 있을 경우 부모 개체를 삭제하면 자식 개체도 모두 삭제됩니다. 이 결과는 해당 관계에 대한 연결에 CascadeDelete 속성을 사용하는 것과 동일합니다. 자세한 내용은 참조 제약 조건(Entity Framework)을 참조하십시오.

  • 쿼리에서 반환된 개체가 하나 이상의 다른 개체와 관련이 있으면 개체를 삭제하기 쉽도록 쿼리에서 항상 관련 개체에 대한 일부 정보를 반환합니다. 경우에 따라 이러한 기존 정보로 인해 개체를 삭제할 때 UpdateException이 발생할 수 있습니다. 예를 들어 관계를 정의하는 연결에서 Association의 부모 End에 <OnDelete Action="Cascade" /> 요소가 지정되어 있으면 이 예외가 발생합니다. 이 경우 DeleteObject 메서드를 호출하기 전에 명시적으로 관련 개체를 로드합니다.

  • 이미 삭제된 개체에 대해 다시 DeleteObject 메서드를 호출할 수 있습니다.

자세한 내용은 방법: 개체 추가, 수정 및 삭제(Entity Framework)를 참조하십시오.

특정 EntitySet에서 개체 만들기

엔터티 형식이 다수의 엔터티 집합에 속하는 경우가 있을 수 있습니다. 예를 들어, 데이터베이스에 동일한 스키마를 사용하는 테이블이 2개 있는 상황을 생각해 봅니다. 데이터를 분할하여 더 효율적인 백업 프로세스를 생성하려는 경우일 수 있습니다. 예를 들어, Customer 및 CustomerArchive 테이블 간에 고객 데이터를 분할하여 CustomerArchive는 Customer와 동일한 스키마를 사용하지만 6개월 이상 주문을 하지 않은 고객에 대해 사용하도록 설정했을 수 있습니다. 이때 Customer는 야간에 백업할 수 있지만 CustomerArchive는 1주 간격으로만 백업됩니다. 매핑 관점에서 보면 Customer와 CustomerArchive는 서로 다른 엔터티 집합에 속해야 합니다. 엔터티 프레임워크에서는 엔터티 형식이 하나 이상의 엔터티 집합에 존재하도록 허용하여 이 시나리오를 지원합니다. 자세한 내용은 엔터티 집합(EDM)을 참조하십시오.

엔터티 형식이 다수의 엔터티 집합에 존재할 경우 개체 서비스를 사용하여 형식의 새 인스턴스를 특정 엔터티 집합에 추가할 수 있습니다. 이렇게 하려면 AddObject 메서드를 호출하여 개체를 개체 컨텍스트에 추가할 때 entitySetName의 값을 지정해야 합니다. 자세한 내용은 방법: 특정 엔터티 집합에 개체 추가(Entity Framework)를 참조하십시오.

또한 엔터티 데이터 모델 도구는 개념적 모델에 정의된 각 엔터티 집합에 대해 하나씩, AddToEntitySetName 메서드를 ObjectContext에서 생성합니다. 이 메서드는 AddObject를 호출하고 특정 메서드의 EntitySetName 값을 전달합니다. 이러한 메서드를 사용하여 특정 엔터티 집합에 개체를 추가합니다.

참고 항목

작업

방법: 유형별 다중 엔터티 집합으로 모델 정의(Entity Framework)