DbConnection Sınıf

Tanım

Veritabanı bağlantılarının temel davranışını tanımlar ve veritabanına özgü bağlantılar için bir temel sınıf sağlar.Defines the core behavior of database connections and provides a base class for database-specific connections.

public ref class DbConnection abstract : IDisposable
public ref class DbConnection abstract : System::ComponentModel::Component, IAsyncDisposable, IDisposable, System::Data::IDbConnection
public ref class DbConnection abstract : IDisposable, System::Data::IDbConnection
public ref class DbConnection abstract : System::ComponentModel::Component, IDisposable, System::Data::IDbConnection
public ref class DbConnection abstract : System::ComponentModel::Component, System::Data::IDbConnection
public ref class DbConnection abstract : System::ComponentModel::Component, IAsyncDisposable, System::Data::IDbConnection
public abstract class DbConnection : IDisposable
public abstract class DbConnection : System.ComponentModel.Component, IAsyncDisposable, IDisposable, System.Data.IDbConnection
public abstract class DbConnection : IDisposable, System.Data.IDbConnection
public abstract class DbConnection : System.ComponentModel.Component, IDisposable, System.Data.IDbConnection
public abstract class DbConnection : System.ComponentModel.Component, System.Data.IDbConnection
public abstract class DbConnection : System.ComponentModel.Component, IAsyncDisposable, System.Data.IDbConnection
type DbConnection = class
    interface IDisposable
type DbConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
    interface IAsyncDisposable
type DbConnection = class
    interface IDbConnection
    interface IDisposable
type DbConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
Public MustInherit Class DbConnection
Implements IDisposable
Public MustInherit Class DbConnection
Inherits Component
Implements IAsyncDisposable, IDbConnection, IDisposable
Public MustInherit Class DbConnection
Implements IDbConnection, IDisposable
Public MustInherit Class DbConnection
Inherits Component
Implements IDbConnection, IDisposable
Public MustInherit Class DbConnection
Inherits Component
Implements IDbConnection
Public MustInherit Class DbConnection
Inherits Component
Implements IAsyncDisposable, IDbConnection
Devralma
DbConnection
Devralma
Türetilmiş
Uygulamalar

Uygulayanlara Notlar

Öğesinden devralma sırasında, DbConnection aşağıdaki üyeleri geçersiz kılmanız gerekir: Close() ,,, BeginDbTransaction(IsolationLevel) ChangeDatabase(String) CreateDbCommand() , Open() ve StateChange .When you inherit from DbConnection, you must override the following members: Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), Open(), and StateChange. Ayrıca aşağıdaki özellikleri sağlamanız gerekir: ConnectionString ,,, Database DataSource ServerVersion ve State .You must also provide the following properties: ConnectionString, Database, DataSource, ServerVersion, and State.

Oluşturucular

DbConnection()

DbConnection sınıfının yeni bir örneğini başlatır.Initializes a new instance of the DbConnection class.

Özellikler

CanRaiseEvents

Bileşenin bir olay yapıp yapamayacağını gösteren bir değer alır.Gets a value indicating whether the component can raise an event.

(Devralındığı yer: Component)
ConnectionString

Türetilmiş bir sınıfta geçersiz kılındığında, bağlantıyı açmak için kullanılan dizeyi alır veya ayarlar.When overridden in a derived class, gets or sets the string used to open the connection.

ConnectionTimeout

Girişimi sonlandırıp bir hata oluşturmadan önce bağlantı kurarken beklenecek süreyi (saniye cinsinden) alır.Gets the time to wait (in seconds) while establishing a connection before terminating the attempt and generating an error.

Container

Öğesini içeren öğesini alır IContainer Component .Gets the IContainer that contains the Component.

(Devralındığı yer: Component)
Database

Türetilmiş bir sınıfta geçersiz kılındığında, bir bağlantı açıldıktan sonra geçerli veritabanının adını veya bağlantı açılmadan önce bağlantı dizesinde belirtilen veritabanı adını alır.When overridden in a derived class, gets the name of the current database after a connection is opened, or the database name specified in the connection string before the connection is opened.

DataSource

Türetilmiş bir sınıfta geçersiz kılındığında, bağlanılacak veritabanı sunucusunun adını alır.When overridden in a derived class, gets the name of the database server to which to connect.

DbProviderFactory

DbProviderFactoryBunu için alır DbConnection .Gets the DbProviderFactory for this DbConnection.

DesignMode

Şu anda Tasarım modunda olup olmadığını gösteren bir değer alır Component .Gets a value that indicates whether the Component is currently in design mode.

(Devralındığı yer: Component)
Events

Bu öğesine eklenen olay işleyicilerinin listesini alır Component .Gets the list of event handlers that are attached to this Component.

(Devralındığı yer: Component)
ServerVersion

Türetilmiş bir sınıfta geçersiz kılındığında, nesnenin bağlandığı sunucunun sürümünü temsil eden bir dize alır.When overridden in a derived class, gets a string that represents the version of the server to which the object is connected.

Site

Öğesini alır veya ayarlar ISite Component .Gets or sets the ISite of the Component.

(Devralındığı yer: Component)
State

Bağlantının durumunu açıklayan bir dize alır.Gets a string that describes the state of the connection.

Yöntemler

BeginDbTransaction(IsolationLevel)

Türetilmiş bir sınıfta geçersiz kılınırsa, bir veritabanı işlemi başlatır.When overridden in a derived class, starts a database transaction.

BeginDbTransactionAsync(IsolationLevel, CancellationToken)

Zaman uyumsuz olarak bir veritabanı işlemi başlatır.Asynchronously starts a database transaction.

BeginTransaction()

Bir veritabanı işlemi başlatır.Starts a database transaction.

BeginTransaction(IsolationLevel)

Belirtilen yalıtım düzeyiyle bir veritabanı işlemi başlatır.Starts a database transaction with the specified isolation level.

BeginTransactionAsync(CancellationToken)

Zaman uyumsuz olarak bir veritabanı işlemi başlatır.Asynchronously begins a database transaction.

BeginTransactionAsync(IsolationLevel, CancellationToken)

Zaman uyumsuz olarak bir veritabanı işlemi başlatır.Asynchronously begins a database transaction.

ChangeDatabase(String)

Türetilmiş bir sınıfta geçersiz kılınırsa, açık bir bağlantının geçerli veritabanını değiştirir.When overridden in a derived class, changes the current database for an open connection.

ChangeDatabaseAsync(String, CancellationToken)

Açık bir bağlantının geçerli veritabanını zaman uyumsuz olarak değiştirir.Asynchronously changes the current database for an open connection.

Close()

Türetilmiş bir sınıfta geçersiz kılınırsa, veritabanına bağlantıyı kapatır.When overridden in a derived class, closes the connection to the database.

CloseAsync()

Veritabanı bağlantısını zaman uyumsuz olarak kapatır.Asynchronously closes the connection to the database.

CreateCommand()

DbCommandGeçerli bağlantıyla ilişkili bir nesne oluşturur ve döndürür.Creates and returns a DbCommand object associated with the current connection.

CreateDbCommand()

Türetilmiş bir sınıfta geçersiz kılınırsa, DbCommand geçerli bağlantıyla ilişkili bir nesne oluşturur ve döndürür.When overridden in a derived class, creates and returns a DbCommand object associated with the current connection.

CreateObjRef(Type)

Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm bilgileri içeren bir nesne oluşturur.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(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.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Dispose()

Component tarafından kullanılan tüm kaynakları serbest bırakır.Releases all resources used by the Component.

(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.Releases the unmanaged resources used by the DbConnection and optionally releases the managed resources.

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.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Devralındığı yer: Component)
DisposeAsync()

Bağlantı nesnesini zaman uyumsuz olarak atar.Asynchronously diposes the connection object.

EnlistTransaction(Transaction)

Belirtilen işlemdeki listeler.Enlists in the specified transaction.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetLifetimeService()
Kullanımdan kalktı.

Bu örnek için ömür ilkesini denetleyen geçerli ömür hizmeti nesnesini alır.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Devralındığı yer: MarshalByRefObject)
GetSchema()

Bunun veri kaynağı için şema bilgilerini döndürür DbConnection .Returns schema information for the data source of this DbConnection.

GetSchema(String)

DbConnectionŞema adı için belirtilen dizeyi kullanarak bu veri kaynağı için şema bilgilerini döndürür.Returns schema information for the data source of this DbConnection using the specified string for the schema name.

GetSchema(String, String[])

DbConnectionŞema adı için belirtilen dizeyi ve kısıtlama değerleri için belirtilen dize dizisini kullanarak bu değerin veri kaynağı için şema bilgilerini döndürür.Returns schema information for the data source of this DbConnection using the specified string for the schema name and the specified string array for the restriction values.

GetSchemaAsync(CancellationToken)

Bu, öğesinin zaman uyumsuz bir sürümüdür GetSchema() .This is an asynchronous version of GetSchema(). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır.Providers should override with an appropriate implementation. cancellationTokenİsteğe bağlı olarak bu kabul edilebilir.The cancellationToken can optionally be honored. Varsayılan uygulama, zaman uyumlu GetSchema() aramayı çağırır ve tamamlanan bir görev döndürür.The default implementation invokes the synchronous GetSchema() call and returns a completed task. Zaten iptal edildiyse, varsayılan uygulama iptal edilen bir görev döndürür cancellationToken .The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Tarafından oluşturulan özel durumlar GetSchema() , döndürülen görev özel durumu özelliği aracılığıyla iletilecektir.Exceptions thrown by GetSchema() will be communicated via the returned Task Exception property.

GetSchemaAsync(String, CancellationToken)

Bu, öğesinin zaman uyumsuz sürümüdür GetSchema(String) .This is the asynchronous version of GetSchema(String). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır.Providers should override with an appropriate implementation. cancellationTokenİsteğe bağlı olarak bu kabul edilebilir.The cancellationToken can optionally be honored. Varsayılan uygulama, zaman uyumlu GetSchema(String) aramayı çağırır ve tamamlanan bir görev döndürür.The default implementation invokes the synchronous GetSchema(String) call and returns a completed task. Zaten iptal edildiyse, varsayılan uygulama iptal edilen bir görev döndürür cancellationToken .The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Tarafından oluşturulan özel durumlar GetSchema(String) , döndürülen görev özel durumu özelliği aracılığıyla iletilecektir.Exceptions thrown by GetSchema(String) will be communicated via the returned Task Exception property.

GetSchemaAsync(String, String[], CancellationToken)

Bu, öğesinin zaman uyumsuz sürümüdür GetSchema(String, String[]) .This is the asynchronous version of GetSchema(String, String[]). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır.Providers should override with an appropriate implementation. cancellationTokenİsteğe bağlı olarak bu kabul edilebilir.The cancellationToken can optionally be honored. Varsayılan uygulama, zaman uyumlu GetSchema(String, String[]) aramayı çağırır ve tamamlanan bir görev döndürür.The default implementation invokes the synchronous GetSchema(String, String[]) call and returns a completed task. Zaten iptal edildiyse, varsayılan uygulama iptal edilen bir görev döndürür cancellationToken .The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Tarafından oluşturulan özel durumlar GetSchema(String, String[]) , döndürülen görev özel durumu özelliği aracılığıyla iletilecektir.Exceptions thrown by GetSchema(String, String[]) will be communicated via the returned Task Exception property.

GetService(Type)

Veya tarafından belirtilen bir hizmeti temsil eden bir nesne döndürür Component Container .Returns an object that represents a service provided by the Component or by its Container.

(Devralındığı yer: Component)
GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
InitializeLifetimeService()
Kullanımdan kalktı.

Bu örnek için ömür ilkesini denetlemek üzere bir ömür hizmeti nesnesi alır.Obtains a lifetime service object to control the lifetime policy for this instance.

(Devralındığı yer: MarshalByRefObject)
MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
MemberwiseClone(Boolean)

Geçerli nesnenin basit bir kopyasını oluşturur MarshalByRefObject .Creates a shallow copy of the current MarshalByRefObject object.

(Devralındığı yer: MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

Olayını oluşturur StateChange .Raises the StateChange event.

Open()

Türetilmiş bir sınıfta geçersiz kılınırsa, tarafından belirtilen ayarlarla bir veritabanı bağlantısı açar ConnectionString .When overridden in a derived class, opens a database connection with the settings specified by the ConnectionString.

OpenAsync()

Open()Tarafından belirtilen ayarlarla bir veritabanı bağlantısı açan zaman uyumsuz bir sürümü ConnectionString .An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. Bu yöntem, OpenAsync(CancellationToken) CancellationToken. None ile sanal yöntemi çağırır.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

OpenAsync(CancellationToken)

Bu, öğesinin zaman uyumsuz sürümüdür Open() .This is the asynchronous version of Open(). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır.Providers should override with an appropriate implementation. İptal belirteci isteğe bağlı olarak kabul edilebilir.The cancellation token can optionally be honored.

Varsayılan uygulama, zaman uyumlu Open() aramayı çağırır ve tamamlanan bir görev döndürür.The default implementation invokes the synchronous Open() call and returns a completed task. Zaten iptal edilmiş bir cancellationToken geçirildiğinde varsayılan uygulama iptal edilen bir görev döndürür.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Open tarafından oluşturulan özel durumlar, döndürülen görev özel durumu özelliği aracılığıyla iletilecektir.Exceptions thrown by Open will be communicated via the returned Task Exception property.

Döndürülen görev tamamlanana kadar nesnenin diğer yöntemlerini ve özelliklerini çağırmayın DbConnection .Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)
ToString()

Varsa, String varsa adını içeren bir döndürür Component .Returns a String containing the name of the Component, if any. Bu yöntem geçersiz kılınmamalıdır.This method should not be overridden.

(Devralındığı yer: Component)

Ekinlikler

Disposed

Bileşen yönteme bir çağrı tarafından bırakıldığında gerçekleşir Dispose() .Occurs when the component is disposed by a call to the Dispose() method.

(Devralındığı yer: Component)
StateChange

Bağlantının durumu değiştiğinde gerçekleşir.Occurs when the state of the connection changes.

Belirtik Arabirim Kullanımları

IDbConnection.BeginTransaction()

Bir veritabanı işlemi başlatır.Begins a database transaction.

IDbConnection.BeginTransaction(IsolationLevel)

Belirtilen yalıtım düzeyine sahip bir veritabanı işlemi başlatır.Begins a database transaction with the specified isolation level.

IDbConnection.CreateCommand()

DbCommandGeçerli bağlantıyla ilişkili bir nesne oluşturur ve döndürür.Creates and returns a DbCommand object that is associated with the current connection.

Uzantı Metotları

ConfigureAwait(IAsyncDisposable, Boolean)

Zaman uyumsuz bir atılabilir döndürülen görevlerin ne kadar beklediğini yapılandırır.Configures how awaits on the tasks returned from an async disposable are performed.

Şunlara uygulanır