CommandBehavior CommandBehavior CommandBehavior CommandBehavior Enum

Definizione

Fornisce una descrizione dei risultati della query e dei relativi effetti sul database.Provides a description of the results of the query and its effect on the database.

Questa enumerazione ha un attributo FlagsAttribute che consente una combinazione bit per bit dei valori del relativo membro.

public enum class CommandBehavior
[System.Flags]
public enum CommandBehavior
type CommandBehavior = 
Public Enum CommandBehavior
Ereditarietà
CommandBehaviorCommandBehaviorCommandBehaviorCommandBehavior
Attributi

Campi

CloseConnection CloseConnection CloseConnection CloseConnection 32

Durante l'esecuzione del comando, l'oggetto Connection associato viene chiuso alla chiusura dell'oggetto DataReader associato.When the command is executed, the associated Connection object is closed when the associated DataReader object is closed.

Default Default Default Default 0

È possibile che la query restituisca più set di risultati.The query may return multiple result sets. L'esecuzione della query può influire sullo stato del database.Execution of the query may affect the database state. Default non imposta flag CommandBehavior, quindi chiamare ExecuteReader(CommandBehavior.Default) equivale dal punto di vista funzionale a chiamare ExecuteReader().Default sets no CommandBehavior flags, so calling ExecuteReader(CommandBehavior.Default) is functionally equivalent to calling ExecuteReader().

KeyInfo KeyInfo KeyInfo KeyInfo 4

La query restituisce informazioni sulle colonne e sulle chiavi primarie.The query returns column and primary key information. Il provider accoda colonne aggiuntive al set di risultati per la chiave primaria esistente e le colonne timestamp.The provider appends extra columns to the result set for existing primary key and timestamp columns.

SchemaOnly SchemaOnly SchemaOnly SchemaOnly 2

La query restituisce solo le informazioni sulla colonna.The query returns column information only. Se si utilizza il campo SchemaOnly, il provider di dati .NET Framework Data per SQL Server precede l'istruzione in fase di esecuzione con SET FMTONLY ON.When using SchemaOnly, the .NET Framework Data Provider for SQL Server precedes the statement being executed with SET FMTONLY ON.

SequentialAccess SequentialAccess SequentialAccess SequentialAccess 16

Consente a DataReader di gestire le righe contenenti colonne con valori binari di grandi dimensioni.Provides a way for the DataReader to handle rows that contain columns with large binary values. Anziché caricare l'intera riga, SequentialAccess consente a DataReader di caricare i dati come flusso.Rather than loading the entire row, SequentialAccess enables the DataReader to load data as a stream. È quindi possibile utilizzare il metodo GetBytes o GetChars per specificare una posizione di byte in cui avviare l'operazione di lettura e una dimensione limitata del buffer per i dati restituiti.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 SingleResult SingleResult SingleResult 1

La query restituisce un singolo set di risultati.The query returns a single result set.

SingleRow SingleRow SingleRow SingleRow 8

È previsto che la query restituisca una singola riga del primo set di risultati.The query is expected to return a single row of the first result set. L'esecuzione della query può influire sullo stato del database.Execution of the query may affect the database state. È possibile, ma non necessario, che alcuni provider di dati .NET Framework utilizzino queste informazioni per ottimizzare le prestazioni del comando.Some .NET Framework data providers may, but are not required to, use this information to optimize the performance of the command. Quando si specifica SingleRow con il metodo ExecuteReader() dell'oggetto OleDbCommand, il provider di dati .NET Framework di OLE DB esegue l'associazione mediante l'interfaccia IRow OLE DB, se disponibile.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. In caso contrario, utilizza l'interfaccia IRowset.Otherwise, it uses the IRowset interface. Se si prevede che l'istruzione SQL restituisca solo una singola riga, è possibile specificare SingleRow per migliorare le prestazioni dell'applicazione.If your SQL statement is expected to return only a single row, specifying SingleRow can also improve application performance. È possibile specificare SingleRow quando si eseguono query che devono restituire più set di risultati.It is possible to specify SingleRow when executing queries that are expected to return multiple result sets. In tal caso, dove vengono specificate sia una query SQL con più set di risultati sia una singola riga, il risultato restituito conterrà solo la prima riga del primo set di risultati.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. Gli altri set di risultati della query non verranno restituiti.The other result sets of the query will not be returned.

Commenti

Il CommandBehavior valori vengono utilizzati dal ExecuteReader metodo IDbCommand e classi di implementazione.The CommandBehavior values are used by the ExecuteReader method of IDbCommand and any implementing classes.

Una combinazione bit per bit dei valori seguenti può essere utilizzata.A bitwise combination of these values may be used.

CommandBehavior viene ignorata se utilizzata per definire un SqlNotificationRequest o SqlDependency e pertanto non deve essere utilizzato.CommandBehavior is ignored when used to define a SqlNotificationRequest or SqlDependency and should therefore not be used. Usare il costruttore che non richiede un CommandBehavior parametro in questi due casi.Use the constructor that does not require a CommandBehavior parameter in these two cases.

Note sui membri di enumerazione singoliNotes on individual enumeration members

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.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. L'utente deve essere consapevole dei potenziali effetti collaterali, ad esempio interferenza con l'uso di SET FMTONLY ON istruzioni.The user should be aware of potential side effects, such as interference with the use of SET FMTONLY ON statements. Per altre informazioni, vedere SET FMTONLY (Transact-SQL).For more information, see SET FMTONLY (Transact-SQL).

Nota

Usare SequentialAccess per recuperare i valori di grandi dimensioni e i dati binari.Use SequentialAccess to retrieve large values and binary data. In caso contrario, un OutOfMemoryException potrebbero verificarsi e la connessione verrà chiusa.Otherwise, an OutOfMemoryException might occur and the connection will be closed.

Quando si specifica SequentialAccess, viene richiesto di leggere dalle colonne nell'ordine in cui vengono restituite, sebbene non sia necessario per la lettura di ogni colonna.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. Dopo aver letto oltre una posizione nel flusso di dati restituito, i dati in corrispondenza o prima tale percorso non è più possono essere letti dal 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. Quando si usa il OleDbDataReader, è possibile ripetere il valore della colonna corrente fino alla lettura incollarlo.When using the OleDbDataReader, you can reread the current column value until reading past it. Quando si usa il SqlDataReader, è possibile leggere un valore di colonna una sola volta.When using the SqlDataReader, you can read a column value only once.

Si applica a