CommandBehavior Enumerazione

Definizione

Spazio dei nomi:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Fornisce una descrizione dei risultati della query e del relativo effetto sul database.

Questa enumerazione supporta una combinazione bit per bit dei rispettivi valori dei membri.

public enum class CommandBehavior
[System.Flags]
public enum CommandBehavior
[<System.Flags>]
type CommandBehavior = 
Public Enum CommandBehavior
Ereditarietà
Object
ValueType
Enum
CommandBehavior
Attributi
FlagsAttribute

Campi

Nome Valore Descrizione
Default 0

La query può restituire più set di risultati. L'esecuzione della query può influire sullo stato del database. Default CommandBehavior non imposta alcun flag, quindi la chiamata ExecuteReader(CommandBehavior.Default) è funzionalmente equivalente alla chiamata ExecuteReader()a .
SingleResult 1

La query restituisce un singolo set di risultati.
SchemaOnly 2

La query restituisce solo informazioni sulla colonna. Quando si usa SchemaOnly, provider di dati framework di .NET per SQL Server precede l'istruzione eseguita con SET FMTONLY ON.
KeyInfo 4

La query restituisce informazioni sulla colonna e sulla chiave primaria. Il provider aggiunge colonne aggiuntive al set di risultati per le colonne di chiave primaria e timestamp esistenti.
SingleRow 8

Si prevede che la query restituisca una singola riga del primo set di risultati. L'esecuzione della query può influire sullo stato del database. Alcuni provider di dati .NET possono, ma non sono necessari, usare queste informazioni per ottimizzare le prestazioni del comando. Quando si specifica SingleRow con il metodo ExecuteReader() dell'oggetto OleDbCommand, il provider di dati framework di .NET per OLE DB esegue l'associazione utilizzando l'interfaccia OLE DB IRow, se disponibile. In caso contrario, usa l'interfaccia IRowset . Se si prevede che l'istruzione SQL restituisca una sola riga, specificando SingleRow può anche migliorare le prestazioni dell'applicazione. È possibile specificare SingleRow quando si eseguono query che devono restituire più set di risultati. In tal caso, in cui vengono specificate sia una query SQL del set di risultati con più risultati che una singola riga, il risultato restituito conterrà solo la prima riga del primo set di risultati. Gli altri set di risultati della query non verranno restituiti.
SequentialAccess 16

Consente all'oggetto DataReader di gestire le righe contenenti colonne con valori binari di grandi dimensioni. Anziché caricare l'intera riga, SequentialAccess consente a di DataReader caricare i dati come flusso. È quindi possibile usare il GetBytes metodo o GetChars per specificare un percorso di byte per avviare l'operazione di lettura e una dimensione del buffer limitata per i dati restituiti.
CloseConnection 32

Quando viene eseguito il comando, l'oggetto associato viene chiuso quando l'oggetto associato ConnectionDataReader viene chiuso.

Commenti

Per altre informazioni su questa API, vedere Osservazioni supplementari sull'API per CommandBehavior.

Si applica a