OdbcConnection Sınıf

Tanım

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

public ref class OdbcConnection sealed : System::Data::Common::DbConnection, ICloneable
public ref class OdbcConnection sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection
public sealed class OdbcConnection : System.Data.Common.DbConnection, ICloneable
public sealed class OdbcConnection : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbConnection
type OdbcConnection = class
    inherit DbConnection
    interface ICloneable
type OdbcConnection = class
    inherit Component
    interface ICloneable
    interface IDbConnection
    interface IDisposable
Public NotInheritable Class OdbcConnection
Inherits DbConnection
Implements ICloneable
Public NotInheritable Class OdbcConnection
Inherits Component
Implements ICloneable, IDbConnection, IDisposable
Devralma
Devralma
Uygulamalar

Örnekler

Aşağıdaki örnek bir OdbcCommand ve bir OdbcConnectionoluşturur. OdbcConnection açılır ve Connection özelliği olarak ayarlanır. Örnek daha sonra ExecuteNonQueryçağırır ve 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

OdbcConnection nesnesi, 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şlevselliğe bağlı olarak, OdbcConnection nesnesinin bazı yöntemleri veya özellikleri kullanılamayabilir.

OdbcConnection nesnesi ODBC ortamı ve bağlantı tanıtıcıları gibi yerel kaynakları kullanır. OdbcConnection nesnesi kapsam dışına çıkmadan önce Close veya Dispose çağırarak veya bağlantıyı bir Using deyimine yerleştirerek açık OdbcConnection nesneleri her zaman açıkça kapatmalısınız. Bunun yapılmaması, bu yerel kaynakların atık toplamaya serbest bırakılmamasıdır. Onları hemen serbest bir şekilde kurtaramayabilir. Bu da sonunda temel sürücünün kaynak 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 Maximum Connections -related hatalarıyla karşılaşabilirsiniz. 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.

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

OdbcConnection nesnesinin bir örneğini 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, OdbcPermission nesnesini kullanarak güvenlik talepleri oluşturur. Kullanıcılar, OdbcPermissionAttribute nesnesini kullanarak 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şim Güvenlik İlkesi Aracı'nı (Caspol.exe) de 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 OdbcConnection sınıfının yeni bir örneğini başlatır.

Özellikler

CanCreateBatch

Bu DbConnection örneğinin DbBatch sınıfını destekleyip desteklemediğini gösteren bir değer alır.

(Devralındığı yer: DbConnection)
CanRaiseEvents

Bileşenin olay oluşturup oluşturamayacağını belirten bir değer alır.

(Devralındığı yer: Component)
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.

Container

Componentiçeren IContainer alır.

(Devralındığı yer: Component)
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

Bu DbConnectioniçin DbProviderFactory alır.

(Devralındığı yer: DbConnection)
DesignMode

Component şu anda tasarım modunda olup olmadığını gösteren bir değer alır.

(Devralındığı yer: Component)
Driver

Geçerli bağlantı için belirtilen ODBC sürücüsünün adını alır.

Events

Bu Componenteklenen olay işleyicilerinin listesini alır.

(Devralındığı yer: Component)
ServerVersion

İstemcinin bağlı olduğu sunucunun sürümünü içeren bir dize alır.

Site

Component ISite alır veya ayarlar.

(Devralındığı yer: Component)
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)

Belirtilen IsolationLevel değeriyle veri kaynağında 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 bir OdbcConnectionile 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()

Zaman uyumsuz olarak veritabanı bağlantısını kapatır.

(Devralındığı yer: DbConnection)
CreateBatch()

sağlayıcı sınıfının DbBatch sınıfını uygulayan yeni bir örneğini döndürür.

(Devralındığı yer: DbConnection)
CreateCommand()

OdbcConnectionile ilişkilendirilmiş bir OdbcCommand nesnesi 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 DbBatch sınıfını uygulayan yeni bir örneğini 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 nesnesi oluşturur ve döndürür.

(Devralındığı yer: DbConnection)
CreateObjRef(Type)

Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur.

(Devralındığı yer: MarshalByRefObject)
Dispose()

Yönetilmeyen kaynakları serbest bırakma, serbest bırakma veya sıfırlama ile ilişkili uygulama tanımlı görevleri gerçekleştirir.

(Devralındığı yer: DbConnection)
Dispose()

Componenttarafından kullanılan tüm kaynakları serbest bırakır.

(Devralındığı yer: Component)
Dispose(Boolean)

DbConnection tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.

(Devralındığı yer: DbConnection)
Dispose(Boolean)

Component tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.

(Devralındığı yer: Component)
DisposeAsync()

Zaman uyumsuz olarak bağlantı nesnesine daldırıyor.

(Devralındığı yer: DbConnection)
EnlistDistributedTransaction(ITransaction)

Belirtilen işlemde dağıtılmış işlem olarak listeler.

EnlistTransaction(Transaction)

Belirtilen işlemde dağıtılmış işlem olarak listeler.

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)
GetLifetimeService()
Geçersiz.

Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır.

(Devralındığı yer: MarshalByRefObject)
GetSchema()

Bu OdbcConnectionveri kaynağı için şema bilgilerini döndürür.

GetSchema(String)

Şema adı için belirtilen adı kullanarak bu OdbcConnection veri kaynağı için şema bilgilerini döndürür.

GetSchema(String, String[])

Bu OdbcConnection veri kaynağı 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, GetSchema()'nin zaman uyumsuz bir sürümüdür. 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ısını çağırır ve tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir cancellationTokengeçirilirse iptal edilmiş bir görev döndürür. GetSchema() tarafından 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, GetSchema(String)zaman uyumsuz sürümüdür. 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ısını çağırır ve tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir cancellationTokengeçirilirse iptal edilmiş bir görev döndürür. GetSchema(String) tarafından 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, GetSchema(String, String[])zaman uyumsuz sürümüdür. 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ısını çağırır ve tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir cancellationTokengeçirilirse iptal edilmiş bir görev döndürür. GetSchema(String, String[]) tarafından oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir.

(Devralındığı yer: DbConnection)
GetService(Type)

Component veya Containertarafından sağlanan bir hizmeti temsil eden bir nesnesi döndürür.

(Devralındığı yer: Component)
GetType()

Geçerli örneğin Type alır.

(Devralındığı yer: Object)
InitializeLifetimeService()
Geçersiz.

Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır.

(Devralındığı yer: MarshalByRefObject)
MemberwiseClone()

Geçerli Objectbasit bir kopyasını oluşturur.

(Devralındığı yer: Object)
MemberwiseClone(Boolean)

Geçerli MarshalByRefObject nesnesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

StateChange olayını başlatır.

(Devralındığı yer: DbConnection)
Open()

ConnectionStringtarafından belirtilen özellik ayarlarıyla bir veri kaynağına bağlantı açar.

OpenAsync()

ConnectionStringtarafından belirtilen ayarlarla bir veritabanı bağlantısı açan Open()zaman uyumsuz sürümü. Bu yöntem CancellationToken.None ile OpenAsync(CancellationToken) sanal yöntemini çağırır.

(Devralındığı yer: DbConnection)
OpenAsync(CancellationToken)

Bu, Open()zaman uyumsuz sürümüdür. 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ısını çağırır ve tamamlanmış bir görev döndürür. Varsayılan uygulama, 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 DbConnection nesnesinin 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()

varsa, Componentadını içeren bir String döndürür. Bu yöntem geçersiz kılınmamalıdır.

(Devralındığı yer: Component)

Ekinlikler

Disposed

Bileşen Dispose() yöntemine yapılan bir çağrıyla atıldığında gerçekleşir.

(Devralındığı yer: Component)
InfoMessage

ODBC sürücüsü bir uyarı veya bilgilendirici ileti gönderdiğinde gerçekleşir.

StateChange

Bağlantının durumu değiştiğ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().

IDbConnection.BeginTransaction()

Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir.

Veritabanı işlemini başlatır.

IDbConnection.BeginTransaction()

Veritabanı işlemini başlatır.

(Devralındığı yer: DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)

Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir.

Belirtilen yalıtım düzeyine sahip bir veritabanı işlemi başlatır.

IDbConnection.BeginTransaction(IsolationLevel)

Belirtilen yalıtım düzeyine sahip bir veritabanı işlemi başlatır.

(Devralındığı yer: DbConnection)
IDbConnection.CreateCommand()

Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir.

Bağlantıyla ilişkilendirilmiş bir komut nesnesi oluşturur ve döndürür.

IDbConnection.CreateCommand()

Geçerli bağlantıyla ilişkili bir DbCommand nesnesi oluşturur ve döndürür.

(Devralındığı yer: DbConnection)

Uzantı Metotları

ConfigureAwait(IAsyncDisposable, Boolean)

Zaman uyumsuz bir atılabilir öğeden döndürülen görevlerde awaits işleminin nasıl gerçekleştirileceğini yapılandırılır.

Şunlara uygulanır

Ayrıca bkz.