다음을 통해 공유


CommandBehavior 열거형

정의

쿼리의 결과와 데이터베이스에 미치는 영향을 설명합니다.

이 열거형은 멤버 값의 비트 조합을 지원합니다.

public enum class CommandBehavior
[System.Flags]
public enum CommandBehavior
[<System.Flags>]
type CommandBehavior = 
Public Enum CommandBehavior
상속
CommandBehavior
특성

필드

CloseConnection 32

명령을 실행하면 관련 Connection 개체는 관련 DataReader 개체가 닫힐 때 함께 닫힙니다.

Default 0

쿼리는 여러 결과 집합을 반환할 수 있습니다. 쿼리를 실행하면 데이터베이스 상태에 영향을 미칠 수 있습니다. DefaultCommandBehavior 플래그를 설정하지 않으므로 ExecuteReader(CommandBehavior.Default) 호출과 ExecuteReader() 호출은 기능적으로 동일합니다.

KeyInfo 4

쿼리는 열과 기본 키 정보를 반환하며 공급자는 기존의 기본 키 및 타임스탬프 열의 결과 세트에 추가 열을 추가합니다.

SchemaOnly 2

쿼리에서 열 정보만 반환합니다. SchemaOnly를 사용할 때 .NET Framework Data Provider for SQL Server에서는 실행되는 문 앞에 SET FMTONLY ON을 배치합니다.

SequentialAccess 16

DataReader에서 대형 이진 값을 갖는 열이 포함된 행을 처리하는 방법을 제공합니다. 전체 행을 로드하지 않고 SequentialAccess를 사용하여 DataReader에서 데이터를 스트림으로 로드할 수 있습니다. 그런 다음 GetBytes 또는 GetChars 메서드를 사용하여 읽기 작업을 시작할 바이트 위치와 반환될 데이터의 제한된 버퍼 크기를 지정할 수 있습니다.

SingleResult 1

쿼리는 단일 결과 집합을 반환합니다.

SingleRow 8

쿼리가 첫 번째 결과 집합의 단일 행을 반환해야 합니다. 쿼리를 실행하면 데이터베이스 상태에 영향을 미칠 수 있습니다. 일부 .NET 데이터 공급자는 이 정보를 사용하여 명령의 성능을 최적화할 수 있지만 반드시 사용해야 하는 것은 아닙니다. SingleRow 개체의 ExecuteReader() 메서드를 사용하여 OleDbCommand를 지정할 때 .NET Framework Data Provider for OLE DB에서는 OLE DB IRow 인터페이스가 사용 가능하면 이 인터페이스를 사용하여 바인딩을 수행하고, 그렇지 않으면 IRowset 인터페이스를 사용합니다. SQL 문이 단일 행만 반환해야 하는 경우 SingleRow를 지정하여 애플리케이션의 성능을 향상시킬 수도 있습니다. 여러 결과 집합을 반환해야 하는 쿼리를 실행할 경우 SingleRow를 지정할 수 있습니다. 이 경우 여러 결과 집합 SQL 쿼리와 단일 행이 둘 다 지정되어 있으면 반환된 결과에 첫 번째 결과 집합의 첫 번째 행만 포함됩니다. 쿼리의 나머지 결과 집합은 반환되지 않습니다.

설명

이 API에 대한 자세한 내용은 CommandBehavior에 대한 추가 API 설명을 참조하세요.

적용 대상