ActiveConnection 속성(ADO)

아티클
05/30/2023

지정한 Command, Recordset 또는 Record 개체가 현재 속한 Connection 개체를 나타냅니다.

설정 및 반환 값

연결이 닫힌 경우 연결에 대한 정의가 들어 있는 String 값을 설정하거나 반환하고, 연결이 열려 있는 경우 현재 Connection 개체를 포함하는 Variant를 설정하거나 반환합니다. 기본값은 null 개체 참조입니다. ConnectionString 속성을 참조하세요.

설명

ActiveConnection 속성을 사용하여 지정된 Command 개체가 실행되거나 지정된 Recordset가 열릴 Connection 개체를 결정합니다.

명령

Command 개체의 경우 ActiveConnection 속성은 읽기/쓰기입니다.

이 속성을 열려 있는 Connection 개체 또는 유효한 연결 문자열로 설정하기 전에 Command 개체에서 Execute 메서드를 호출하려고 하면 오류가 발생합니다.

Connection 개체가 ActiveConnection 속성에 할당된 경우 개체는 열려 있어야 합니다. 닫힌 Connection 개체를 할당하면 오류가 발생합니다.

참고

Microsoft Visual BasicActiveConnection 속성을 Nothing으로 설정하면 Command 개체가 현재 Connection에서 분리되고 공급자가 데이터 원본에서 연결된 리소스를 해제합니다. 그런 다음, Command 개체를 동일하거나 다른 Connection 개체와 연결할 수 있습니다. 일부 공급자는 먼저 속성을 Nothing으로 설정하지 않고도 속성 설정을 한 Connection에서 다른 연결로 변경할 수 있습니다.

Command 개체의 Parameters 컬렉션에 공급자가 제공한 매개 변수가 포함된 경우 ActiveConnection 속성을 Nothing 또는 다른 Connection 개체로 설정하면 컬렉션이 지워집니다. 수동으로 Parameter 개체를 만들고 이를 사용하여 Command 개체의 Parameters 컬렉션을 채우는 경우 ActiveConnection 속성을 Nothing 또는 다른 Connection 개체로 설정하면 Parameters 컬렉션이 그대로 유지됩니다.

Command 개체가 연결된 Connection 개체를 닫으면 ActiveConnection 속성이 Nothing으로 설정됩니다. 이 속성을 닫힌 Connection 개체로 설정하면 오류가 발생합니다.

레코드 집합

열려 있는 Recordset 개체 또는 Source 속성이 유효한 Command 개체로 설정된 Recordset 개체의 경우 ActiveConnection 속성은 읽기 전용입니다. 이외의 경우에는 읽기/쓰기입니다.

이 속성을 유효한 Connection 개체 또는 유효한 연결 문자열로 설정할 수 있습니다. 이 경우 공급자는 이 정의를 사용하여 새 Connection 개체를 만들고 연결을 엽니다. 또한 공급자는 확장된 오류 정보를 위해 Connection 개체에 액세스하거나 다른 명령을 실행하는 방법을 제공하기 위해 이 속성을 새 Connection 개체로 설정할 수 있습니다.

Open 메서드의 ActiveConnection 인수를 사용하여 Recordset 개체를 열면 ActiveConnection 속성이 인수 값을 상속합니다.

Recordset 개체의 Source 속성을 유효한 Command 개체 변수로 설정하는 경우 Recordset의 ActiveConnection 속성은 Command 개체의 ActiveConnection 속성 설정을 상속합니다.

참고

원격 데이터 서비스 사용 클라이언트 쪽 Recordset 개체에서 사용하는 경우 이 속성은 연결 문자열로만 설정하거나 Microsoft Visual Basic 또는 Visual Basic, Scripting Edition에서는 Nothing으로 설정할 수 있습니다.

레코드

이 속성은 Record 개체가 닫혀 있을 때 읽기/쓰기이며 열린 Connection 개체에 대한 연결 문자열 또는 참조를 포함할 수 있습니다. 이 속성은 Record 개체가 열려 있을 때 읽기 전용이며 열린 Connection 개체에 대한 참조를 포함합니다.

Connection 개체는 URL에서 Record 개체를 열 때 암시적으로 만들어집니다. Connection 개체를 이 속성에 할당하거나 Open 메서드 호출에서 Connection 개체를 매개 변수로 사용하여 기존 열려 있는 Connection 개체를 사용하여 Record를 엽니다. 기존 Record 또는 Recordset에서 Record를 열면 해당 Record 또는 Recordset 개체의 Connection 개체와 자동으로 연결됩니다.