Enumeração de System.Data.CommandBehavior

Este artigo fornece comentários complementares à documentação de referência para esta API.

Os CommandBehavior valores são usados pelo ExecuteReader método de IDbCommand e quaisquer classes de implementação.

Uma combinação bit a bit desses valores pode ser usada.

CommandBehavior é ignorado quando usado para definir um SqlNotificationRequest ou SqlDependency e, portanto, não deve ser usado. Use o construtor que não requer um CommandBehavior parâmetro nesses dois casos.

Notas sobre membros individuais de enumeração

Ao usar KeyInfo, o Provedor de Dados do .NET Framework para SQL Server precede a instrução que está sendo executada com SET FMTONLY OFF e SET NO_BROWSETABLE ON. Os usuários devem estar cientes de possíveis efeitos colaterais, como interferência no uso de instruções SET FMTONLY ON. Para obter mais informações, consulte SET FMTONLY (Transact-SQL).

Observação

Use SequentialAccess para recuperar valores grandes e dados binários. Caso contrário, poderá ocorrer um OutOfMemoryException e a conexão será fechada.

Quando você especificar SequentialAccess, será necessário ler as colunas na ordem em que elas são retornadas, embora não seja necessário ler cada coluna. Uma vez que você tenha lido além de um local no fluxo de dados retornado, os dados nesse local ou antes dele não poderão mais ser lidos do DataReader. Ao usar o OleDbDataReader, você pode reler o valor da coluna atual até passar por ele. Ao usar o SqlDataReader, você pode ler um valor de coluna apenas uma vez.