OleDbConnection Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Bir veri kaynağına açık bağlantıyı temsil eder.
public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable, IDisposable
public ref class OleDbConnection sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection
public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable
public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable, IDisposable
public sealed class OleDbConnection : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbConnection
public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable
type OleDbConnection = class
inherit DbConnection
interface ICloneable
interface IDbConnection
interface IDisposable
type OleDbConnection = class
inherit Component
interface ICloneable
interface IDbConnection
interface IDisposable
type OleDbConnection = class
inherit DbConnection
interface IDbConnection
interface IDisposable
interface ICloneable
Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbConnection
Inherits Component
Implements ICloneable, IDbConnection, IDisposable
Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable
- Devralma
- Devralma
- Uygulamalar
Ö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() |
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. |
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.
|
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.
|
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.
|
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 |
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. |
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. |