CommandBehavior Sabit listesi

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Data.Common.dll

Kaynak:

CommandBehavior.cs

Sorgunun sonuçlarının ve bunun veritabanı üzerindeki etkisinin açıklamasını sağlar.

Bu sabit listesi, üyeleri için bit düzeyinde karşılaştırmayı destekler.

public enum class CommandBehavior

[System.Flags]
public enum CommandBehavior

[<System.Flags>]
type CommandBehavior = 

Public Enum CommandBehavior

Devralma

Object

ValueType

Enum

CommandBehavior

Öznitelikler

FlagsAttribute

Alanlar

Name	Değer	Description
Default	0	Sorgu birden çok sonuç kümesi döndürebilir. Sorgunun yürütülmesi veritabanı durumunu etkileyebilir. Default hiçbir bayrak ayarlr CommandBehavior , bu nedenle çağırma ExecuteReader(CommandBehavior.Default) işlevi çağrısıyla ExecuteReader()eşdeğerdir.
SingleResult	1	Sorgu tek bir sonuç kümesi döndürür.
SchemaOnly	2	Sorgu yalnızca sütun bilgilerini döndürür. SchemaOnly kullanırken, SQL Server için .NET Framework Veri Sağlayıcısı, SET FMTONLY ON ile yürütülen deyimin önünde yer alır.
KeyInfo	4	Sorgu sütun ve birincil anahtar bilgilerini döndürür. Sağlayıcı, mevcut birincil anahtar ve zaman damgası sütunları için sonuç kümesine ek sütunlar ekler.
SingleRow	8	Sorgunun ilk sonuç kümesinin tek bir satırını döndürmesi beklenir. Sorgunun yürütülmesi veritabanı durumunu etkileyebilir. Bazı .NET veri sağlayıcıları, komutun performansını iyileştirmek için bu bilgileri kullanabilir ancak bunu yapmak zorunda değildir. SingleRow nesnesinin ExecuteReader() yöntemiyle OleDbCommand belirttiğinizde, OLE DB için .NET Framework Veri Sağlayıcısı varsa OLE DB IRow arabirimini kullanarak bağlama gerçekleştirir. Aksi takdirde arabirimini IRowset kullanır. SQL deyiminizin yalnızca tek bir satır döndürmesi bekleniyorsa, belirterek SingleRow uygulama performansını da geliştirebilirsiniz. Birden çok sonuç kümesi döndürmesi beklenen sorguları yürütürken belirtmek SingleRow mümkündür. Bu durumda, hem çok sonuçlu küme SQL sorgusu hem de tek satır belirtildiğinde, döndürülen sonuç yalnızca ilk sonuç kümesinin ilk satırını içerir. Sorgunun diğer sonuç kümeleri döndürülmeyecek.
SequentialAccess	16	büyük ikili değerlere sahip sütunlar içeren satırları işlemek için DataReader bir yol sağlar. Satırın tamamını yüklemek yerine, SequentialAccess verinin akış olarak yüklenmesini sağlar DataReader . Daha sonra veya GetBytes yöntemini kullanarak GetChars okuma işlemini başlatmak için bir bayt konumu ve döndürülen veriler için sınırlı bir arabellek boyutu belirtebilirsiniz.
CloseConnection	32	Komut yürütürken, ilişkili nesne kapatıldığında ilişkili ConnectionDataReader nesne kapatılır.

Açıklamalar

CommandBehavior değerleri, ExecuteReader yöntemi tarafından IDbCommand ve uygulayan herhangi bir sınıf kullanılır.

Bu değerlerin bit düzeyinde bir bileşimi kullanılabilir.

Bir CommandBehavior veya SqlNotificationRequest tanımlamak için kullanıldığında SqlDependency yoksayılır ve bu nedenle kullanılmamalıdır. Bu iki durumda parametre gerektirmeyen CommandBehavior oluşturucuyu kullanın.

Tek tek numaralandırma elemanlarıyla ilgili notlar

Kullanıldığında KeyInfo, SQL Server için .NET Framework Veri Sağlayıcısı, SET FMTONLY OFF ve SET NO_BROWSETABLE ON ile yürütülen ifadeden önce gelir. Kullanıcılar, SET FMTONLY ON bildirilerinin kullanımına etki gibi olası yan etkilerin farkında olmalıdır. Daha fazla bilgi için bkz . SET FMTONLY (Transact-SQL).

Note

Büyük değerleri ve ikili verileri almak için kullanın SequentialAccess . Aksi takdirde, bir OutOfMemoryException oluşabilir ve bağlantı kapatılır.

SequentialAccess belirttiğinizde, her sütunu okumanız gerekmez, ancak sütunları döndürülme sırasına göre okumanız gerekir. Döndürülen veri akışındaki bir konumun geçmişini okuduktan sonra, bu konumdaki veya bu konumdan önceki veriler artık konumundan DataReaderokunamıyor. "OleDbDataReader kullanılırken, geçerli sütun değeri aşılana kadar aynı değeri yeniden okuyabilirsiniz." kullanırken SqlDataReader, sütun değerini yalnızca bir kez okuyabilirsiniz.