DataServiceContext.AttachTo 메서드

정의

네임스페이스:

System.Data.Services.Client

어셈블리:

System.Data.Services.Client.dll

지정된 리소스의 추적을 시작하도록 DataServiceContext에 알리고 지정된 리소스 집합 내의 리소스 위치를 제공합니다.

오버로드

AttachTo(String, Object)	지정된 리소스에 대한 추적을 시작하도록 DataServiceContext에 알리고 지정된 리소스 집합 내에서 리소스의 위치를 제공합니다.
AttachTo(String, Object, String)	지정된 리소스의 추적을 시작하도록 DataServiceContext에 알리고 지정된 리소스 집합 내의 리소스 위치를 제공합니다.

AttachTo(String, Object)

지정된 리소스에 대한 추적을 시작하도록 DataServiceContext에 알리고 지정된 리소스 집합 내에서 리소스의 위치를 제공합니다.

public:
 void AttachTo(System::String ^ entitySetName, System::Object ^ entity);

public void AttachTo (string entitySetName, object entity);

member this.AttachTo : string * obj -> unit

Public Sub AttachTo (entitySetName As String, entity As Object)

매개 변수

entitySetName

String

리소스가 들어 있는 집합의 이름입니다.

entity

Object

DataServiceContext에서 추적할 리소스입니다. 리소스는 변경되지 않은 상태로 연결됩니다.

예외

ArgumentNullException

entity 또는 entitySetName가 null인 경우

ArgumentException

entitySetName이 빈 문자열인 경우

또는

entity 에는 키 속성이 정의되지 않았습니다.

InvalidOperationException

entity 는 이미 컨텍스트에 의해 추적되고 있습니다.

설명

엔터티가 개체 그래프의 일부인 경우 이 작업은 그래프를 트래버스하여 관련 개체를 추가하지 않습니다. 그것은 얕은 작업입니다.

메서드는 지정된 엔터티 집합이 와 연결된 DataServiceContext데이터 서비스에서 발생하는지 여부를 확인하지 않습니다.

AttachTo(String, Object, String)

지정된 리소스의 추적을 시작하도록 DataServiceContext에 알리고 지정된 리소스 집합 내의 리소스 위치를 제공합니다.

public:
 void AttachTo(System::String ^ entitySetName, System::Object ^ entity, System::String ^ etag);

public void AttachTo (string entitySetName, object entity, string etag);

member this.AttachTo : string * obj * string -> unit

Public Sub AttachTo (entitySetName As String, entity As Object, etag As String)

매개 변수

entitySetName

String

엔터티가 연결된 엔터티 집합의 이름이 들어 있는 문자열 값입니다.

entity

Object

추가할 엔터티입니다.

etag

String

데이터 서비스에서 엔터티를 마지막으로 검색한 때의 엔터티 상태를 나타내는 etag 값입니다. 이 값은 불투명 문자열로 처리되므로 클라이언트 라이브러리에서 이 값에 대한 유효성 검사를 수행하지 않습니다.

예외

ArgumentNullException

entitySetName은 null입니다.

또는

entity이(가) null인 경우

ArgumentException

entitySetName이 빈 문자열인 경우

또는

제공된 개체에 키 속성이 없습니다.

InvalidOperationException

제공된 개체가 컨텍스트에서 이미 추적되고 있습니다.

설명

이 메서드를 DataServiceContext 호출하면 지정된 엔터티 추적을 시작하도록 에 알리고 엔터티가 속한 엔터티 집합을 식별합니다.

엔터티가 개체 그래프의 일부인 경우 이 작업은 그래프를 트래버스하여 관련 개체를 추가하지 않습니다. 개체가 변경되지 않은 상태로 에 추가 DataServiceContext 됩니다. 메서드는 지정된 엔터티 집합이 와 연결된 DataServiceContext데이터 서비스에서 발생하는지 여부를 확인하지 않습니다.

etag가 있는 오버로드를 사용하는 경우 지정된 etag가 새로 연결된 엔터티와 연결됩니다. 그런 다음 HTTP 의미 체계에 따라 엔터티에 대한 모든 후속 업데이트 또는 쿼리 작업과 함께 etag가 데이터 서비스로 전송됩니다. etag 값의 수동 생성은 권장되지 않지만 이 오버로드는 직렬화되고 저장되었을 수 있는 엔터티를 관련 동시성 메타데이터와 함께 다시 연결할 수 있도록 하기 위해 제공됩니다.