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 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ı için bağlantı dizesi 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ı dizesi ile 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) |
CanRaiseEvents |
Bileşenin bir 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 |
öğesini IContainer içeren öğesini Componentalı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 |
Bunun DbConnectioniçin öğesini DbProviderFactory alır. (Devralındığı yer: DbConnection) |
DesignMode |
öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır. (Devralındığı yer: Component) |
Events |
Bu Componentöğesine eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component) |
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. |
Site |
öğesini alır veya ayarlar ISiteComponent. (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ğ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) |
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() |
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() |
Component tarafı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 yönetilen kaynakları isteğe bağlı olarak serbest bırakır. (Devralındığı yer: DbConnection) |
Dispose(Boolean) |
Component 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: Component) |
DisposeAsync() |
Zaman uyumsuz olarak bağlantı nesnesine daldırıyor. (Devralındığı yer: DbConnection) |
EnlistDistributedTransaction(ITransaction) |
Belirtilen işlemdeki listeler dağıtılmış bir işlem olarak. |
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) |
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 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.
|
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.
|
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.
|
GetService(Type) |
veya tarafından ComponentContainersağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component) |
GetType() |
Type Geçerli örneğini 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 Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
MemberwiseClone(Boolean) |
Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject) |
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 |
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() |
Varsa, adını Componentiç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 yöntemine Dispose() yapılan bir çağrı tarafından 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şkili bir komut nesnesi oluşturur ve döndürür. |
IDbConnection.CreateCommand() |
Geçerli bağlantıyla ilişkili bir DbCommand nesne 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ştirildiğini yapılandıran. |
Şunlara uygulanır
Ayrıca bkz.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin