CommandBehavior Enum

Definisi

Ruang nama:
System.Data
Rakitan:
System.Data.Common.dll
Rakitan:
netstandard.dll, System.Data.Common.dll
Rakitan:
System.Data.dll
Rakitan:
netstandard.dll
Sumber:
CommandBehavior.cs
Sumber:
CommandBehavior.cs
Sumber:
DataColumn.cs

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
Object
ValueType
Enum
CommandBehavior
Atribut
FlagsAttribute

Bidang

Nama Nilai Deskripsi
Default 0

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

Kueri mengembalikan satu tataan hasil.
SchemaOnly 2

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

Kueri mengembalikan informasi kolom dan kunci utama. Penyedia menambahkan kolom tambahan ke hasil yang ditetapkan untuk kunci primer dan kolom tanda waktu yang ada.
SingleRow 8

Kueri diharapkan mengembalikan satu baris dari tataan hasil pertama. Eksekusi kueri dapat memengaruhi status database. Beberapa penyedia data .NET dapat, tetapi tidak diperlukan, gunakan informasi ini untuk mengoptimalkan performa perintah. Saat Anda menentukan SingleRow dengan metode ExecuteReader() objek OleDbCommand, .NET Framework Data Provider 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.
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.
CloseConnection 32

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

Keterangan

Nilai CommandBehavior digunakan oleh ExecuteReader metode IDbCommand dan kelas penerapan apa pun.

Kombinasi bitwise dari nilai-nilai ini dapat digunakan.

CommandBehavior diabaikan ketika digunakan untuk menentukan SqlNotificationRequest atau SqlDependency dan karena itu tidak boleh digunakan. Gunakan konstruktor yang tidak memerlukan CommandBehavior parameter dalam dua kasus ini.

Catatan tentang anggota enumerasi individu

Saat menggunakan KeyInfo, Penyedia Data .NET Framework untuk SQL Server mendahului pernyataan yang dijalankan dengan SET FMTONLY OFF dan SET NO_BROWSETABLE ON. Pengguna harus menyadari potensi efek samping, seperti gangguan dalam penggunaan SET FMTONLY ON pernyataan. Untuk informasi selengkapnya, lihat SET FMTONLY (Transact-SQL).

Note

Gunakan SequentialAccess untuk mengambil nilai besar dan data biner. Jika tidak, OutOfMemoryException mungkin terjadi dan koneksi akan ditutup.

Saat Anda menentukan SequentialAccess, Anda diharuskan membaca dari kolom dalam urutan yang dikembalikan, meskipun Anda tidak diharuskan membaca setiap kolom. Setelah Anda membaca melewati suatu lokasi dalam aliran data yang dikembalikan, data di lokasi tersebut atau sebelum itu tidak dapat lagi dibaca dari DataReader. Saat menggunakan OleDbDataReader, Anda dapat membaca ulang nilai kolom saat ini sampai melewati pembacaannya. Saat menggunakan SqlDataReader, Anda hanya dapat membaca nilai kolom sekali.

Berlaku untuk