OdbcCommandBuilder Sınıf

Tanım

Ad Alanı:

System.Data.Odbc

Bütünleştirilmiş Kod:

System.Data.Odbc.dll

Paket:

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

Kaynak:

OdbcCommandBuilder.cs

ile ilişkili veri kaynağında yapılan değişiklikleri mutabık hale getirmek için DataSet kullanılan tek tablolu komutları otomatik olarak oluşturur. Bu sınıf devralınamaz.

public ref class OdbcCommandBuilder sealed : System::Data::Common::DbCommandBuilder

public sealed class OdbcCommandBuilder : System.Data.Common.DbCommandBuilder

type OdbcCommandBuilder = class
    inherit DbCommandBuilder

Public NotInheritable Class OdbcCommandBuilder
Inherits DbCommandBuilder

Devralma

Object

MarshalByRefObject

Component

DbCommandBuilder

OdbcCommandBuilder

Örnekler

Aşağıdaki örnekte, veri kaynağından satır seçmek için ve OdbcConnectionile OdbcDataAdapter birlikte kullanılırOdbcCommand. Örnek, başlatılan DataSetbir , bağlantı dizesi, SQL SELECT deyimi olan bir sorgu dizesi ve veri kaynağı tablosunun adı olan bir dize geçirilir. Örnek daha sonra bir OdbcCommandBuilderoluşturur.

public static DataSet SelectOdbcSrvRows(string connectionString,
    string queryString, string tableName)
{
    DataSet dataSet = new DataSet();
    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        OdbcDataAdapter adapter = new OdbcDataAdapter();
        adapter.SelectCommand =
            new OdbcCommand(queryString, connection);
        OdbcCommandBuilder builder =
            new OdbcCommandBuilder(adapter);

        connection.Open();

        adapter.Fill(dataSet, tableName);

        //code to modify data in DataSet here

        //Without the OdbcCommandBuilder this line would fail
        adapter.Update(dataSet, tableName);
    }
    return dataSet;
}

Public Function SelectOdbcSrvRows( _
    ByVal connectionString As String, ByVal queryString As String, _
    ByVal tableName As String) As DataSet

    Dim dataSet As New DataSet()

    Using connection As New OdbcConnection(connectionString)
        Dim adapter As New OdbcDataAdapter()
        adapter.SelectCommand = _
            New OdbcCommand(queryString, connection)
        Dim builder As New OdbcCommandBuilder(adapter)

        connection.Open()

        adapter.Fill(dataSet, tableName)

        ' Code to modify data in DataSet here 

        ' Without the OdbcCommandBuilder this line would fail.
        adapter.Update(dataSet, tableName)
    End Using

    Return dataSet
End Function

Açıklamalar

, OdbcDataAdapter veri kaynağıyla ilişkilendirilmiş bir DataSet kaynakta yapılan değişiklikleri mutabık hale getirmek için gereken SQL deyimlerini otomatik olarak oluşturmaz. Ancak, özelliğini OdbcDataAdapterayarlayarak SelectCommand tek tablolu güncelleştirmeler için SQL deyimleri oluşturan bir OdbcCommandBuilder nesne oluşturabilirsiniz. ardından OdbcCommandBuilder , ayarlamadığınız tüm ek SQL deyimlerini oluşturur.

ve buna karşılık gelen OdbcCommandBuilder ilişki OdbcDataAdapter her zaman bire bir olur. Bu yazışmayı oluşturmak için nesnesinin OdbcDataAdapterOdbcCommandBuilder özelliğini ayarlarsınız. Bu, öğesinin OdbcCommandBuilder kendisini etkileyen olayların çıkışını RowUpdating üreten bir dinleyici olarak kaydetmesine DataSetneden olur.

INSERT, UPDATE veya DELETE deyimleri oluşturmak için, OdbcCommandBuilder gerekli meta veri kümesini almak için özelliğini kullanır SelectCommand . Meta veriler alındıktan sonra değerini SelectCommand değiştirirseniz (örneğin, ilk güncelleştirmeden sonra) meta verileri güncelleştirmek için yöntemini çağırmalısınız RefreshSchema .

Uyarı

özelliğine SelectCommand atanan SELECT deyimi diğer adlar kullanıyorsa, sonuçta elde edilen INSERT, UPDATE ve DELETE deyimleri yanlış veya başarısız olabilir. Temel alınan ODBC sürücüsü diğer ad sütun adı için uygun temel sütun adını sağlayamıyorsa (SQL_DESC_BASE_COLUMN_NAME değeri SQLColAttributekullanılarak), diğer ad oluşturulan INSERT, UPDATE ve DELETE deyimlerinde kullanılabilir. Örneğin, Oracle için Microsoft ODBC Sürücüsü temel sütun adı olarak diğer adı döndürür. Bu nedenle, oluşturulan INSERT, UPDATE ve DELETE deyimleri hatalara neden olabilir.

, OdbcCommandBuilder tarafından başvuruda bulunan SelectCommandConnection, CommandTimeoutve Transaction özelliklerini de kullanır. Kullanıcı, bu özelliklerden biri veya daha fazlası değiştirilirse veya özelliğin SelectCommand değeri değiştirilirse çağırmalıdırRefreshSchema. InsertCommandAksi takdirde , UpdateCommandve DeleteCommand özellikleri önceki değerlerini korur.

çağrısı Disposeyaparsanız , OdbcCommandBuilder ile ilişkilendirilmez OdbcDataAdapterve oluşturulan komutlar artık kullanılmaz.

Oluşturucular

Name	Description
OdbcCommandBuilder()	OdbcCommandBuilder sınıfının yeni bir örneğini başlatır.
OdbcCommandBuilder(OdbcDataAdapter)	sınıfın OdbcCommandBuilder yeni bir örneğini ilişkili OdbcDataAdapter nesneyle başlatır.

Özellikler

Name	Description
DataAdapter	Bu OdbcCommandBuilder nesnenin SQL deyimleri oluşturacağı nesneyi OdbcDataAdapter alır veya ayarlar.

Yöntemler

Name	Description
DeriveParameters(OdbcCommand)	içinde OdbcCommand belirtilen saklı yordamdan parametre bilgilerini alır ve belirtilen OdbcCommand nesnenin koleksiyonunu doldururParameters.
GetDeleteCommand()	Veri kaynağında silme işlemleri gerçekleştirmek için gereken otomatik olarak oluşturulan OdbcCommand nesneyi alır.
GetDeleteCommand(Boolean)	Veri kaynağında silme işlemleri gerçekleştirmek için gereken otomatik olarak oluşturulan OdbcCommand nesneyi alır.
GetInsertCommand()	Veri kaynağında eklemeleri gerçekleştirmek için gereken otomatik olarak oluşturulan OdbcCommand nesneyi alır.
GetInsertCommand(Boolean)	Veri kaynağında eklemeleri gerçekleştirmek için gereken otomatik olarak oluşturulan OdbcCommand nesneyi alır.
GetUpdateCommand()	Veri kaynağında güncelleştirmeleri gerçekleştirmek için gereken otomatik olarak oluşturulan OdbcCommand nesneyi alır.
GetUpdateCommand(Boolean)	Veri kaynağında güncelleştirmeleri gerçekleştirmek için gereken otomatik olarak oluşturulan OdbcCommand nesneyi alır.
QuoteIdentifier(String, OdbcConnection)	Doğru katalog örneğinde tırnak içine alınmamış bir tanımlayıcı verildiğinde, bu tanımlayıcının doğru tırnak içine alınmış biçimini döndürür. Bu, tanımlayıcıdaki ekli tırnakların doğru şekilde kaçmasını içerir.
QuoteIdentifier(String)	Doğru katalog örneğinde tırnak içine alınmamış bir tanımlayıcı verildiğinde, bu tanımlayıcının doğru tırnak içine alınmış biçimini döndürür. Bu, tanımlayıcıdaki ekli tırnakların doğru şekilde kaçmasını içerir.
UnquoteIdentifier(String, OdbcConnection)	Tırnak içine alınmış bir tanımlayıcı verildiğinde, tanımlayıcıdaki katıştırılmış tırnakların doğru şekilde özetini kaldırma da dahil olmak üzere bu tanımlayıcının doğru ve tırnak içine alınmamış biçimini döndürür.
UnquoteIdentifier(String)	Tırnak içine alınmış bir tanımlayıcı verildiğinde, tanımlayıcıdaki katıştırılmış tırnakların doğru şekilde özetini kaldırma da dahil olmak üzere bu tanımlayıcının doğru ve tırnak içine alınmamış biçimini döndürür.

Ayrıca bkz.

• CommandBuilders ile Komut Oluşturma