CommandBehavior CommandBehavior CommandBehavior CommandBehavior Enum

정의

쿼리의 결과와 데이터베이스에 미치는 영향을 설명합니다.Provides a description of the results of the query and its effect on the database.

이 열거형에는 멤버 값의 비트 조합을 허용하는 FlagsAttribute 특성이 있습니다.

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

필드

CloseConnection CloseConnection CloseConnection CloseConnection 32

명령을 실행하면 관련 Connection 개체는 관련 DataReader 개체가 닫힐 때 함께 닫힙니다.When the command is executed, the associated Connection object is closed when the associated DataReader object is closed.

Default Default Default Default 0

쿼리는 여러 결과 집합을 반환할 수 있습니다.The query may return multiple result sets. 쿼리를 실행하면 데이터베이스 상태에 영향을 미칠 수 있습니다.Execution of the query may affect the database state. DefaultCommandBehavior 플래그를 설정하지 않으므로 ExecuteReader(CommandBehavior.Default) 호출과 ExecuteReader() 호출은 기능적으로 동일합니다.Default sets no CommandBehavior flags, so calling ExecuteReader(CommandBehavior.Default) is functionally equivalent to calling ExecuteReader().

KeyInfo KeyInfo KeyInfo KeyInfo 4

쿼리는 열과 기본 키 정보를 반환하며The query returns column and primary key information. 공급자는 기존의 기본 키 및 타임스탬프 열의 결과 세트에 추가 열을 추가합니다.The provider appends extra columns to the result set for existing primary key and timestamp columns.

SchemaOnly SchemaOnly SchemaOnly SchemaOnly 2

쿼리에서 열 정보만 반환합니다.The query returns column information only. SchemaOnly를 사용할 때 .NET Framework Data Provider for SQL Server에서는 실행되는 문 앞에 SET FMTONLY ON을 배치합니다.When using SchemaOnly, the .NET Framework Data Provider for SQL Server precedes the statement being executed with SET FMTONLY ON.

SequentialAccess SequentialAccess SequentialAccess SequentialAccess 16

DataReader에서 대형 이진 값을 갖는 열이 포함된 행을 처리하는 방법을 제공합니다.Provides a way for the DataReader to handle rows that contain columns with large binary values. 전체 행을 로드하지 않고 SequentialAccess를 사용하여 DataReader에서 데이터를 스트림으로 로드할 수 있습니다.Rather than loading the entire row, SequentialAccess enables the DataReader to load data as a stream. 그런 다음 GetBytes 또는 GetChars 메서드를 사용하여 읽기 작업을 시작할 바이트 위치와 반환될 데이터의 제한된 버퍼 크기를 지정할 수 있습니다.You can then use the GetBytes or GetChars method to specify a byte location to start the read operation, and a limited buffer size for the data being returned.

SingleResult SingleResult SingleResult SingleResult 1

쿼리는 단일 결과 집합을 반환합니다.The query returns a single result set.

SingleRow SingleRow SingleRow SingleRow 8

쿼리가 첫 번째 결과 집합의 단일 행을 반환해야 합니다.The query is expected to return a single row of the first result set. 쿼리를 실행하면 데이터베이스 상태에 영향을 미칠 수 있습니다.Execution of the query may affect the database state. 일부 .NET Framework 데이터 공급자에서는 이 정보를 사용하여 명령의 성능을 최적화할 수도 있습니다.Some .NET Framework data providers may, but are not required to, use this information to optimize the performance of the command. SingleRow 개체의 ExecuteReader() 메서드를 사용하여 OleDbCommand를 지정할 때 .NET Framework Data Provider for OLE DB에서는 OLE DB IRow 인터페이스가 사용 가능하면 이 인터페이스를 사용하여 바인딩을 수행하고,When you specify SingleRow with the ExecuteReader() method of the OleDbCommand object, the .NET Framework Data Provider for OLE DB performs binding using the OLE DB IRow interface if it is available. 그렇지 않으면 IRowset 인터페이스를 사용합니다.Otherwise, it uses the IRowset interface. SQL 문이 단일 행만 반환해야 하는 경우 SingleRow를 지정하여 애플리케이션의 성능을 향상시킬 수도 있습니다.If your SQL statement is expected to return only a single row, specifying SingleRow can also improve application performance. 여러 결과 집합을 반환해야 하는 쿼리를 실행할 경우 SingleRow를 지정할 수 있습니다.It is possible to specify SingleRow when executing queries that are expected to return multiple result sets. 이 경우 여러 결과 집합 SQL 쿼리와 단일 행이 둘 다 지정되어 있으면 반환된 결과에 첫 번째 결과 집합의 첫 번째 행만 포함됩니다.In that case, where both a multi-result set SQL query and single row are specified, the result returned will contain only the first row of the first result set. 쿼리의 나머지 결과 집합은 반환되지 않습니다.The other result sets of the query will not be returned.

설명

CommandBehavior 값을 사용 합니다 ExecuteReader 메서드의 IDbCommand 및 구현 클래스입니다.The CommandBehavior values are used by the ExecuteReader method of IDbCommand and any implementing classes.

이러한 값의 비트 조합으로 사용할 수 있습니다.A bitwise combination of these values may be used.

CommandBehavior 정의 하는 데 사용 하는 경우 무시 됩니다는 SqlNotificationRequest 또는 SqlDependency 따라서 사용할 수 없습니다.CommandBehavior is ignored when used to define a SqlNotificationRequest or SqlDependency and should therefore not be used. 필요 없는 생성자를 사용 하 여는 CommandBehavior 두 경우에서 매개 변수입니다.Use the constructor that does not require a CommandBehavior parameter in these two cases.

개별 열거형 멤버에 대 한 참고 사항Notes on individual enumeration members

사용 하는 경우 KeyInfo,.NET Framework Data Provider for SQL Server 실행 되는 문 앞 SET FMTONLY OFFSET NO_BROWSETABLE ON입니다.When using KeyInfo, the .NET Framework Data Provider for SQL Server precedes the statement being executed with SET FMTONLY OFF and SET NO_BROWSETABLE ON. 사용자는 사용 하 여 간섭 같은 잠재적인 부작용이 발생 알고 있어야 합니다. SET FMTONLY ON 문입니다.The user should be aware of potential side effects, such as interference with the use of SET FMTONLY ON statements. 자세한 내용은 SET FMTONLY(Transact-SQL)를 참조하세요.For more information, see SET FMTONLY (Transact-SQL).

참고

사용 하 여 SequentialAccess 큰 값 및 이진 데이터를 검색 합니다.Use SequentialAccess to retrieve large values and binary data. 그렇지 않은 경우는 OutOfMemoryException 발생할 수 있으며 연결이 닫힙니다.Otherwise, an OutOfMemoryException might occur and the connection will be closed.

지정 하는 경우 SequentialAccess, 각 열을 읽이 필요는 없지만, 반환 되는 순서 대로 열에서 읽을 수 해야 합니다.When you specify SequentialAccess, you are required to read from the columns in the order they are returned, although you are not required to read each column. 더 이상 해당 위치 데이터를 읽을 수를 이전에 반환 되는 데이터 스트림의 위치를 읽은 후는 DataReader합니다.Once you have read past a location in the returned stream of data, data at or before that location can no longer be read from the DataReader. 사용 하는 경우는 OleDbDataReader,이 지나서 읽는 될 때까지 현재 열 값을 다시 읽을 수 있습니다.When using the OleDbDataReader, you can reread the current column value until reading past it. 사용 하는 경우는 SqlDataReader, 열 값을 한 번만 읽을 수 있습니다.When using the SqlDataReader, you can read a column value only once.

적용 대상