DbConnection 클래스

정의

데이터베이스 연결의 핵심 동작을 정의하고 데이터베이스 관련 연결에 대한 기본 클래스를 제공합니다.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
상속
DbConnection
상속
파생
구현

구현자 참고

에서 상속 하 DbConnection 는 경우,,,, Close() BeginDbTransaction(IsolationLevel) ChangeDatabase(String) CreateDbCommand() Open()StateChange 멤버를 재정의 해야 합니다.When you inherit from DbConnection, you must override the following members: Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), Open(), and StateChange. 또한,,, ConnectionString Database DataSource ServerVersion 및 속성도 제공 해야 State 합니다.You must also provide the following properties: ConnectionString, Database, DataSource, ServerVersion, and State.

생성자

DbConnection()

DbConnection 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DbConnection class.

속성

CanRaiseEvents

구성 요소가 이벤트를 발생시킬 수 있는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the component can raise an event.

(다음에서 상속됨 Component)
ConnectionString

파생 클래스에서 재정의되는 경우 연결을 여는 데 사용되는 문자열을 가져오거나 설정합니다.When overridden in a derived class, gets or sets the string used to open the connection.

ConnectionTimeout

시도를 종료하고 오류를 생성하기 전까지 연결하기 위해 대기할 시간(초 단위)을 가져옵니다.Gets the time to wait (in seconds) while establishing a connection before terminating the attempt and generating an error.

Container

IContainer을 포함하는 Component를 가져옵니다.Gets the IContainer that contains the Component.

(다음에서 상속됨 Component)
Database

파생 클래스에서 재정의되는 경우 연결이 열린 후에 현재 데이터베이스의 이름을 가져오거나 연결이 열리기 전에 연결 문자열에 지정된 데이터베이스 이름을 가져옵니다.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

파생 클래스에서 재정의되는 경우 연결할 데이터베이스 서버의 이름을 가져옵니다.When overridden in a derived class, gets the name of the database server to which to connect.

DbProviderFactory

DbProviderFactoryDbConnection를 가져옵니다.Gets the DbProviderFactory for this DbConnection.

DesignMode

Component가 현재 디자인 모드인지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the Component is currently in design mode.

(다음에서 상속됨 Component)
Events

Component에 연결된 이벤트 처리기의 목록을 가져옵니다.Gets the list of event handlers that are attached to this Component.

(다음에서 상속됨 Component)
ServerVersion

파생 클래스에서 재정의되는 경우 개체가 연결된 서버의 버전을 나타내는 문자열을 가져옵니다.When overridden in a derived class, gets a string that represents the version of the server to which the object is connected.

Site

ComponentISite를 가져오거나 설정합니다.Gets or sets the ISite of the Component.

(다음에서 상속됨 Component)
State

연결의 상태를 설명하는 문자열을 가져옵니다.Gets a string that describes the state of the connection.

메서드

BeginDbTransaction(IsolationLevel)

파생 클래스에서 재정의되는 경우 데이터베이스 트랜잭션을 시작합니다.When overridden in a derived class, starts a database transaction.

BeginDbTransactionAsync(IsolationLevel, CancellationToken)

데이터베이스 트랜잭션을 비동기적으로 시작합니다.Asynchronously starts a database transaction.

BeginTransaction()

데이터베이스 트랜잭션을 시작합니다.Starts a database transaction.

BeginTransaction(IsolationLevel)

지정된 격리 수준으로 데이터베이스 트랜잭션을 시작합니다.Starts a database transaction with the specified isolation level.

BeginTransactionAsync(CancellationToken)

비동기적으로 데이터베이스 트랜잭션을 시작합니다.Asynchronously begins a database transaction.

BeginTransactionAsync(IsolationLevel, CancellationToken)

비동기적으로 데이터베이스 트랜잭션을 시작합니다.Asynchronously begins a database transaction.

ChangeDatabase(String)

파생 클래스에서 재정의되는 경우 열려 있는 연결의 현재 데이터베이스를 변경합니다.When overridden in a derived class, changes the current database for an open connection.

ChangeDatabaseAsync(String, CancellationToken)

열려 있는 연결의 현재 데이터베이스를 비동기적으로 변경합니다.Asynchronously changes the current database for an open connection.

Close()

파생 클래스에서 재정의되는 경우 데이터베이스에 대한 연결을 닫습니다.When overridden in a derived class, closes the connection to the database.

CloseAsync()

데이터베이스에 대한 연결을 비동기적으로 닫습니다.Asynchronously closes the connection to the database.

CreateCommand()

현재 연결과 관련된 DbCommand 개체를 만들고 반환합니다.Creates and returns a DbCommand object associated with the current connection.

CreateDbCommand()

파생 클래스에서 재정의되는 경우 현재 연결과 관련된 DbCommand 개체를 만들고 반환합니다.When overridden in a derived class, creates and returns a DbCommand object associated with the current connection.

CreateObjRef(Type)

원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(다음에서 상속됨 MarshalByRefObject)
Dispose()

관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Dispose()

Component에서 사용하는 모든 리소스를 해제합니다.Releases all resources used by the Component.

(다음에서 상속됨 Component)
Dispose(Boolean)

DbConnection에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다.Releases the unmanaged resources used by the DbConnection and optionally releases the managed resources.

Dispose(Boolean)

Component에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(다음에서 상속됨 Component)
DisposeAsync()

연결 개체를 비동기적으로 삭제합니다.Asynchronously diposes the connection object.

EnlistTransaction(Transaction)

지정된 트랜잭션에 참여합니다.Enlists in the specified transaction.

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetLifetimeService()
사용되지 않습니다.

이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(다음에서 상속됨 MarshalByRefObject)
GetSchema()

DbConnection의 데이터 소스에 대한 구성표 정보를 반환합니다.Returns schema information for the data source of this DbConnection.

GetSchema(String)

스키마 이름에 대해 지정된 문자열을 사용하여 이 DbConnection의 데이터 소스에 대한 스키마 정보를 반환합니다.Returns schema information for the data source of this DbConnection using the specified string for the schema name.

GetSchema(String, String[])

스키마 이름에 대해 지정된 문자열과 제한 값에 대해 지정된 문자열 배열을 사용하여 이 DbConnection의 데이터 소스에 대한 스키마 정보를 반환합니다.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)

GetSchema()의 비동기 버전입니다.This is an asynchronous version of GetSchema(). 공급자는 적절한 구현을 재정의해야 합니다.Providers should override with an appropriate implementation. cancellationToken을 선택적으로 적용할 수 있습니다.The cancellationToken can optionally be honored. 기본 구현은 동기 GetSchema() 호출을 호출하고 완료된 작업을 반환합니다.The default implementation invokes the synchronous GetSchema() call and returns a completed task. 기본 구현은 이미 취소된 cancellationToken을 전달하는 경우 취소된 작업을 반환합니다.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. GetSchema()에서 throw되는 예외는 반환된 Task Exception 속성을 통해 전달됩니다.Exceptions thrown by GetSchema() will be communicated via the returned Task Exception property.

GetSchemaAsync(String, CancellationToken)

GetSchema(String)의 비동기 버전입니다.This is the asynchronous version of GetSchema(String). 공급자는 적절한 구현을 재정의해야 합니다.Providers should override with an appropriate implementation. cancellationToken을 선택적으로 적용할 수 있습니다.The cancellationToken can optionally be honored. 기본 구현은 동기 GetSchema(String) 호출을 호출하고 완료된 작업을 반환합니다.The default implementation invokes the synchronous GetSchema(String) call and returns a completed task. 기본 구현은 이미 취소된 cancellationToken을 전달하는 경우 취소된 작업을 반환합니다.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. GetSchema(String)에서 throw되는 예외는 반환된 Task Exception 속성을 통해 전달됩니다.Exceptions thrown by GetSchema(String) will be communicated via the returned Task Exception property.

GetSchemaAsync(String, String[], CancellationToken)

GetSchema(String, String[])의 비동기 버전입니다.This is the asynchronous version of GetSchema(String, String[]). 공급자는 적절한 구현을 재정의해야 합니다.Providers should override with an appropriate implementation. cancellationToken을 선택적으로 적용할 수 있습니다.The cancellationToken can optionally be honored. 기본 구현은 동기 GetSchema(String, String[]) 호출을 호출하고 완료된 작업을 반환합니다.The default implementation invokes the synchronous GetSchema(String, String[]) call and returns a completed task. 기본 구현은 이미 취소된 cancellationToken을 전달하는 경우 취소된 작업을 반환합니다.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. GetSchema(String, String[])에서 throw되는 예외는 반환된 Task Exception 속성을 통해 전달됩니다.Exceptions thrown by GetSchema(String, String[]) will be communicated via the returned Task Exception property.

GetService(Type)

Component 또는 해당 Container에서 제공하는 서비스를 나타내는 개체를 반환합니다.Returns an object that represents a service provided by the Component or by its Container.

(다음에서 상속됨 Component)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
InitializeLifetimeService()
사용되지 않습니다.

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.Obtains a lifetime service object to control the lifetime policy for this instance.

(다음에서 상속됨 MarshalByRefObject)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
MemberwiseClone(Boolean)

현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다.Creates a shallow copy of the current MarshalByRefObject object.

(다음에서 상속됨 MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

StateChange 이벤트를 발생시킵니다.Raises the StateChange event.

Open()

파생 클래스에서 재정의되는 경우 ConnectionString으로 지정된 설정을 사용하여 데이터베이스 연결을 엽니다.When overridden in a derived class, opens a database connection with the settings specified by the ConnectionString.

OpenAsync()

Open()으로 지정된 설정을 사용하여 데이터베이스 연결을 여는 ConnectionString의 비동기 버전입니다.An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. 이 메서드는 CancellationToken.None을 사용하여 가상 메서드 OpenAsync(CancellationToken)를 호출합니다.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

OpenAsync(CancellationToken)

Open()의 비동기 버전입니다.This is the asynchronous version of Open(). 공급자는 적절한 구현을 재정의해야 합니다.Providers should override with an appropriate implementation. 취소 토큰은 선택적으로 적용될 수 있습니다.The cancellation token can optionally be honored.

기본 구현은 동기 Open() 호출을 호출하고 완료된 작업을 반환합니다.The default implementation invokes the synchronous Open() call and returns a completed task. 기본 구현은 이미 취소된 cancellationToken을 전달하는 경우 취소된 작업을 반환합니다.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Open에서 throw되는 예외는 반환된 Task Exception 속성을 통해 전달됩니다.Exceptions thrown by Open will be communicated via the returned Task Exception property.

반환된 작업이 완료될 때까지 DbConnection 개체의 다른 메서드 및 속성을 호출하지 마십시오.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)
ToString()

Component의 이름이 포함된 String을 반환합니다(있는 경우).Returns a String containing the name of the Component, if any. 이 메서드는 재정의할 수 없습니다.This method should not be overridden.

(다음에서 상속됨 Component)

이벤트

Disposed

Dispose() 메서드를 호출하여 구성 요소를 삭제할 때 발생합니다.Occurs when the component is disposed by a call to the Dispose() method.

(다음에서 상속됨 Component)
StateChange

연결 상태가 변경될 때 발생합니다.Occurs when the state of the connection changes.

명시적 인터페이스 구현

IDbConnection.BeginTransaction()

데이터베이스 트랜잭션을 시작합니다.Begins a database transaction.

IDbConnection.BeginTransaction(IsolationLevel)

지정된 격리 수준으로 데이터베이스 트랜잭션을 시작합니다.Begins a database transaction with the specified isolation level.

IDbConnection.CreateCommand()

현재 연결과 관련된 DbCommand 개체를 만들고 반환합니다.Creates and returns a DbCommand object that is associated with the current connection.

확장 메서드

ConfigureAwait(IAsyncDisposable, Boolean)

비동기 일회용에서 반환되는 작업을 대기하는 방법을 구성합니다.Configures how awaits on the tasks returned from an async disposable are performed.

적용 대상