CommandBehavior Enumeração

Quando o comando é executado, o objeto Connection associado é fechado quando o objeto DataReader associado é fechado.When the command is executed, the associated Connection object is closed when the associated DataReader object is closed.

A consulta pode retornar vários conjuntos de resultados.The query may return multiple result sets. A execução da consulta pode afetar o estado do banco de dados.Execution of the query may affect the database state. Default não define sinalizadores CommandBehavior e, portanto, chamar ExecuteReader(CommandBehavior.Default) é funcionalmente equivalente a chamar ExecuteReader().Default sets no CommandBehavior flags, so calling ExecuteReader(CommandBehavior.Default) is functionally equivalent to calling ExecuteReader().

A consulta retorna informações da coluna e da chave primária.The query returns column and primary key information. O provedor acrescenta colunas extras ao conjunto de resultados das colunas de chave primária e carimbo de data/hora existentes.The provider appends extra columns to the result set for existing primary key and timestamp columns.

A consulta retorna somente informações de coluna.The query returns column information only. Ao usar o SchemaOnly, o Provedor de Dados .NET Framework para SQL Server precede a instrução executada com SET FMTONLY ON.When using SchemaOnly, the .NET Framework Data Provider for SQL Server precedes the statement being executed with SET FMTONLY ON.

Fornece uma maneira para que o DataReader manipule linhas que contêm colunas com valores binários grandes.Provides a way for the DataReader to handle rows that contain columns with large binary values. Em vez de carregar a linha inteira, SequentialAccess permite que o DataReader carregue os dados como um fluxo.Rather than loading the entire row, SequentialAccess enables the DataReader to load data as a stream. Use o método GetBytes ou GetChars para especificar um local de bytes para iniciar a operação de leitura e um tamanho do buffer limitado para os dados retornados.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.

A consulta retorna um único conjunto de resultados.The query returns a single result set.

A consulta deve retornar uma única linha do primeiro conjunto de resultados.The query is expected to return a single row of the first result set. A execução da consulta pode afetar o estado do banco de dados.Execution of the query may affect the database state. Alguns provedores de dados .NET podem, mas não precisam, usar essas informações para otimizar o desempenho do comando.Some .NET data providers may, but are not required to, use this information to optimize the performance of the command. Ao especificar SingleRow com o método ExecuteReader() do objeto OleDbCommand, o Provedor de Dados .NET Framework para OLE DB executará a associação usando a interface IRow do OLE DB, se ela estiver disponível.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. Caso contrário, ele usará a interface IRowset.Otherwise, it uses the IRowset interface. Se a instrução SQL dever retornar apenas uma única linha, especificar SingleRow também poderá melhorar o desempenho do aplicativo.If your SQL statement is expected to return only a single row, specifying SingleRow can also improve application performance. É possível especificar SingleRow ao executar consultas que devem retornar conjuntos de vários resultados.It is possible to specify SingleRow when executing queries that are expected to return multiple result sets. Nesse caso, em que uma consulta SQL de conjunto de vários resultados e uma única linha são especificadas, o resultado retornado conterá apenas a primeira linha do primeiro conjunto de resultados.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. Os outros conjuntos de resultados da consulta não serão retornados.The other result sets of the query will not be returned.