OleDbCommand Sınıf

Tanım

Ad Alanı:

System.Data.OleDb

Bütünleştirilmiş Kod:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v11.0.0-preview.2.26159.112

Kaynak:

OleDbCommand.cs

Bir veri kaynağında yürütülecek SQL deyimini veya saklı yordamı temsil eder.

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable

Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable

Devralma

Object

DbCommand

OleDbCommand

Öznitelikler

RequiresDynamicCodeAttribute

Uygulamalar

IDbCommand ICloneable IDisposable

Örnekler

Aşağıdaki örnekte, Access veritabanından OleDbCommandsatır seçmek için , ve ile birlikte OleDbDataAdapterOleDbConnectionkullanılır. Ardından doldurulan DataSet döndürülür. Örnek, başlatılan DataSetbir , bağlantı dizesi, SQL SELECT deyimi olan bir sorgu dizesi ve kaynak veritabanı tablosunun adı olan bir dize geçirilir.

public void ReadMyData(string connectionString)
{
    string queryString = "SELECT OrderID, CustomerID FROM Orders";
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetString(1));
        }
        // always call Close when done reading.
        reader.Close();
    }
}

Public Sub ReadMyData(ByVal connectionString As String)
    Dim queryString As String = "SELECT OrderID, CustomerID FROM Orders"
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader.GetInt32(0).ToString() + ", " _
               + reader.GetString(1))
        End While

        ' always call Close when done reading.
        reader.Close()
    End Using
End Sub

Açıklamalar

Örneği OleDbCommand oluşturulduğunda, okuma/yazma özellikleri ilk değerlerine ayarlanır. Bu değerlerin listesi için oluşturucuya OleDbCommand bakın.

OleDbCommand bir veri kaynağında komutları yürüten aşağıdaki yöntemleri içerir:

Madde	Açıklama
ExecuteReader	Satır döndüren komutları yürütür. ExecuteReader SQL SET deyimleri gibi komutları yürütmek için kullanılırsa istediğiniz etkiye sahip olmayabilir.
ExecuteNonQuery	SQL INSERT, DELETE, UPDATE ve SET deyimleri gibi komutları yürütür.
ExecuteScalar	Bir veritabanından toplama değeri gibi tek bir değer alır.

Özelliğini sıfırlayabilir CommandText ve nesneyi yeniden kullanabilirsiniz OleDbCommand . Ancak, yeni veya önceki bir komutu yürütebilmeniz için önce öğesini kapatmanız OleDbDataReader gerekir.

bir yürütme OleDbCommandOleDbConnectionyöntemi tarafından önemli OleDbException bir (örneğin, 20 veya üzeri bir SQL Server önem düzeyi) oluşturulursa, bağlantı kapatılabilir. Ancak kullanıcı bağlantıyı yeniden açabilir ve devam edebilir.

Oluşturucular

Name	Description
OleDbCommand()	OleDbCommand sınıfının yeni bir örneğini başlatır.
OleDbCommand(String, OleDbConnection, OleDbTransaction)	sorgu metni OleDbCommand , bir ve ile sınıfının yeni bir OleDbConnectionörneğini Transactionbaşlatır.
OleDbCommand(String, OleDbConnection)	sorgu metni OleDbCommand ve ile sınıfının yeni bir OleDbConnectionörneğini başlatır.
OleDbCommand(String)	Sorgu metniyle sınıfının yeni bir örneğini OleDbCommand başlatır.

Özellikler

Name	Description
CommandText	Veri kaynağında yürütülecek SQL deyimini veya saklı yordamı alır veya ayarlar.
CommandTimeout	Komut yürütme girişimini sonlandırmadan ve hata oluşturmadan önce bekleme süresini (saniye cinsinden) alır veya ayarlar.
CommandType	Özelliğin nasıl CommandText yorumlandığını gösteren bir değer alır veya ayarlar.
Connection	öğesinin OleDbConnection bu örneği tarafından kullanılan öğesini OleDbCommandalır veya ayarlar.
DesignTimeVisible	Komut nesnesinin özelleştirilmiş bir Windows Forms Designer denetiminde görünür olup olmayacağını gösteren bir değer alır veya ayarlar.
Parameters	OleDbParameterCollection öğesini alır.
Transaction	öğesinin OleDbTransaction yürütüldiği öğesini OleDbCommand alır veya ayarlar.
UpdatedRowSource	komutu yöntemi OleDbDataAdaptertarafından kullanıldığında komut sonuçlarının DataRowUpdate öğesine nasıl uygulanacağını alır veya ayarlar.

Yöntemler

Name	Description
Cancel()	yürütmesini OleDbCommandiptal etmeye çalışır.
Clone()	Geçerli örneğin kopyası olan yeni OleDbCommand bir nesne oluşturur.
CreateParameter()	Nesnenin yeni bir OleDbParameter örneğini oluşturur.
ExecuteNonQuery()	üzerinde Connection bir SQL deyimi yürütür ve etkilenen satır sayısını döndürür.
ExecuteReader()	CommandText öğesine Connection gönderir ve oluştururOleDbDataReader.
ExecuteReader(CommandBehavior)	öğesine CommandTextConnectiongönderir ve değerlerden birini CommandBehavior kullanarak bir OleDbDataReader oluşturur.
ExecuteScalar()	Sorguyu yürütür ve sorgu tarafından döndürülen sonuç kümesindeki ilk satırın ilk sütununu döndürür. Ek sütunlar veya satırlar yoksayılır.
Prepare()	Veri kaynağında komutun hazırlanmış (veya derlenmiş) bir sürümünü oluşturur.
ResetCommandTimeout()	Özelliğini varsayılan değere sıfırlar CommandTimeout .

Belirtik Arabirim Kullanımları

Name	Description
ICloneable.Clone()	Bu üyenin açıklaması için bkz Clone(). .
IDbCommand.ExecuteReader()	Bu üyenin açıklaması için bkz ExecuteReader(). .
IDbCommand.ExecuteReader(CommandBehavior)	üzerinde komutunu CommandTextConnectionyürütür ve değerlerden birini CommandBehavior kullanarak bir IDataReader oluşturur.

Ayrıca bkz.

• OleDbDataAdapter
• OleDbConnection
• Komutlarla Çalışma