OleDbConnection Sınıf

Tanım

Ad Alanı:

System.Data.OleDb

Bütünleştirilmiş Kod:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v9.0.0-preview.7.24405.7

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

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

type OleDbConnection = class
    inherit DbConnection
    interface ICloneable
    interface IDbConnection
    interface IDisposable

Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable, IDisposable

Devralma

Object

MarshalByRefObject

Component

DbConnection

OleDbConnection

Uygulamalar

IDbConnection ICloneable IDisposable

Örnekler

Aşağıdaki örnek bir OleDbCommand ve bir OleDbConnectionoluşturur. OleDbConnection açılır ve OleDbCommandiçin Connection 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.

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

OleDbConnection nesnesi, 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, OleDbConnection nesnesinin bazı yöntemleri veya özellikleri kullanılamayabilir.

bir OleDbConnectionörneği oluşturduğunuzda, tüm özellikler ilk değerlerine ayarlanır. Bu değerlerin listesi için bkz. OleDbConnection oluşturucu.

Tek bir OleDbConnectionbirden 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, Close veya Disposeçağırarak veya Using deyimindeki OleDbConnection nesnesini kullanarak bağlantıyı açıkça kapatmanız gerekir.

Not

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ı'nı kullandığınızda, sağlayıcı bunu otomatik olarak yönettiğinden bağlantı havuzu oluşturmayı etkinleştirmeniz gerekmez. OLE DB için .NET Framework Veri Sağlayıcısı ile bağlantı havuzu kullanma hakkında daha fazla bilgi için bkz. OLE DB, ODBC ve Oracle Bağlantı Havuzu.

Bir OleDbCommandyürüten yöntem tarafından önemli bir OleDbException (ö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.

OleDbConnection 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. OleDbConnection, OleDbPermission nesnesini kullanarak güvenlik talepleri oluşturur. Kullanıcılar, OleDbPermissionAttribute nesnesini kullanarak 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şim Güvenlik İlkesi Aracı) de 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ı.

Not

OleDbConnection nesnesi, OLE DB sağlayıcısına özgü dinamik özelliklerin ayarlanmasını veya alınmasını desteklemez. Yalnızca OLE DB sağlayıcısının bağlantı dizesinde geçirilebilen özellikler desteklenir.

Oluşturucular

OleDbConnection()	OleDbConnection sınıfının yeni bir örneğini başlatır.
OleDbConnection(String)	Belirtilen bağlantı dizesiyle OleDbConnection 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	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.
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)
Events	Bu Componenteklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component)
Provider	Bağlantı dizesinin "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.
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()	Geçerli IsolationLevel değeriyle bir veritabanı işlemi başlatır.
BeginTransaction(IsolationLevel)	Belirtilen yalıtım düzeyine sahip bir veritabanı işlemi 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 OleDbConnectioniçin 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()	OleDbConnectionile ilişkilendirilmiş bir OleDbCommand 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(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)
DisposeAsync()	Zaman uyumsuz olarak bağlantı nesnesine daldırıyor. (Devralındığı yer: DbConnection)
EnlistTransaction(Transaction)	Belirtilen işlemde dağıtılmış işlem olarak listeler.
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)
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)	Şema adı için belirtilen dizeyi kullanarak bu OleDbConnection veri kaynağı için şema bilgilerini döndürür.
GetSchema(String, String[])	Bu OleDbConnection 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 veritabanı bağlantısı 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()	OleDbConnection nesne havuzunun, temel alınan son bağlantı serbest bırakıldığında serbest bırakılabildiğini gösterir.
ResetState()	OleDbConnection nesnesinin State özelliğini güncelleştirir.
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	Sağlayıcı 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().
IDbConnection.BeginTransaction()	Veritabanı işlemini başlatır. (Devralındığı yer: DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Belirtilen yalıtım düzeyine sahip bir veritabanı işlemi başlatır. (Devralındığı yer: DbConnection)
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.

Ayrıca bkz.

• Veri Kaynaklarına Bağlanma