OdbcConnection Sınıf

Tanım

Ad Alanı:

System.Data.Odbc

Bütünleştirilmiş Kod:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v8.0.0

Bir veri kaynağına açık bağlantıyı temsil eder.

public ref class OdbcConnection sealed : System::Data::Common::DbConnection, ICloneable

public sealed class OdbcConnection : System.Data.Common.DbConnection, ICloneable

type OdbcConnection = class
    inherit DbConnection
    interface ICloneable

Public NotInheritable Class OdbcConnection
Inherits DbConnection
Implements ICloneable

Devralma

Object

DbConnection

OdbcConnection

Uygulamalar

ICloneable

Örnekler

Aşağıdaki örnek bir OdbcCommand ve OdbcConnectionoluşturur. OdbcConnection özelliği olarak Connection açılır ve ayarlanır. Örnek daha sonra öğesini çağırır ExecuteNonQueryve bağlantıyı kapatır. Bunu başarmak için, ExecuteNonQuery bir bağlantı dizesi ve SQL INSERT deyimi olan bir sorgu dizesi geçirilir.

static private void InsertRow(string connectionString)
{
    string queryString =
        "INSERT INTO Customers (CustomerID, CompanyName) Values('NWIND', 'Northwind Traders')";
    OdbcCommand command = new OdbcCommand(queryString);

    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        command.Connection = connection;
        connection.Open();
        command.ExecuteNonQuery();

        // The connection is automatically closed at
        // the end of the Using block.
    }
}

Private Sub InsertRow(ByVal connectionString As String)

    Dim queryString As String = _
        "INSERT INTO Customers (CustomerID, CompanyName) Values('NWIND', 'Northwind Traders')"
    Dim command As New OdbcCommand(queryString)

    Using connection As New OdbcConnection(connectionString)
        command.Connection = connection
        connection.Open()
        command.ExecuteNonQuery()

        ' The connection is automatically closed at 
        ' the end of the Using block.
    End Using
End Sub

Açıklamalar

Nesne, OdbcConnection bağlantı dizesi veya ODBC veri kaynağı adı (DSN) kullanılarak oluşturulan veri kaynağına yönelik benzersiz bir bağlantıyı temsil eder. İstemci/sunucu veritabanı sistemi ile sunucuya yapılan ağ bağlantısına eşdeğerdir. Yerel ODBC sürücüsü tarafından desteklenen işlevlere bağlı olarak, bir OdbcConnection nesnenin bazı yöntemleri veya özellikleri kullanılamayabilir.

OdbcConnection nesnesi ODBC ortamı ve bağlantı tanıtıcıları gibi yerel kaynakları kullanır. Nesne kapsam dışına çıkmadan önce OdbcConnection veya bağlantıyı bir Using deyime yerleştirerek veya ÇağırarakClose açık nesneleri her zaman açıkça kapatmalısınızOdbcConnection. Bunu yapmamak, bu yerel kaynakların çöp toplamaya serbest bırakılmamasıdır. Onları hemen serbest bırakabilir. Bu da sonunda temel alınan sürücünün kaynaklarının yetersiz olmasına veya üst sınıra ulaşmasına neden olabilir. Bu, aralıklı hatalara neden oldu. Örneğin, birçok bağlantı çöp toplayıcı tarafından silinmeyi beklerken ilgili hatalarla karşılaşabilirsiniz Maximum Connections . Bağlantıları açıkça kapatmak, yerel kaynakların daha verimli bir şekilde kullanılmasını, ölçeklenebilirliği artırmayı ve genel uygulama performansını iyileştirmeyi sağlar.

Not

Yüksek performanslı uygulamaları dağıtmak için sık sık bağlantı havuzu kullanmanız gerekir. Ancak ODBC için .NET Framework Veri Sağlayıcısı'nı kullandığınızda, sağlayıcı bunu otomatik olarak yönettiğinden bağlantı havuzunu etkinleştirmeniz gerekmez.

Sınıfın Execute yöntemlerinden OdbcCommand biri önemli OdbcException (örneğin, SQL Server önem derecesi 20 veya daha yüksek) neden olursa, OdbcConnection kapanabilir. Ancak kullanıcı bağlantıyı yeniden açabilir ve devam edebilir.

Nesnesinin bir örneğini OdbcConnection oluşturan bir uygulama, bildirim temelli veya kesinlik temelli güvenlik taleplerini ayarlayarak tüm doğrudan ve dolaylı çağıranların kodda yeterli izne sahip olmasını gerektirebilir. OdbcConnection nesnesini kullanarak OdbcPermission güvenlik talepleri oluşturur. Kullanıcılar, nesnesini kullanarak OdbcPermissionAttribute kodlarının yeterli izinlere sahip olduğunu doğrulayabilir. Kullanıcılar ve yöneticiler, bilgisayar, kullanıcı ve kuruluş düzeylerindeki güvenlik ilkesini değiştirmek için Kod Erişimi Güvenlik İlkesi Aracı'nı (Caspol.exe) da kullanabilir. Daha fazla bilgi için bkz. Kod Erişim Güvenliği ve ADO.NET.

Veri kaynağından gelen uyarı ve bilgilendirme iletilerini işleme hakkında daha fazla bilgi için bkz . Bağlantı Olayları.

Oluşturucular

OdbcConnection()	OdbcConnection sınıfının yeni bir örneğini başlatır.
OdbcConnection(String)	Belirtilen bağlantı dizesiyle sınıfının yeni bir örneğini OdbcConnection başlatır.

Özellikler

CanCreateBatch	Bu DbConnection örneğin sınıfı destekleyip desteklemediğini DbBatch gösteren bir değer alır. (Devralındığı yer: DbConnection)
ConnectionString	Veri kaynağını açmak için kullanılan dizeyi alır veya ayarlar.
ConnectionTimeout	Denemeyi sonlandırmadan ve hata oluşturmadan önce bağlantı kurmaya çalışırken bekleme süresini (saniye cinsinden) alır veya ayarlar.
Database	Bağlantı açıldıktan sonra kullanılacak geçerli veritabanının veya veritabanının adını alır.
DataSource	Veri kaynağının sunucu adını veya dosya adını alır.
DbProviderFactory	Bunun DbConnectioniçin öğesini DbProviderFactory alır. (Devralındığı yer: DbConnection)
Driver	Geçerli bağlantı için belirtilen ODBC sürücüsünün adını alır.
ServerVersion	İstemcinin bağlı olduğu sunucunun sürümünü içeren bir dize alır.
State	Bağlantının geçerli durumunu alır.

Yöntemler

BeginDbTransaction(IsolationLevel)	Türetilmiş bir sınıfta geçersiz kılındığında bir veritabanı işlemi başlatır. (Devralındığı yer: DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Zaman uyumsuz olarak bir veritabanı işlemi başlatır. (Devralındığı yer: DbConnection)
BeginTransaction()	Veri kaynağında bir işlem başlatır.
BeginTransaction(IsolationLevel)	Veri kaynağında belirtilen IsolationLevel değerle bir işlem başlatır.
BeginTransactionAsync(CancellationToken)	Zaman uyumsuz olarak bir veritabanı işlemi başlatır. (Devralındığı yer: DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Zaman uyumsuz olarak bir veritabanı işlemi başlatır. (Devralındığı yer: DbConnection)
ChangeDatabase(String)	Açık OdbcConnectionbir ile ilişkili geçerli veritabanını değiştirir.
ChangeDatabaseAsync(String, CancellationToken)	Açık bağlantı için geçerli veritabanını zaman uyumsuz olarak değiştirir. (Devralındığı yer: DbConnection)
Close()	Veri kaynağı bağlantısını kapatır.
CloseAsync()	Veritabanı bağlantısını zaman uyumsuz olarak kapatır. (Devralındığı yer: DbConnection)
CreateBatch()	sağlayıcı sınıfının sınıfını uygulayan yeni bir örneğini DbBatch döndürür. (Devralındığı yer: DbConnection)
CreateCommand()	ile OdbcConnectionilişkilendirilmiş bir OdbcCommand nesne oluşturur ve döndürür.
CreateDbBatch()	Türetilmiş bir sınıfta geçersiz kılındığında, sağlayıcı sınıfının sınıfını uygulayan yeni bir örneğini DbBatch döndürür. (Devralındığı yer: DbConnection)
CreateDbCommand()	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli bağlantıyla ilişkili bir DbCommand nesne oluşturur ve döndürür. (Devralındığı yer: DbConnection)
Dispose()	Uygulama tarafından tanımlanan, yönetilmeyen kaynakları serbest bırakma, salma veya sıfırlama ile ilişkili görevleri gerçekleştirir. (Devralındığı yer: DbConnection)
Dispose(Boolean)	DbConnection tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır. (Devralındığı yer: DbConnection)
DisposeAsync()	Zaman uyumsuz olarak bağlantı nesnesini batırıyor. (Devralındığı yer: DbConnection)
EnlistTransaction(Transaction)	Belirtilen işlemdeki listeler. (Devralındığı yer: DbConnection)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetSchema()	Bu OdbcConnectionöğesinin veri kaynağı için şema bilgilerini döndürür.
GetSchema(String)	Bunun veri kaynağı OdbcConnection için şema bilgilerini, şema adı için belirtilen adı kullanarak döndürür.
GetSchema(String, String[])	Bunun veri kaynağı OdbcConnection için şema bilgilerini, şema adı için belirtilen dizeyi ve kısıtlama değerleri için belirtilen dize dizisini kullanarak döndürür.
GetSchemaAsync(CancellationToken)	Bu, zaman uyumsuz bir sürümüdür GetSchema(). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır. cancellationToken isteğe bağlı olarak kabul edilebilir. Varsayılan uygulama zaman uyumlu GetSchema() çağrıyı çağırır ve tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir görev geçirildiyse iptal edilmiş cancellationTokenbir görev döndürür. tarafından GetSchema() oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir. (Devralındığı yer: DbConnection)
GetSchemaAsync(String, CancellationToken)	Bu, zaman uyumsuz sürümüdür GetSchema(String). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır. cancellationToken isteğe bağlı olarak kabul edilebilir. Varsayılan uygulama zaman uyumlu GetSchema(String) çağrıyı çağırır ve tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir görev geçirildiyse iptal edilmiş cancellationTokenbir görev döndürür. tarafından GetSchema(String) oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir. (Devralındığı yer: DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Bu, zaman uyumsuz sürümüdür GetSchema(String, String[]). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır. cancellationToken isteğe bağlı olarak kabul edilebilir. Varsayılan uygulama zaman uyumlu GetSchema(String, String[]) çağrıyı çağırır ve tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir görev geçirildiyse iptal edilmiş cancellationTokenbir görev döndürür. tarafından GetSchema(String, String[]) oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir. (Devralındığı yer: DbConnection)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
OnStateChange(StateChangeEventArgs)	Olayı tetikler StateChange . (Devralındığı yer: DbConnection)
Open()	tarafından ConnectionStringbelirtilen özellik ayarlarıyla bir veri kaynağına bağlantı açar.
OpenAsync()	tarafından belirtilen ConnectionStringayarlarla bir veritabanı bağlantısı açan zaman uyumsuz sürümüOpen(). Bu yöntem CancellationToken.None ile sanal yöntemi OpenAsync(CancellationToken) çağırır. (Devralındığı yer: DbConnection)
OpenAsync(CancellationToken)	Bu, zaman uyumsuz sürümüdür Open(). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır. İptal belirteci isteğe bağlı olarak kabul edilebilir. Varsayılan uygulama zaman uyumlu Open() çağrıyı çağırır ve tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir cancellationToken geçirilirse iptal edilmiş bir görev döndürür. Open tarafından oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir. Döndürülen Görev tamamlanana kadar nesnenin DbConnection diğer yöntemlerini ve özelliklerini çağırmayın. (Devralındığı yer: DbConnection)
ReleaseObjectPool()	Odbc Sürücü Yöneticisi ortam tanıtıcısının, temel alınan son bağlantı serbest bırakıldığında serbest bırakılabildiğini gösterir.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ekinlikler

InfoMessage	ODBC sürücüsü bir uyarı veya bilgilendirme iletisi gönderdiğinde gerçekleşir.
StateChange	Bağlantının durumu değiştiğinde gerçekleşir. (Devralındığı yer: DbConnection)

Belirtik Arabirim Kullanımları

ICloneable.Clone()

Bu üyenin açıklaması için bkz Clone(). .

Ayrıca bkz.

• Veri Kaynaklarına Bağlanma