CommandBehavior Enum

Definisi

Menyediakan deskripsi hasil kueri dan efeknya pada database.

Enumerasi ini mendukung kombinasi bitwise dari nilai yang termasuk di dalamnya.

public enum class CommandBehavior
[System.Flags]
public enum CommandBehavior
[<System.Flags>]
type CommandBehavior = 
Public Enum CommandBehavior
Warisan
CommandBehavior
Atribut

Bidang

CloseConnection 32

Ketika perintah dijalankan, objek terkait Connection ditutup ketika objek terkait DataReader ditutup.

Default 0

Kueri dapat mengembalikan beberapa tataan hasil. Eksekusi kueri dapat memengaruhi status database. DefaultCommandBehavior tidak mengatur bendera, sehingga panggilan ExecuteReader(CommandBehavior.Default) secara fungsional setara dengan panggilan ExecuteReader().

KeyInfo 4

Kueri mengembalikan informasi kolom dan kunci primer. Penyedia menambahkan kolom tambahan ke kumpulan hasil untuk kunci primer dan kolom tanda waktu yang ada.

SchemaOnly 2

Kueri hanya mengembalikan informasi kolom. Saat menggunakan SchemaOnly, Penyedia Data .NET Framework untuk SQL Server mendahului pernyataan yang dijalankan dengan SET FMTONLY ON.

SequentialAccess 16

Menyediakan cara untuk DataReader menangani baris yang berisi kolom dengan nilai biner besar. Daripada memuat seluruh baris, SequentialAccess memungkinkan DataReader untuk memuat data sebagai aliran. Anda kemudian dapat menggunakan GetBytes metode atau GetChars untuk menentukan lokasi byte untuk memulai operasi baca, dan ukuran buffer terbatas untuk data yang dikembalikan.

SingleResult 1

Kueri mengembalikan satu tataan hasil.

SingleRow 8

Kueri diharapkan mengembalikan satu baris dari tataan hasil pertama. Eksekusi kueri dapat memengaruhi status database. Beberapa penyedia data .NET mungkin, tetapi tidak diperlukan untuk, menggunakan informasi ini untuk mengoptimalkan performa perintah. Saat Anda menentukan SingleRow dengan ExecuteReader() metode OleDbCommand objek , Penyedia Data .NET Framework untuk OLE DB melakukan pengikatan menggunakan antarmuka OLE DB IRow jika tersedia. Jika tidak, ia menggunakan IRowset antarmuka . Jika pernyataan SQL Anda diharapkan hanya mengembalikan satu baris, menentukan SingleRow juga dapat meningkatkan performa aplikasi. Dimungkinkan untuk menentukan SingleRow kapan menjalankan kueri yang diharapkan mengembalikan beberapa tataan hasil. Dalam hal ini, di mana kueri SQL set multi-hasil dan baris tunggal ditentukan, hasil yang dikembalikan hanya akan berisi baris pertama dari tataan hasil pertama. Kumpulan hasil kueri lainnya tidak akan dikembalikan.

Keterangan

Untuk informasi selengkapnya tentang API ini, lihat Keterangan API Tambahan untuk CommandBehavior.

Berlaku untuk