CDataConnection 클래스

  • 아티클

데이터 원본과의 연결을 관리합니다.

구문

class CDataConnection

요구 사항

헤더: atldbcli.h

멤버

메서드

이름 설명
CDataConnection::CDataConnection 생성자입니다. 개체를 인스턴스화하고 초기화합니다 CDataConnection .
CDataConnection::Copy 기존 데이터 연결의 복사본을 만듭니다.
CDataConnection::Open 초기화 문자열을 사용하여 데이터 원본에 대한 연결을 엽니다.
CDataConnection::OpenNewSession 현재 연결에서 새 세션을 엽니다.

연산자

이름 설명
CDataConnection::operator BOOL 현재 세션이 열려 있는지 여부를 확인합니다.
CDataConnection::operator bool 현재 세션이 열려 있는지 여부를 확인합니다.
CDataConnection::operator CDataSource& 포함된 개체에 대한 참조를 CDataSource 반환합니다.
CDataConnection::operator CDataSource* 포함된 CDataSource 개체에 대한 포인터를 반환합니다.
CDataConnection::operator CSession& 포함된 개체에 대한 참조를 CSession 반환합니다.
CDataConnection::operator CSession* 포함된 CSession 개체에 대한 포인터를 반환합니다.

설명

CDataConnection 는 필요한 개체(데이터 원본 및 세션)와 데이터 원본에 연결할 때 수행해야 하는 일부 작업을 캡슐화하므로 클라이언트를 만드는 데 유용한 클래스입니다.

없으면 CDataConnection개체를 CDataSource 만들고, 메서드를 OpenFromInitializationString 호출한 다음, 개체의 인스턴스를 CSession 만들고, 메서드를 Open 호출한 다음, 개체를 CCommand 만들고* 메서드를 호출해야 Open합니다.

이 CDataConnection경우 연결 개체를 만들고, 초기화 문자열을 전달한 다음, 해당 연결을 사용하여 명령을 열어야 합니다. 데이터베이스에 대한 연결을 반복적으로 사용하려는 경우 연결을 열어 두는 것이 좋으며 CDataConnection 이를 위한 편리한 방법을 제공합니다.

참고 항목

여러 세션을 처리해야 하는 데이터베이스 애플리케이션을 만드는 경우 .OpenNewSession

CDataConnection::CDataConnection

개체를 인스턴스화하고 초기화합니다 CDataConnection .

구문

CDataConnection();
CDataConnection(const CDataConnection &ds);

매개 변수

ds
[in] 기존 데이터 연결에 대한 참조입니다.

설명

첫 번째 재정의는 기본 설정을 사용하여 새 CDataConnection 개체를 만듭니다.

두 번째 재정의는 지정한 데이터 연결 개체에 해당하는 설정을 사용하여 새 CDataConnection 개체를 만듭니다.

CDataConnection::Copy

기존 데이터 연결의 복사본을 만듭니다.

구문

CDataConnection& Copy(const CDataConnection & ds) throw();

매개 변수

ds
[in] 복사할 기존 데이터 연결에 대한 참조입니다.

CDataConnection::Open

초기화 문자열을 사용하여 데이터 원본에 대한 연결을 엽니다.

구문

HRESULT Open(LPCOLESTR szInitString) throw();

매개 변수

szInitString
[in] 데이터 원본의 초기화 문자열입니다.

반환 값

표준 HRESULT.

CDataConnection::OpenNewSession

현재 연결 개체의 데이터 원본을 사용하여 새 세션을 엽니다.

구문

HRESULT OpenNewSession(CSession & session) throw();

매개 변수

session
[in/out] 새 세션 개체에 대한 참조입니다.

설명

새 세션은 현재 연결 개체의 포함된 데이터 원본 개체를 부모로 사용하며 데이터 원본과 동일한 모든 정보에 액세스할 수 있습니다.

반환 값

표준 HRESULT.

CDataConnection::operator BOOL

현재 세션이 열려 있는지 여부를 확인합니다.

구문

operator BOOL() throw();

설명

반환 BOOL (MFC typedef) 값입니다. TRUE 는 현재 세션이 열려 있는 것을 의미합니다. FALSE 는 현재 세션이 닫혀 있는 것을 의미합니다.

CDataConnection::operator bool (OLE DB)

현재 세션이 열려 있는지 여부를 확인합니다.

구문

operator bool() throw();

설명

bool (C++ 데이터 형식) 값을 반환합니다. true 는 현재 세션이 열려 있는 것을 의미합니다. false 는 현재 세션이 닫혀 있는 것을 의미합니다.

CDataConnection::operator CDataSource&

포함된 개체에 대한 참조를 CDataSource 반환합니다.

구문

operator const CDataSource&() throw();

설명

이 연산자는 포함된 CDataSource 개체에 대한 참조를 반환하여 참조가 필요한 개체 CDataSource 를 CDataConnection 전달할 수 있도록 합니다.

예시

참조를 사용하는 CDataSource 함수(예: func 아래)가 있는 경우 개체를 CDataConnection 전달하는 데 대신 사용할 CDataSource& 수 있습니다.

void SourceFunc(const CDataSource& theSource)
{
   CComVariant var;
   theSource.GetProperty(DBPROPSET_DATASOURCEINFO, DBPROP_DATASOURCENAME, &var);
}

 

CDataConnection dc;
dc.Open(szInit);
SourceFunc(dc);

CDataConnection::operator CDataSource*

포함된 CDataSource 개체에 대한 포인터를 반환합니다.

구문

operator const CDataSource*() throw();

설명

이 연산자는 CDataSource 포인터가 예상되는 위치에 CDataConnection 개체를 전달할 수 있게 해주는, 포함된 CDataSource 개체에 대한 포인터를 반환합니다.

사용 예제를 참조하세요 operator CDataSource& .

CDataConnection::operator CSession&

포함된 개체에 대한 참조를 CSession 반환합니다.

구문

operator const CSession&();

설명

이 연산자는 포함된 CSession 개체에 대한 참조를 반환하여 참조가 필요한 개체 CSession 를 CDataConnection 전달할 수 있도록 합니다.

예시

참조를 사용하는 CSession 함수(예: func 아래)가 있는 경우 개체를 CDataConnection 전달하는 데 대신 사용할 CSession& 수 있습니다.

void SessionFunc(const CSession& theSession)
{
   XACTTRANSINFO info = {0};
   HRESULT hr = theSession.GetTransactionInfo(&info);
   wprintf_s(_T("GetTransactionInfo returned %x\n"), hr);
}

 

CDataConnection dc;
dc.Open(szInit);
SessionFunc(dc);

CDataConnection::operator CSession*

포함된 CSession 개체에 대한 포인터를 반환합니다.

구문

operator const CSession*() throw();

설명

이 연산자는 CSession 포인터가 예상되는 위치에 CDataConnection 개체를 전달할 수 있게 해주는, 포함된 CSession 개체에 대한 포인터를 반환합니다.

예시

사용 예제를 참조하세요 operator CSession& .

참고 항목

OLE DB 소비자 템플릿
OLE DB 소비자 템플릿 참조