CommandBehavior Enumeração

Definição

Fornece uma descrição dos resultados da consulta e seu efeito sobre o banco de dados.Provides a description of the results of the query and its effect on the database.

Esta enumeração tem um atributo FlagsAttribute que permite uma combinação bit a bit dos valores membros dela.

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.When the command is executed, the associated Connection object is closed when the associated DataReader object is closed.

Default 0

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().

KeyInfo 4

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.

SchemaOnly 2

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.

SequentialAccess 16

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.

SingleResult 1

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

SingleRow 8

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.

Comentários

Os CommandBehavior valores são usados pelo ExecuteReader método de IDbCommand e por qualquer classe de implementação.The CommandBehavior values are used by the ExecuteReader method of IDbCommand and any implementing classes.

Pode ser usada uma combinação bit-A de bits desses valores.A bitwise combination of these values may be used.

CommandBehavior é ignorado quando usado para definir um SqlNotificationRequest ou SqlDependency e, portanto, não deve ser usado.CommandBehavior is ignored when used to define a SqlNotificationRequest or SqlDependency and should therefore not be used. Use o construtor que não requer um CommandBehavior parâmetro nesses dois casos.Use the constructor that does not require a CommandBehavior parameter in these two cases.

Observações sobre membros de enumeração individuaisNotes on individual enumeration members

Ao usar KeyInfo o, o .NET Framework provedor de dados para SQL Server precede a instrução que está sendo executada com SET FMTONLY OFF and SET 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. O usuário deve estar ciente de possíveis efeitos colaterais, como interferência com o uso de SET FMTONLY ON instruções.The user should be aware of potential side effects, such as interference with the use of SET FMTONLY ON statements. Para obter mais informações, confira SET FMTONLY (Transact-SQL).For more information, see SET FMTONLY (Transact-SQL).

Observação

Use SequentialAccess para recuperar valores grandes e dados binários.Use SequentialAccess to retrieve large values and binary data. Caso contrário, um OutOfMemoryException pode ocorrer e a conexão será fechada.Otherwise, an OutOfMemoryException might occur and the connection will be closed.

Quando você especifica SequentialAccess , é necessário ler as colunas na ordem em que elas são retornadas, embora não seja necessário ler cada coluna.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. Depois de ler após um local no fluxo de dados retornado, os dados nesse local ou antes dele não poderão mais ser lidos do 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. Ao usar o OleDbDataReader , você pode ler novamente o valor da coluna atual até a leitura depois dela.When using the OleDbDataReader, you can reread the current column value until reading past it. Ao usar o SqlDataReader , você pode ler um valor de coluna apenas uma vez.When using the SqlDataReader, you can read a column value only once.

Aplica-se a