Udostępnij za pośrednictwem


CommandBehavior Wyliczenie

Definicja

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
CommandBehavior
Atrybuty

Pola

CloseConnection 32

Po wykonaniu polecenia skojarzony Connection obiekt jest zamykany po zamknięciu skojarzonego DataReader obiektu.

Default 0

Zapytanie może zwrócić wiele zestawów wyników. Wykonanie zapytania może mieć wpływ na stan bazy danych. Default ustawia brak CommandBehavior flag, więc wywołanie ExecuteReader(CommandBehavior.Default) jest funkcjonalnie równoważne wywołaniu metody ExecuteReader().

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 sygnatury czasowej.

SchemaOnly 2

Zapytanie zwraca tylko informacje o kolumnie. W przypadku korzystania z programu SchemaOnly.NET Framework Dostawca danych dla SQL Server poprzedza wykonywanie instrukcji za pomocą polecenia SET FMTONLY ON.

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ę bajtów, aby rozpocząć operację odczytu i ograniczony rozmiar buforu dla zwracanych danych.

SingleResult 1

Zapytanie zwraca pojedynczy zestaw wyników.

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órzy dostawcy danych platformy .NET mogą, ale nie są zobowiązani do użycia tych informacji, aby zoptymalizować wydajność polecenia. Po określeniu SingleRowExecuteReader()OleDbCommand metody obiektu dostawca danych .NET Framework dla OLE DB wykonuje powiązanie przy użyciu interfejsu OLE DBIRow, 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. Pozostałe zestawy wyników zapytania nie zostaną zwrócone.

Uwagi

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

Dotyczy