CommandBehavior-Enumeration
Stellt eine Beschreibung der Ergebnisse der Abfrage sowie ihrer Auswirkungen auf die Datenbank bereit.
Diese Enumeration verfügt über ein FlagsAttribute -Attribut, das die bitweise Kombination der Memberwerte zulässt.
Namespace: System.Data
Assembly: System.Data (in system.data.dll)
Syntax
'Declaration
<FlagsAttribute> _
Public Enumeration CommandBehavior
'Usage
Dim instance As CommandBehavior
[FlagsAttribute]
public enum CommandBehavior
[FlagsAttribute]
public enum class CommandBehavior
/** @attribute FlagsAttribute() */
public enum CommandBehavior
FlagsAttribute
public enum CommandBehavior
Member
| Membername | Beschreibung | |
|---|---|---|
.gif) |
CloseConnection | Beim Ausführen des Befehls wird das zugeordnete Connection-Objekt geschlossen, wenn das zugeordnete DataReader-Objekt geschlossen wird. |
|
Default | Die Abfrage kann mehrere Resultsets zurückgeben. Die Ausführung der Abfrage kann sich auf den Zustand der Datenbank auswirken. Default legt keine CommandBehavior-Flags fest, sodass der Aufruf von ExecuteReader(CommandBehavior.Default) funktionell dem Aufruf von ExecuteReader() entspricht. |
|
KeyInfo | Die Abfrage gibt Informationen über Spalten und Primärschlüssel zurück.
Bei Verwendung von KeyInfo für die Befehlsausführung fügt der Anbieter für vorhandene Primärschlüssel- und Timestampspalten weitere Spalten an das Resultset an. Bei Verwendung von KeyInfo stellt der .NET Framework-Datenanbieter für SQL Server der auszuführenden Anweisung SET FMTONLY OFF und SET NO_BROWSETABLE ON voran. Der Benutzer muss mögliche Nebeneffekte beachten, z. B. Beeinträchtigungen bei der Verwendung von SET FMTONLY ON-Anweisungen. Weitere Informationen finden Sie in der SQL Server-Onlinedokumentation. |
|
SchemaOnly | Die Abfrage gibt nur Spalteninformationen zurück. Bei Verwendung von SchemaOnly stellt der .NET Framework-Datenanbieter für SQL Server der auszuführenden Anweisung SET FMTONLY ON voran. |
|
SequentialAccess | Ermöglicht dem DataReader das Behandeln von Zeilen, die Spalten mit großen Binärwerten enthalten. Statt des Ladens der gesamten Zeile ermöglicht SequentialAccess dem DataReader das Laden der Daten als Stream. Anschließend können Sie mit der GetBytes-Methode oder der GetChars-Methode eine Byteposition für den Beginn des Lesevorgangs sowie eine eingeschränkte Puffergröße für die zurückgegebenen Daten angeben.
Wenn Sie SequentialAccess angeben, müssen die Spalten in der Reihenfolge ihrer Rückgabe gelesen werden, auch wenn nicht alle Spalten gelesen werden müssen. Wenn über eine Position im zurückgegebenen Datenstream hinaus gelesen wurde, können Daten an oder vor dieser Position nicht mehr vom DataReader gelesen werden. Bei der Verwendung von OleDbDataReader können Sie den aktuellen Spaltenwert erneut lesen, bis darüber hinaus gelesen wird. Bei der Verwendung von SqlDataReader können Sie einen Spaltenwert nur einmal lesen. |
|
SingleResult | Die Abfrage gibt ein einziges Resultset zurück. |
|
SingleRow | Die Abfrage soll eine einzige Zeile zurückgeben. Die Ausführung der Abfrage kann sich auf den Zustand der Datenbank auswirken. Einige .NET Framework-Datenprovider können mit diesen Informationen die Leistung des Befehls optimieren (dies ist jedoch nicht unbedingt erforderlich). Wenn Sie SingleRow mit der ExecuteReader-Methode des OleDbCommand-Objekts angeben, führt der .NET Framework-Datenanbieter für OLE DB eine Bindung mithilfe der OLE DB IRow-Schnittstelle durch, sofern diese verfügbar ist. Andernfalls wird die IRowset-Schnittstelle verwendet. Wenn die SQL-Anweisung nur eine einzige Zeile zurückgeben soll, kann durch Angeben von SingleRow auch die Leistung der Anwendung verbessert werden. SingleRow kann auch beim Ausführen von Abfragen angegeben werden, die mehrere Resultsets zurückgeben. In diesem Fall werden zwar mehrere Resultsets zurückgegeben, jedes Resultset weist jedoch nur eine einzige Zeile auf. |
Hinweise
Die CommandBehavior-Werte werden von der ExecuteReader-Methode von IDbCommand und von allen davon abgeleiteten Klassen verwendet.
Eine bitweise Kombination dieser Werte kann verwendet werden.
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0