다음을 통해 공유

Command 개체(ADO)

  • 아티클

데이터 원본에 대해 실행하려는 특정 명령을 정의합니다.

발언

Command 개체를 사용하여 데이터베이스를 쿼리하고 Recordset 개체의 레코드를 반환하거나 대량 작업을 실행하거나 데이터베이스 구조를 조작할 수 있습니다. 공급자의 기능에 따라 일부 Command 컬렉션, 메서드 또는 속성이 참조될 때 오류가 발생할 수 있습니다.

Command 개체의 컬렉션, 메서드 및 속성을 사용하여 다음을 수행할 수 있습니다.

  • CommandText 속성을 사용하여 명령의 실행 텍스트(예: SQL 문)를 정의합니다. 또는 간단한 문자열(예: XML 템플릿 쿼리)이 아닌 명령 또는 쿼리 구조의 경우 CommandStream 속성을 사용하여 명령을 정의합니다.

  • 필요에 따라 CommandText 또는 CommandStream언어 속성에 사용되는 명령 방언을 나타냅니다.

  • Parameter 개체 및 Parameters 컬렉션을 사용하여 매개 변수가 있는 쿼리 또는 저장 프로시저 인수를 정의합니다.

  • NamedParameters 속성을 사용하여 매개 변수 이름을 공급자에 전달해야 하는지 여부를 나타냅니다.

  • 명령을 실행하고 Execute 메서드와 함께 적절한 경우 Recordset 개체를 반환합니다.

  • 실행 전에 CommandType 속성을 사용하여 명령 유형을 지정하여 성능을 최적화합니다.

  • Prepared 속성을 사용하여 실행하기 전에 공급자가 준비된(또는 컴파일된) 버전의 명령을 저장할지 여부를 제어합니다.

  • CommandTimeout 속성으로 명령이 실행될 때까지 공급자가 대기하는 시간(초)을 설정합니다.

  • ActiveConnection 속성을 설정하여 열려 있는 연결을 Command 개체와 연결합니다.

  • Name 속성을 설정하여 Command 개체를 연결된 Connection 개체의 메서드로 식별합니다.

  • RecordsetSource 속성에 Command 개체를 전달하여 데이터를 가져옵니다.

  • Properties 컬렉션을 사용하여 공급자별 특성에 액세스합니다.

메모

Command 개체를 사용하지 않고 쿼리를 실행하려면 쿼리 문자열을 Connection 개체의 Execute 메서드 또는 Recordset 개체의 Open 메서드에 전달합니다. 그러나 명령 텍스트를 유지하거나 다시 실행하거나 쿼리 매개 변수를 사용하려는 경우 Command 개체가 필요합니다.

이전에 정의된 Connection 개체와 독립적으로 Command 개체를 만들려면 ActiveConnection 속성을 유효한 연결 문자열로 설정합니다. ADO는 여전히 Connection 개체를 만들지만 해당 개체를 개체 변수에 할당하지는 않습니다. 그러나 여러 Command 개체를 동일한 연결로 연결하려는 경우 Connection 개체를 명시적으로 만들고 열어야 합니다. 그러면 Connection 개체가 개체 변수에 할당됩니다. 닫힌 Connection 개체를 할당하면 오류가 발생하므로 Connection 개체를 Command 개체의 ActiveConnection 속성에 할당하기 전에 성공적으로 열렸는지 확인합니다. Command 개체의 ActiveConnection 속성을 이 개체 변수로 설정하지 않으면 ADO는 동일한 연결 문자열을 사용하는 경우에도 각 Command 개체에 대해 새 Connection 개체를 만듭니다.

명령실행하려면 연결된 Connection 개체의 Name 속성으로 호출합니다. 명령ActiveConnection 속성이 Connection 개체로 설정되어 있어야 합니다. 명령 매개 변수가 있는 경우 해당 값을 인수로 메서드에 전달합니다.

둘 이상의 Command 개체가 동일한 연결에서 실행되고 Command 개체가 출력 매개 변수가 있는 저장 프로시저인 경우 오류가 발생합니다. 각 Command 개체를 실행하려면 별도의 연결을 사용하거나 연결에서 다른 모든 Command 개체의 연결을 끊습니다.

Parameters 컬렉션은 Command 개체의 기본 멤버입니다. 따라서 다음 두 코드 문은 동일합니다.

objCmd.Parameters.Item(0)  
objCmd(0)
  • Command 개체는 스크립팅에 안전하지 않습니다.

이 섹션에는 다음 항목이 포함되어 있습니다.

  • 명령 개체 속성, 메서드 및 이벤트

참고 항목

ADO(Connection Object)
ADO(Parameters 컬렉션)
ADO(속성 컬렉션)
부록 A: 공급자