CommandBehavior Wyliczenie

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.dll

Zawiera opis wyników zapytania i jego wpływu na bazę danych.

To wyliczenie obsługuje bitową kombinację jego wartości składowych.

public enum class CommandBehavior

[System.Flags]
public enum CommandBehavior

[<System.Flags>]
type CommandBehavior = 

Public Enum CommandBehavior

Dziedziczenie

Object

ValueType

Enum

CommandBehavior

Atrybuty

FlagsAttribute

Pola

Nazwa	Wartość	Opis
Default	0	Zapytanie może zwracać wiele zestawów wyników. Wykonanie zapytania może mieć wpływ na stan bazy danych. Defaultustawia brak CommandBehavior flag, więc wywołanie ExecuteReader(CommandBehavior.Default) jest funkcjonalnie równoważne wywołaniu .ExecuteReader()
SingleResult	1	Zapytanie zwraca pojedynczy zestaw wyników.
SchemaOnly	2	Zapytanie zwraca tylko informacje o kolumnie. W przypadku korzystania z SchemaOnly .NET Framework Dostawca danych dla SQL Server poprzedza wykonywanie instrukcji za pomocą polecenia SET FMTONLY ON.
KeyInfo	4	Zapytanie zwraca informacje o kolumnie i kluczu podstawowym. Dostawca dołącza dodatkowe kolumny do zestawu wyników dla istniejących kolumn klucza podstawowego i znacznika czasu.
SingleRow	8	Oczekuje się, że zapytanie zwróci pojedynczy wiersz pierwszego zestawu wyników. Wykonanie zapytania może mieć wpływ na stan bazy danych. Niektóre .NET dostawców danych mogą, ale nie są wymagane, użyj tych informacji, aby zoptymalizować wydajność polecenia. Po określeniu SingleRow za pomocą metody ExecuteReader() obiektu OleDbCommand Dostawca danych Framework dla OLE DB wykonuje powiązanie przy użyciu interfejsu IRow OLE DB .NET, jeśli jest dostępny. W przeciwnym razie używa interfejsu IRowset . Jeśli oczekuje się, że instrukcja SQL zwróci tylko jeden wiersz, określenie SingleRow może również zwiększyć wydajność aplikacji. Istnieje możliwość określenia SingleRow podczas wykonywania zapytań, które mają zwracać wiele zestawów wyników. W takim przypadku, gdy określono zarówno zapytanie SQL zestawu wielu wyników, jak i pojedynczy wiersz, zwrócony wynik będzie zawierać tylko pierwszy wiersz pierwszego zestawu wyników. Inne zestawy wyników zapytania nie zostaną zwrócone.
SequentialAccess	16	DataReader Umożliwia obsługę wierszy zawierających kolumny z dużymi wartościami binarnymi. Zamiast ładować cały wiersz, SequentialAccess umożliwia DataReader ładowanie danych jako strumienia. Następnie można użyć GetBytes metody lub GetChars , aby określić lokalizację bajtu, aby rozpocząć operację odczytu i ograniczony rozmiar buforu dla zwracanych danych.
CloseConnection	32	Po wykonaniu polecenia skojarzony Connection obiekt jest zamykany po zamknięciu skojarzonego DataReader obiektu.

Uwagi

Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz Dodatkowe uwagi dotyczące interfejsu API dla poleceniaBehavior.