내보내기(0) 인쇄
모두 확장
이 문서는 기계로 번역한 것입니다. 원본 텍스트를 보려면 포인터를 문서의 문장 위로 올리십시오. 추가 정보
번역
원본

DataServiceContext 클래스

DataServiceContext 는 데이터 서비스의 런타임 컨텍스트를 나타냅니다.

System.Object
  System.Data.Services.Client.DataServiceContext

네임스페이스:  System.Data.Services.Client
어셈블리:  System.Data.Services.Client(System.Data.Services.Client.dll)

public class DataServiceContext

DataServiceContext 형식에서는 다음과 같은 멤버를 노출합니다.

  이름설명
Public 메서드DataServiceContext지정된 serviceRoot을 사용하여 DataServiceContext 클래스의 새 인스턴스를 초기화합니다.
위쪽

  이름설명
Public 속성ApplyingChanges DataServiceContext 가 현재 추적된 개체에 변경 내용을 적용하고 있는지 여부를 나타내는 값을 가져옵니다.
Public 속성BaseUri대상 데이터 서비스의 루트를 식별하는 절대 URI를 가져옵니다.
Public 속성Credentials DataServiceContext 개체를 사용하여 만든 각 쿼리에서 사용하는 인증 정보를 가져오거나 설정합니다.
Public 속성DataNamespaceAtom 페이로드에 대한 메타데이터 항목 외의 데이터 항목의 XML 네임스페이스를 가져오거나 설정합니다.
Public 속성Entities DataServiceContext 에 의해 현재 추적되고 있는 모든 리소스의 목록을 가져옵니다.
Public 속성IgnoreMissingProperties형식에서 읽어온 속성을 클라이언트 쪽 형식의 속성에 매핑해야 하는지 여부를 가져오거나 설정합니다.
Public 속성IgnoreResourceNotFoundException데이터 서비스에서 404 오류(리소스를 찾을 수 없음)가 반환될 때 예외가 발생되는지 여부를 가져오거나 설정합니다.
Public 속성Links DataServiceContext 개체에 의해 현재 추적되고 있는 모든 연결 또는 링크의 컬렉션을 가져옵니다.
Public 속성MergeOption데이터 서비스에서 엔터티를 받기 위한 동기화 옵션을 가져오거나 설정합니다.
Public 속성ResolveName데이터 서비스에 엔터티를 보낼 때 클라이언트 라이브러리에서 사용하는 기본 형식 확인 전략을 재정의하는 함수를 가져오거나 설정합니다.
Public 속성ResolveType데이터 서비스에서 엔터티를 받을 때 클라이언트 라이브러리에서 사용하는 기본 형식 확인 옵션을 재정의하는 데 사용되는 함수를 가져오거나 설정합니다.
Public 속성SaveChangesDefaultOptions SaveChanges 메서드에서 사용하는 SaveChangesOptions 값을 가져오거나 설정합니다.
Public 속성Timeout데이터 서비스에 대한 기본 HTTP 요청에 사용하는 제한 시간 옵션을 가져오거나 설정합니다.
Public 속성TypeScheme서비스에서 사용하는 형식 스키마를 나타내는 데 사용되는 URI를 가져오거나 설정합니다.
Public 속성UsePostTunneling사후 터널링을 사용할지 여부를 나타내는 부울 값을 가져오거나 설정합니다.
위쪽

  이름설명
Public 메서드AddLink DataServiceContext 에서 추적하는 개체 집합에 지정된 링크를 추가합니다.
Public 메서드AddObject DataServiceContext 에서 추적하는 개체 집합에 지정된 개체를 추가합니다.
Public 메서드AddRelatedObject컨텍스트에 관련 개체를 추가하고 단일 요청에서 두 개체 간의 관계를 정의하는 링크를 만듭니다.
Public 메서드AttachLink엔터티 개체 간의 관계를 정의하는 지정된 링크 추적을 시작하도록 DataServiceContext에 알립니다.
Public 메서드AttachTo(String, Object)지정된 리소스에 대한 추적을 시작하도록 DataServiceContext에 알리고 지정된 리소스 집합 내에서 리소스의 위치를 제공합니다.
Public 메서드AttachTo(String, Object, String)지정된 리소스에 대한 추적을 시작하도록 DataServiceContext에 알리고 지정된 리소스 집합에서 리소스의 위치를 제공합니다.
Public 메서드BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)페이지 단위 쿼리 결과에서 다음 데이터 페이지를 검색하라는 요청을 데이터 서비스에 비동기적으로 보냅니다.
Public 메서드BeginExecute<TElement>(Uri, AsyncCallback, Object)서비스에서 결과를 기다리는 동안 이 호출로 처리가 차단되지 않도록 요청을 비동기적으로 보냅니다.
Public 메서드BeginExecuteBatch쿼리 그룹을 일괄적으로 데이터 서비스에 비동기적으로 제출합니다.
Public 메서드BeginGetReadStream지정된 엔터티의 이진 속성 데이터를 지정된 메시지 헤더와 함께 데이터 스트림으로 비동기적으로 가져옵니다.
Public 메서드BeginLoadProperty(Object, String, AsyncCallback, Object)데이터 서비스에서 지정된 속성의 값을 비동기적으로 로드합니다.
Public 메서드BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)제공된 쿼리 연속 개체를 사용하여 데이터 서비스에서 관련 엔터티의 다음 페이지를 비동기적으로 로드합니다.
Public 메서드BeginLoadProperty(Object, String, Uri, AsyncCallback, Object)제공된 다음 링크 URI를 사용하여 데이터 서비스에서 관련 엔터티의 페이지를 비동기적으로 로드합니다.
Public 메서드BeginSaveChanges(AsyncCallback, Object)변경 내용을 마지막으로 저장한 이후 DataServiceContext에 의해 수집되는 보류 중인 변경 내용을 데이터 서비스에 비동기적으로 전송합니다.
Public 메서드BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)변경 내용을 마지막으로 저장한 이후 DataServiceContext에 의해 수집되는 보류 중인 변경 내용을 데이터 서비스에 비동기적으로 전송합니다.
Public 메서드CancelRequest제공된 IAsyncResult 개체와 연결된 작업을 취소하려고 시도합니다.
Public 메서드CreateQuery<T>지정된 제네릭 형식의 데이터에 대한 데이터 서비스 쿼리를 만듭니다.
Public 메서드DeleteLink DataServiceContext 에서 추적하는 링크 목록에서 링크 상태를 삭제됨으로 변경합니다.
Public 메서드DeleteObject DataServiceContext 에서 삭제되도록 지정한 개체의 상태를 변경합니다.
Public 메서드Detach DataServiceContext 에서 추적하고 있는 엔터티 목록에서 엔터티를 제거합니다.
Public 메서드DetachLink DataServiceContext 에서 추적하는 링크 목록에서 지정된 링크를 제거합니다.
Public 메서드EndExecute<TElement> BeginExecute 을 완료하기 위해 호출됩니다.
Public 메서드EndExecuteBatch BeginExecuteBatch 을 완료하기 위해 호출됩니다.
Public 메서드EndGetReadStream이진 속성을 스트림으로 검색하는 비동기적 작업을 완료하기 위해 호출됩니다.
Public 메서드EndLoadProperty BeginLoadProperty 작업을 완료하기 위해 호출됩니다.
Public 메서드EndSaveChanges BeginSaveChanges 작업을 완료하기 위해 호출됩니다.
Public 메서드Equals(Object) 지정한 개체가 현재 개체와 같은지 여부를 확인합니다. (Object에서 상속됨)
Public 메서드Execute<T>(DataServiceQueryContinuation<T>)페이지 단위 쿼리 결과에서 다음 데이터 페이지를 검색하라는 요청을 데이터 서비스에 보냅니다.
Public 메서드Execute<TElement>(Uri)특정 URI 실행 요청을 데이터 서비스에 보냅니다.
Public 메서드ExecuteBatch쿼리 그룹을 일괄적으로 데이터 서비스에 제출합니다.
Protected 메서드Finalize 개체가 가비지 수집자에서 회수되기 전에, 해당 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드GetEntityDescriptor제공된 엔터티 개체에 대한 EntityDescriptor를 가져옵니다.
Public 메서드GetHashCode기본 해시 함수로 작동합니다. (Object에서 상속됨)
Public 메서드GetLinkDescriptor두 엔터티 간의 관계를 정의하는 특정 링크에 대한 LinkDescriptor를 가져옵니다.
Public 메서드GetMetadataUri.edmx 메타데이터 위치의 URI를 가져옵니다.
Public 메서드GetReadStream(Object)지정된 엔터티의 이진 속성 데이터를 데이터 스트림으로 가져옵니다.
Public 메서드GetReadStream(Object, DataServiceRequestArgs)지정된 엔터티의 이진 속성 데이터를 지정된 메시지 헤더와 함께 데이터 스트림으로 가져옵니다.
Public 메서드GetReadStream(Object, String)지정된 엔터티에 대한 이진 속성 데이터를 지정된 Accept 메시지 헤더와 함께 데이터 스트림으로 가져옵니다.
Public 메서드GetReadStreamUri이진 속성 데이터를 데이터 스트림으로 반환하는 데 사용되는 URI를 가져옵니다.
Public 메서드GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Public 메서드LoadProperty(Object, String)데이터 서비스에서 지정된 속성에 대한 지연 콘텐츠를 로드합니다.
Public 메서드LoadProperty(Object, String, DataServiceQueryContinuation)제공된 쿼리 연속 개체를 사용하여 데이터 서비스에서 관련 엔터티의 다음 페이지를 로드합니다.
Public 메서드LoadProperty(Object, String, Uri)제공된 다음 링크 URI를 사용하여 관련 엔터티의 페이지를 로드합니다.
Public 메서드LoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)제공된 제네릭 쿼리 연속 개체를 사용하여 데이터 서비스에서 관련 엔터티의 다음 페이지를 로드합니다.
Protected 메서드MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Public 메서드SaveChanges() DataServiceContext 에서 추적하고 있는 변경 내용을 저장소에 저장합니다.
Public 메서드SaveChanges(SaveChangesOptions) DataServiceContext 에서 추적하고 있는 변경 내용을 저장소에 저장합니다.
Public 메서드SetLink지정된 개체 간에 새 링크가 있고 이 링크가 sourceProperty 매개 변수로 지정한 속성으로 표시된다는 것을 DataServiceContext에 알립니다.
Public 메서드SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)요청 메시지에 지정된 설정을 사용하여 새 데이터 스트림을 엔터티의 이진 속성으로 설정합니다.
Public 메서드SetSaveStream(Object, Stream, Boolean, String, String)새 데이터 스트림을 엔터티의 이진 속성으로 설정합니다. 지정된 Content-Type 및 Slug 헤더가 요청 메시지에 포함됩니다.
Public 메서드ToString현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)
Public 메서드TryGetEntity<TEntity> DataServiceContext 에서 추적하는 엔터티의 URI에 대한 참조를 통해 이 엔터티에 대한 검색을 테스트합니다.
Public 메서드TryGetUri지정된 엔터티와 연결된 정식 URI(사용 가능한 경우)를 검색합니다.
Public 메서드UpdateObject DataServiceContext 에서 지정한 개체의 상태를 Modified로 변경합니다.
위쪽

  이름설명
Public 이벤트ReadingEntity엔터티 데이터를 엔터티 개체로 완전히 읽어온 후 발생합니다.
Public 이벤트SendingRequestHttpWebRequest가 만들어지면 발생합니다.
Public 이벤트WritingEntity엔터티가 요청 메시지에서 XML로 완전히 serialize된 후 발생합니다.
위쪽

WCF Data Services는 상태를 저장하지 않지만 DataServiceContext는 그렇지 않습니다. 업데이트 관리와 같은 기능을 지원하기 위해 클라이언트에 대한 상태가 상호 작용 간에 유지됩니다. 이 클래스와 데이터 서비스에 대한 특정 HTTP 요청을 나타내는 DataServiceQuery 클래스는 클라이언트 라이브러리에서 두 개의 주요 클래스입니다.

다음 예제에서는 서비스 참조 추가 도구에서 생성된 DataServiceContext를 사용하여 모든 고객을 반환하는 Northwind 데이터 서비스에 대해 암시적으로 쿼리를 실행하는 방법을 보여줍니다. 요청한 Customers 엔터티 집합의 URI는 컨텍스트에 의해 자동으로 결정됩니다. 열거가 발생하면 쿼리가 암시적으로 실행됩니다. Northwind 데이터 서비스는 WCF Data Services quickstart를 완료할 때 만들어집니다.


// Create the DataServiceContext using the service URI.
NorthwindEntities context = new NorthwindEntities(svcUri);

// Define a new query for Customers.
DataServiceQuery<Customer> query = context.Customers;

try
{
    // Enumerate over the query result, which is executed implicitly.
    foreach (Customer customer in query)
    {
        Console.WriteLine("Customer Name: {0}", customer.CompanyName);
    }
}
catch (DataServiceQueryException ex)
{
    throw new ApplicationException(
        "An error occurred during query execution.", ex);
}


.NET Framework

4.5.2, 4.5.1, 4.5, 4, 3.5 SP1에서 지원

.NET Framework Client Profile

4, 3.5 SP1에서 지원

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008(서버 코어 역할은 지원되지 않음), Windows Server 2008 R2(서버 코어 역할은 SP1 이상에서 지원, Itanium은 지원되지 않음)

.NET Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

커뮤니티 추가 항목

추가
Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2014 Microsoft