CommandBehavior Enumeration

Definition

Namespace:
System.Data
Assembly:
System.Data.Common.dll
Assemblys:
netstandard.dll, System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll
Quelle:
CommandBehavior.cs
Quelle:
CommandBehavior.cs
Quelle:
DataColumn.cs

Stellt eine Beschreibung der Ergebnisse der Abfrage und deren Auswirkungen auf die Datenbank bereit.

Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.

public enum class CommandBehavior
[System.Flags]
public enum CommandBehavior
[<System.Flags>]
type CommandBehavior = 
Public Enum CommandBehavior
Vererbung
Object
ValueType
Enum
CommandBehavior
Attribute
FlagsAttribute

Felder

Name Wert Beschreibung
Default 0

Die Abfrage gibt möglicherweise mehrere Resultsets zurück. Die Ausführung der Abfrage kann sich auf den Datenbankstatus auswirken. Default legt keine CommandBehavior Flags fest, sodass der Aufruf ExecuteReader(CommandBehavior.Default) funktionell dem Aufrufen ExecuteReader()entspricht.
SingleResult 1

Die Abfrage gibt ein einzelnes Resultset zurück.
SchemaOnly 2

Die Abfrage gibt nur Spalteninformationen zurück. Bei Verwendung von SchemaOnly steht das .NET Framework Datenanbieter für SQL Server vor der Anweisung, die mit SET FMTONLY ON ausgeführt wird.
KeyInfo 4

Die Abfrage gibt Spalten- und Primärschlüsselinformationen zurück. Der Anbieter fügt zusätzliche Spalten an das Resultset für vorhandene Primärschlüssel- und Zeitstempelspalten an.
SingleRow 8

Die Abfrage wird erwartet, dass eine einzelne Zeile des ersten Resultsets zurückgegeben wird. Die Ausführung der Abfrage kann sich auf den Datenbankstatus auswirken. Einige .NET Datenanbieter können diese Informationen jedoch nicht verwenden, um die Leistung des Befehls zu optimieren. Wenn Sie SingleRow mit der ExecuteReader()-Methode des OleDbCommand-Objekts angeben, führt das .NET Framework Datenanbieter für OLE DB eine Bindung mithilfe der OLE DB-Schnittstelle IRowschnittstelle aus, sofern verfügbar. Andernfalls wird die IRowset Schnittstelle verwendet. Wenn ihre SQL-Anweisung erwartet wird, dass nur eine einzelne Zeile zurückgegeben wird, kann die Angabe SingleRow auch die Anwendungsleistung verbessern. Es ist möglich, beim Ausführen von Abfragen anzugeben SingleRow , die erwartet werden, dass mehrere Resultsets zurückgegeben werden. Wenn in diesem Fall sowohl eine SQL-Abfrage mit mehreren Resultset als auch eine einzelne Zeile angegeben werden, enthält das zurückgegebene Ergebnis nur die erste Zeile des ersten Resultsets. Die anderen Resultsets der Abfrage werden nicht zurückgegeben.
SequentialAccess 16

Bietet eine Möglichkeit zum Behandeln von Zeilen, die DataReader Spalten mit großen Binärwerten enthalten. Statt die gesamte Zeile zu laden, SequentialAccess können die DataReader Daten als Datenstrom geladen werden. Anschließend können Sie mit der GetBytes Oder-Methode GetChars einen Bytespeicherort angeben, um den Lesevorgang zu starten, und eine begrenzte Puffergröße für die zurückgegebenen Daten.
CloseConnection 32

Wenn der Befehl ausgeführt wird, wird das zugeordnete Connection Objekt geschlossen, wenn das zugeordnete DataReader Objekt geschlossen wird.

Hinweise

Die CommandBehavior Werte werden von der Methode ExecuteReader von IDbCommand und allen implementierenden Klassen verwendet.

Eine bitweise Kombination dieser Werte kann verwendet werden.

CommandBehavior wird ignoriert, wenn es zum Definieren eines SqlNotificationRequest oder SqlDependency verwendet wird und sollte daher nicht verwendet werden. Verwenden Sie den Konstruktor, der in diesen beiden Fällen keinen Parameter erfordert CommandBehavior .

Hinweise zu einzelnen Enumerationsmitgliedern

Bei der Verwendung von KeyInfo führt der .NET Framework-Datenanbieter für SQL Server der Anweisung, die ausgeführt wird, SET FMTONLY OFF und SET NO_BROWSETABLE ON voraus. Benutzer sollten sich über potenzielle Nebenwirkungen im Klaren sein, wie z. B. Beeinträchtigungen bei der Nutzung von SET FMTONLY ON-Anweisungen. Weitere Informationen finden Sie unter SET FMTONLY (Transact-SQL).

Note

Verwenden Sie SequentialAccess, um große Werte und Binärdaten abzurufen. Andernfalls kann ein OutOfMemoryException auftreten, und die Verbindung wird geschlossen.

Wenn Sie SequentialAccess angeben, sind Sie verpflichtet, aus den Spalten in der Reihenfolge zu lesen, in der sie zurückgegeben werden, obwohl Sie nicht jede Spalte lesen müssen. Nachdem Sie einen Speicherort im zurückgegebenen Datenstrom gelesen haben, können die Daten an oder vor diesem Speicherort nicht mehr aus dem DataReader gelesen werden. Bei der Verwendung von OleDbDataReader können Sie den aktuellen Spaltenwert so oft wie nötig erneut lesen, bis Sie darüber hinaus lesen. Bei Verwendung des Werts SqlDataReaderkönnen Sie einen Spaltenwert nur einmal lesen.

Gilt für: