CommandBehavior Enumeration

Definition

Namespace:

System.Data

Assembly:

System.Data.dll

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

Weitere Informationen zu dieser API finden Sie in den ergänzenden API-Hinweisen für CommandBehavior.