OleDbConnection Sınıf

Tanım

Ad Alanı:

System.Data.OleDb

Bütünleştirilmiş Kod:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v8.0.0

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

DbConnection

OleDbConnection

Uygulamalar

IDbConnection ICloneable IDisposable

Örnekler

Aşağıdaki örnek bir OleDbCommand ve OleDbConnectionoluşturur. OleDbConnection açılır ve için OleDbCommandolarak Connection ayarlanır. Örnek daha sonra bağlantıyı çağırır ExecuteNonQuery ve kapatır. Bunu başarmak için bir ExecuteNonQuery 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şlevlere 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 Using içindeki 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ı 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.

Bir yürüten OleDbCommandOleDbConnection yöntem tarafından önemli OleDbException bir (örneğin, SQL Server önem derecesi 20 veya daha yüksek) oluşturulursa 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 OleDbPermission güvenlik talepleri oluşturur. 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üzeylerindeki 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ı.

Not

OleDbConnection Nesnesi, OLE DB sağlayıcısına özgü dinamik özellikleri ayarlamayı veya almayı 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 sınıfının yeni bir örneğini OleDbConnection 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	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.
DbProviderFactory	Bunun DbConnectioniçin öğesini DbProviderFactory alır. (Devralındığı yer: DbConnection)
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.
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ğerle 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 OleDbConnectionbir iç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ğına bağlantıyı 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 OleDbConnectioniliş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 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ı nesnesine daldırıyor. (Devralındığı yer: DbConnection)
EnlistTransaction(Transaction)	Belirtilen işlemdeki listeler dağıtılmış bir işlem olarak.
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)
GetOleDbSchemaTable(Guid, Object[])	Veri kaynağındaki şema bilgilerini GUID ile belirtilen şekilde ve belirtilen kısıtlamaları uygulandıktan sonra döndürür.
GetSchema()	Bu OleDbConnectionöğesinin 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.
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.
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 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 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 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 veritabanı bağlantısı 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, 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()	Nesne havuzunun OleDbConnection , temel alınan son bağlantı serbest bırakıldığında serbest bırakılabildiğini gösterir.
ResetState()	nesnesinin State özelliğini OleDbConnection Güncelleştirmeler.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ekinlikler

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(). .

Ayrıca bkz.

• Veri Kaynaklarına Bağlanma