OleDbConnection 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.4.26230.115

Kaynak:

OleDbConnection.cs

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

public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable, IDisposable

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

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

Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable, IDisposable

Devralma

Object

DbConnection

OleDbConnection

Öznitelikler

RequiresDynamicCodeAttribute

Uygulamalar

IDbConnection ICloneable IDisposable

Örnekler

Aşağıdaki örnek bir OleDbCommand ve OleDbConnectionoluşturur. OleDbConnection açılır ve için Connectionolarak OleDbCommand ayarlanır. Örnek daha sonra bağlantıyı çağırır ExecuteNonQuery ve kapatır. Bunu yapmak için ExecuteNonQuery bir bağlantı dizesi ve SQL INSERT deyimi olan bir sorgu dizesi geçirilir.

public void InsertRow(string connectionString, string insertSQL)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        // The insertSQL string contains a SQL statement that
        // inserts a new row in the source table.
        OleDbCommand command = new OleDbCommand(insertSQL);

        // Set the Connection to the new OleDbConnection.
        command.Connection = connection;

        // Open the connection and execute the insert command.
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
}

Public Sub InsertRow(ByVal connectionString As String, _
    ByVal insertSQL As String)

    Using connection As New OleDbConnection(connectionString)
        ' The insertSQL string contains a SQL statement that
        ' inserts a new row in the source table.
        Dim command As New OleDbCommand(insertSQL)

        ' Set the Connection to the new OleDbConnection.
        command.Connection = connection

        ' Open the connection and execute the insert command.
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

Açıklamalar

Nesne, OleDbConnection 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 OLE DB sağlayıcısı tarafından desteklenen işlevselliğe bağlı olarak, bir OleDbConnection nesnenin bazı yöntemleri veya özellikleri kullanılamayabilir.

örneğini OleDbConnectionoluşturduğunuzda, tüm özellikler ilk değerlerine ayarlanır. Bu değerlerin listesi için oluşturucuya OleDbConnection bakın.

Tek bir OleDbConnectionüzerinde birden fazla DataReader açabilirsiniz. Kullandığınız OLE DB sağlayıcısı tek bir bağlantıda birden fazla DataReader'ı desteklemiyorsa, sağlayıcı örtük olarak her biri için ek bir bağlantı açar.

OleDbConnection kapsamı dışına çıkarsa kapatılmaz. Bu nedenle, çağırarak Close veya Dispose veya deyimi OleDbConnection içindeki Using nesnesini kullanarak bağlantıyı açıkça kapatmanız gerekir.

Note

Yüksek performanslı uygulamalar dağıtmak için bağlantı havuzu kullanmanız gerekir. OLE DB için .NET Framework Veri Sağlayıcısı kullandığınızda, sağlayıcı bunu otomatik olarak yönettiğinden bağlantı havuzunu etkinleştirmeniz gerekmez. OLE DB için .NET Framework Veri Sağlayıcısı ile bağlantı havuzunu kullanma hakkında daha fazla bilgi için bkz. OLE DB, ODBC ve Oracle Bağlantı Havuzu.

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

Nesnesinin bir örneğini OleDbConnection 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. OleDbConnection nesnesini kullanarak güvenlik talepleri oluşturur OleDbPermission . Kullanıcılar, nesnesini kullanarak OleDbPermissionAttribute kodlarının yeterli izinlere sahip olduğunu doğrulayabilir. Kullanıcılar ve yöneticiler bilgisayar, kullanıcı ve kuruluş düzeylerinde güvenlik ilkesini değiştirmek için Caspol.exe (Kod Erişimi Güvenlik İlkesi Aracı) da kullanabilir. Daha fazla bilgi için bkz . Kod Erişim Güvenliği ve ADO.NET.

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

Note

Nesnesi, OleDbConnection OLE DB sağlayıcısına özgü dinamik özelliklerin ayarlanmasını veya alınmasını desteklemez. Sadece OLE DB sağlayıcısı için bağlantı dizesine geçirilebilecek özellikler desteklenir.

Oluşturucular

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

Özellikler

Name	Description
ConnectionString	Veritabanı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.
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.
Provider	bağlantı dizesi "Provider= " yan tümcesinde belirtilen OLE DB sağlayı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()	Geçerli IsolationLevel değerle bir veritabanı işlemi başlatır.
BeginTransaction(IsolationLevel)	Belirtilen yalıtım düzeyine sahip bir veritabanı işlemi başlatır.
ChangeDatabase(String)	Açık OleDbConnectionbir için geçerli veritabanını değiştirir.
Close()	Veri kaynağı bağlantısını kapatır.
CreateCommand()	ile OleDbCommandilişkilendirilmiş bir OleDbConnection nesne oluşturur ve döndürür.
EnlistTransaction(Transaction)	Belirtilen işlemde dağıtılmış işlem olarak listeler.
GetOleDbSchemaTable(Guid, Object[])	Veri kaynağındaki şema bilgilerini GUID tarafından gösterildiği gibi ve belirtilen kısıtlamaları uygulandıktan sonra döndürür.
GetSchema()	Bu OleDbConnectionveri 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 OleDbConnection veri kaynağı için şema bilgilerini döndürür.
GetSchema(String)	Şema adı için belirtilen dizeyi kullanarak bunun OleDbConnection veri kaynağı için şema bilgilerini döndürür.
Open()	tarafından ConnectionStringbelirtilen özellik ayarlarıyla bir veritabanı bağlantısı açar.
ReleaseObjectPool()	Nesne havuzunun OleDbConnection , temel alınan son bağlantı serbest bırakıldığında serbest bırakılabildiğini gösterir.
ResetState()	nesnesinin StateOleDbConnection özelliğini güncelleştirir.

Ekinlikler

Name	Description
InfoMessage	Sağlayıcı bir uyarı veya bilgilendirme iletisi 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