Partilhar via


CommandBehavior Enumeração

Definição

Fornece uma descrição dos resultados da consulta e seu efeito sobre o banco de dados.

Essa enumeração dá suporte a uma combinação bit a bit dos valores de membro.

public enum class CommandBehavior
[System.Flags]
public enum CommandBehavior
[<System.Flags>]
type CommandBehavior = 
Public Enum CommandBehavior
Herança
CommandBehavior
Atributos

Campos

CloseConnection 32

Quando o comando é executado, o objeto Connection associado é fechado quando o objeto DataReader associado é fechado.

Default 0

A consulta pode retornar vários conjuntos de resultados. A execução da consulta pode afetar o estado do banco de dados. Default não define sinalizadores CommandBehavior e, portanto, chamar ExecuteReader(CommandBehavior.Default) é funcionalmente equivalente a chamar ExecuteReader().

KeyInfo 4

A consulta retorna informações da coluna e da chave primária. O provedor acrescenta colunas extras ao conjunto de resultados das colunas de chave primária e carimbo de data/hora existentes.

SchemaOnly 2

A consulta retorna somente informações de coluna. Ao usar o SchemaOnly, o Provedor de Dados .NET Framework para SQL Server precede a instrução executada com SET FMTONLY ON.

SequentialAccess 16

Fornece uma maneira para que o DataReader manipule linhas que contêm colunas com valores binários grandes. Em vez de carregar a linha inteira, SequentialAccess permite que o DataReader carregue os dados como um fluxo. 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.

SingleResult 1

A consulta retorna um único conjunto de resultados.

SingleRow 8

A consulta deve retornar uma única linha do primeiro conjunto de resultados. A execução da consulta pode afetar o estado do banco de dados. Alguns provedores de dados .NET podem, mas não precisam, usar essas informações para otimizar o desempenho do comando. 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. Caso contrário, ele usará a interface IRowset. Se a instrução SQL dever retornar apenas uma única linha, especificar SingleRow também poderá melhorar o desempenho do aplicativo. É possível especificar SingleRow ao executar consultas que devem retornar conjuntos de vários resultados. 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. Os outros conjuntos de resultados da consulta não serão retornados.

Comentários

Para obter mais informações sobre essa API, consulte Comentários da API complementar para CommandBehavior.

Aplica-se a