CommandBehavior Enumeração

Definição

Fornece uma descrição dos resultados da consulta e seu efeito no 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

Nome Valor Description
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 , portanto, a chamada ExecuteReader(CommandBehavior.Default) é funcionalmente equivalente à chamada ExecuteReader().

SingleResult 1

A consulta retorna um único conjunto de resultados.

SchemaOnly 2

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

KeyInfo 4

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

SingleRow 8

Espera-se que a consulta retorne 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 são necessários, usar essas informações para otimizar o desempenho do comando. Quando você especifica SingleRow com o método ExecuteReader() do objeto OleDbCommand, o .NET Framework Provedor de Dados para OLE DB executa a associação usando a interface OLE DB IRow se estiver disponível. Caso contrário, ele usará a IRowset interface. Se sua instrução SQL deve retornar apenas uma única linha, a especificação SingleRow também pode melhorar o desempenho do aplicativo. É possível especificar SingleRow ao executar consultas que devem retornar vários conjuntos de 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.

SequentialAccess 16

Fornece uma maneira de DataReader lidar com linhas que contêm colunas com valores binários grandes. Em vez de carregar a linha inteira, SequentialAccess permite DataReader carregar dados como um fluxo. Em seguida, você pode usar o método ou GetChars o GetBytes método para especificar um local de bytes para iniciar a operação de leitura e um tamanho de buffer limitado para os dados que estão sendo retornados.

CloseConnection 32

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

Comentários

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

Aplica-se a