OdbcConnection 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:

OdbcConnection.cs

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 açılır ve özelliği olarak Connection 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şlevselliğe bağlı olarak, bir OdbcConnection nesnenin bazı yöntemleri veya özellikleri kullanılamayabilir.

nesnesi ODBC OdbcConnection 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 her zaman açık nesneleri çağırarak Close veya Dispose ile açıkça kapatmalısınızOdbcConnection. 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 -related hatalarıyla 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ın yöntemlerinden ExecuteOdbcCommand biri önemli OdbcException (örneğin, 20 veya daha yüksek bir SQL Server önem düzeyi) neden olursa, OdbcConnection kapatılabilir. 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ş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

Name	Description
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

Name	Description
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.
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

Name	Description
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.
ChangeDatabase(String)	Açık OdbcConnectionbir ile ilişkili geçerli veritabanını değiştirir.
Close()	Veri kaynağı bağlantısını kapatır.
CreateCommand()	ile OdbcConnectionilişkilendirilmiş bir OdbcCommand nesne oluşturur ve döndürür.
GetSchema()	Bu OdbcConnectionveri kaynağı için şema bilgilerini döndürür.
GetSchema(String, String[])	Şema adı için belirtilen dizeyi ve kısıtlama değerleri için belirtilen dize dizisini kullanarak bunun OdbcConnection veri kaynağı için şema bilgilerini döndürür.
GetSchema(String)	Şema adı için belirtilen adı kullanarak bunun OdbcConnection veri kaynağı için şema bilgilerini döndürür.
Open()	tarafından ConnectionStringbelirtilen özellik ayarlarıyla bir veri kaynağına bağlantı açar.
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.

Ekinlikler

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

Belirtik Arabirim Kullanımları

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

Ayrıca bkz.

• Veri Kaynaklarına Bağlanma