CommandBehavior Enumerazione
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
- Attributi
Campi
| Nome | Valore | Descrizione |
|---|---|---|
| Default | 0 | La query può restituire più set di risultati. L'esecuzione della query può influire sullo stato del database.
|
| 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 |
| SequentialAccess | 16 | Consente all'oggetto |
| CloseConnection | 32 | Quando viene eseguito il comando, l'oggetto associato viene chiuso quando l'oggetto associato |
Commenti
I CommandBehavior valori vengono utilizzati dal ExecuteReader metodo di IDbCommand ed eventuali classi di implementazione.
È possibile usare una combinazione bit per bit di questi valori.
CommandBehavior viene ignorato quando viene usato per definire un SqlNotificationRequest oggetto o SqlDependency e pertanto non deve essere utilizzato. Usare il costruttore che non richiede un CommandBehavior parametro in questi due casi.
Note sui singoli membri di enumerazione
Quando si usa KeyInfo, il provider di dati .NET Framework per SQL Server precede l'istruzione eseguita con SET FMTONLY OFF e SET NO_BROWSETABLE ON. Gli utenti devono essere consapevoli dei potenziali effetti collaterali, ad esempio l'interferenza nell'uso di SET FMTONLY ON dichiarazioni. Per altre informazioni, vedere SET FMTONLY (Transact-SQL).
Note
Usare SequentialAccess per recuperare valori di grandi dimensioni e dati binari. In caso contrario, potrebbe verificarsi un OutOfMemoryException e la connessione verrà chiusa.
Quando si specifica SequentialAccess, è necessario leggere dalle colonne nell'ordine in cui vengono restituiti, anche se non è necessario leggere ogni colonna. Dopo aver letto oltre una posizione nel flusso restituito di dati, i dati in corrispondenza o prima di tale posizione non possono più essere letti da DataReader. Quando si usa OleDbDataReader, è possibile rileggere il valore della colonna corrente fino a quando non viene letto oltre. Quando si usa SqlDataReader, è possibile leggere un valore di colonna una sola volta.
