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

I CommandBehavior valori vengono usati ExecuteReader dal metodo di e IDbCommand da qualsiasi classe di implementazione.The CommandBehavior values are used by the ExecuteReader method of IDbCommand and any implementing classes.

È possibile utilizzare una combinazione bit per bit di questi valori.A bitwise combination of these values may be used.

CommandBehaviorviene ignorato quando viene utilizzato per definire SqlNotificationRequest un SqlDependency oggetto o 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 singoli membri dell'enumerazioneNotes on individual enumeration members

Quando si KeyInfoUSA, il .NET Framework provider di dati 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 a conoscenza dei potenziali effetti collaterali, ad esempio l'interferenza SET FMTONLY ON con l'uso delle 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

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

Quando si specifica SequentialAccess, è necessario leggere le colonne nell'ordine in cui vengono restituite, anche se non è necessario leggere 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 una posizione nel flusso di dati restituito, i dati all'interno o prima di tale percorso non possono più essere letti da 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 utilizza OleDbDataReader, è possibile rileggere il valore della colonna corrente fino a quando non viene superato.When using the OleDbDataReader, you can reread the current column value until reading past it. Quando si usa 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