DbCommandBuilder DbCommandBuilder DbCommandBuilder DbCommandBuilder Class

정의

관련 데이터베이스를 사용하여 DataSet에 변경한 내용을 조정하는 데 사용되는 단일 테이블 명령을 자동으로 생성합니다.Automatically generates single-table commands used to reconcile changes made to a DataSet with the associated database. 이 클래스는 상속될 수만 있는 추상 클래스입니다.This is an abstract class that can only be inherited.

public ref class DbCommandBuilder abstract : System::ComponentModel::Component
public abstract class DbCommandBuilder : System.ComponentModel.Component
type DbCommandBuilder = class
    inherit Component
Public MustInherit Class DbCommandBuilder
Inherits Component
상속

설명

DbCommandBuilder 클래스 자체 명령 작성기를 만드는 공급자 작성자의 편의 위해 제공 됩니다.The DbCommandBuilder class is provided for the convenience of provider writers creating their own command builders. 이 클래스에서 상속 하 여 개발자가 자신의 코드에서 공급자별 동작을 구현할 수 있습니다.By inheriting from this class, developers can implement provider specific behavior in their own code.

합니다 DbDataAdapter 변경 내용을 조정 하는 데 필요한 SQL 문을 자동으로 생성 하지 않습니다는 DataSet 연결된 된 데이터 소스를 사용 하 여 합니다.The DbDataAdapter does not automatically generate the SQL statements required to reconcile changes made to a DataSet with the associated data source. 만들 수 있습니다는 DbCommandBuilder 설정 하는 경우 단일 테이블 업데이트에 대 한 SQL 문을 자동으로 생성 하는 개체를 SelectCommand 의 속성을 DbDataAdapter입니다.However, you can create a DbCommandBuilder object to automatically generate SQL statements for single-table updates if you set the SelectCommand property of the DbDataAdapter. 설정 하지 않으면 추가적인 모든 SQL 문을에서 생성 된 후에 DbCommandBuilder합니다.Then, any additional SQL statements that you do not set are generated by the DbCommandBuilder.

합니다 DbCommandBuilder 자체에 대 한 수신기를 등록 RowUpdating 설정할 때마다 이벤트를 DataAdapter 속성입니다.The DbCommandBuilder registers itself as a listener for RowUpdating events whenever you set the DataAdapter property. 만 연결할 수 있습니다 DbDataAdapter 또는 DbCommandBuilder 서로 사용 하 여 개체를 한 번에 있습니다.You can only associate one DbDataAdapter or DbCommandBuilder object with each other at one time.

INSERT, UPDATE 또는 DELETE 문을 생성 하는 DbCommandBuilder 사용 하 여를 SelectCommand 메타 데이터의 집합을 자동으로 검색할 속성.To generate INSERT, UPDATE, or DELETE statements, the DbCommandBuilder uses the SelectCommand property to retrieve a required set of metadata automatically. 변경 하는 경우는 SelectCommand (예를 들어, 첫 번째 업데이트) 한 후 메타 데이터를 검색 한 후 호출 해야 합니다 RefreshSchema 메타 데이터를 업데이트 하는 방법입니다.If you change the SelectCommand after the metadata has been retrieved (for example, after the first update), you should call the RefreshSchema method to update the metadata.

또한 SelectCommand는 기본 키 열이나 고유 열을 하나 이상 반환해야 합니다.The SelectCommand must also return at least one primary key or unique column. 없는 경우는 InvalidOperationException 예외가 생성 되 고 명령은 생성 되지 않습니다.If none exist, an InvalidOperationException exception is generated, and the commands are not generated.

DbCommandBuilder 도 사용 합니다 Connection, CommandTimeout, 및 Transaction 속성에서 참조 하는 SelectCommand.The DbCommandBuilder also uses the Connection, CommandTimeout, and Transaction properties referenced by the SelectCommand. 호출 해야 합니다 RefreshSchema 이러한 속성을 수정 하는 경우 또는 경우는 SelectCommand 자체 바뀝니다.The user should call RefreshSchema if any of these properties are modified, or if the SelectCommand itself is replaced. 그렇지 않은 경우는 InsertCommand, UpdateCommand, 및 DeleteCommand 이전 값을 유지 하는 속성입니다.Otherwise the InsertCommand, UpdateCommand, and DeleteCommand properties retain their previous values.

호출 하는 경우 DisposeDbCommandBuilder 에서 분리를 DbDataAdapter, 및 생성된 된 명령을 더 이상 사용 합니다.If you call Dispose, the DbCommandBuilder is disassociated from the DbDataAdapter, and the generated commands are no longer used.

생성자

DbCommandBuilder() DbCommandBuilder() DbCommandBuilder() DbCommandBuilder()

DbCommandBuilder 클래스에서 상속하는 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of a class that inherits from the DbCommandBuilder class.

속성

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

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

(Inherited from Component)
CatalogLocation CatalogLocation CatalogLocation CatalogLocation

CatalogLocation 클래스의 인스턴스에 대한 DbCommandBuilder을 설정하거나 가져옵니다.Sets or gets the CatalogLocation for an instance of the DbCommandBuilder class.

CatalogSeparator CatalogSeparator CatalogSeparator CatalogSeparator

DbCommandBuilder 클래스의 인스턴스에 대한 카탈로그 구분 기호로 사용되는 문자열을 설정하거나 가져옵니다.Sets or gets a string used as the catalog separator for an instance of the DbCommandBuilder class.

ConflictOption ConflictOption ConflictOption ConflictOption

ConflictOption가 사용할 DbCommandBuilder을 지정합니다.Specifies which ConflictOption is to be used by the DbCommandBuilder.

Container Container Container Container

IContainer가 포함된 Component를 가져옵니다.Gets the IContainer that contains the Component.

(Inherited from Component)
DataAdapter DataAdapter DataAdapter DataAdapter

Transact-SQL 문을 자동으로 생성할 DbDataAdapter 개체를 가져오거나 설정합니다.Gets or sets a DbDataAdapter object for which Transact-SQL statements are automatically generated.

DesignMode DesignMode DesignMode DesignMode

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

(Inherited from Component)
Events Events Events Events

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

(Inherited from Component)
QuotePrefix QuotePrefix QuotePrefix QuotePrefix

이름에 공백 또는 예약된 토큰과 같은 문자가 포함된 데이터베이스 개체(예: 테이블 또는 열)를 지정할 때 사용할 시작 문자를 가져오거나 설정합니다.Gets or sets the beginning character or characters to use when specifying database objects (for example, tables or columns) whose names contain characters such as spaces or reserved tokens.

QuoteSuffix QuoteSuffix QuoteSuffix QuoteSuffix

이름에 공백 또는 예약된 토큰과 같은 문자가 포함된 데이터베이스 개체(예: 테이블 또는 열)를 지정할 때 사용할 끝 문자를 가져오거나 설정합니다.Gets or sets the ending character or characters to use when specifying database objects (for example, tables or columns) whose names contain characters such as spaces or reserved tokens.

SchemaSeparator SchemaSeparator SchemaSeparator SchemaSeparator

스키마 식별자와 다른 식별자 간의 구분 기호로 사용할 문자를 가져오거나 설정합니다.Gets or sets the character to be used for the separator between the schema identifier and any other identifiers.

SetAllValues SetAllValues SetAllValues SetAllValues

UPDATE 문에 모든 열 값이 포함되어 있는지 아니면 변경된 열 값만 포함되어 있는지를 지정합니다.Specifies whether all column values in an update statement are included or only changed ones.

Site Site Site Site

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

(Inherited from Component)

메서드

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean) ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean) ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean) ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)

DbCommandBuilder 클래스의 공급자 구현에서 추가 매개 변수 속성을 처리할 수 있도록 합니다.Allows the provider implementation of the DbCommandBuilder class to handle additional parameter properties.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

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

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

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

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

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

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetDeleteCommand() GetDeleteCommand() GetDeleteCommand() GetDeleteCommand()

데이터 소스에서 삭제하는 데 필요한 자동으로 생성된 DbCommand 개체를 가져옵니다.Gets the automatically generated DbCommand object required to perform deletions at the data source.

GetDeleteCommand(Boolean) GetDeleteCommand(Boolean) GetDeleteCommand(Boolean) GetDeleteCommand(Boolean)

선택적으로 매개 변수 이름에 열을 사용하여 데이터 소스에서 삭제하는 데 필요한 자동으로 생성된 DbCommand 개체를 가져옵니다.Gets the automatically generated DbCommand object required to perform deletions at the data source, optionally using columns for parameter names.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetInsertCommand() GetInsertCommand() GetInsertCommand() GetInsertCommand()

데이터 소스에서 삽입하는 데 필요한 자동으로 생성된 DbCommand 개체를 가져옵니다.Gets the automatically generated DbCommand object required to perform insertions at the data source.

GetInsertCommand(Boolean) GetInsertCommand(Boolean) GetInsertCommand(Boolean) GetInsertCommand(Boolean)

선택적으로 매개 변수 이름에 열을 사용하여 데이터 소스에서 삽입하는 데 필요한 자동으로 생성된 DbCommand 개체를 가져옵니다.Gets the automatically generated DbCommand object required to perform insertions at the data source, optionally using columns for parameter names.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

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

(Inherited from MarshalByRefObject)
GetParameterName(Int32) GetParameterName(Int32) GetParameterName(Int32) GetParameterName(Int32)

@p# 형식으로 지정된 매개 변수의 이름을 반환합니다.Returns the name of the specified parameter in the format of @p#. 사용자 지정 명령 작성기를 만들 때 사용합니다.Use when building a custom command builder.

GetParameterName(String) GetParameterName(String) GetParameterName(String) GetParameterName(String)

부분 매개 변수 이름이 제공된 경우 전체 매개 변수 이름을 반환합니다.Returns the full parameter name, given the partial parameter name.

GetParameterPlaceholder(Int32) GetParameterPlaceholder(Int32) GetParameterPlaceholder(Int32) GetParameterPlaceholder(Int32)

연결된 SQL 문에서 매개 변수의 자리 표시자를 반환합니다.Returns the placeholder for the parameter in the associated SQL statement.

GetSchemaTable(DbCommand) GetSchemaTable(DbCommand) GetSchemaTable(DbCommand) GetSchemaTable(DbCommand)

DbCommandBuilder의 스키마 테이블을 반환합니다.Returns the schema table for the DbCommandBuilder.

GetService(Type) GetService(Type) GetService(Type) GetService(Type)

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

(Inherited from Component)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
GetUpdateCommand() GetUpdateCommand() GetUpdateCommand() GetUpdateCommand()

데이터 소스에서 업데이트하는 데 필요한 자동으로 생성된 DbCommand 개체를 가져옵니다.Gets the automatically generated DbCommand object required to perform updates at the data source.

GetUpdateCommand(Boolean) GetUpdateCommand(Boolean) GetUpdateCommand(Boolean) GetUpdateCommand(Boolean)

선택적으로 매개 변수 이름에 열을 사용하여 데이터 소스에서 업데이트하는 데 필요한 자동으로 생성된 DbCommand 개체를 가져옵니다.Gets the automatically generated DbCommand object required to perform updates at the data source, optionally using columns for parameter names.

InitializeCommand(DbCommand) InitializeCommand(DbCommand) InitializeCommand(DbCommand) InitializeCommand(DbCommand)

CommandTimeout에 대한 Transaction, CommandType, UpdateRowSourceDbCommand 속성을 다시 설정합니다.Resets the CommandTimeout, Transaction, CommandType, and UpdateRowSource properties on the DbCommand.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

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

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
QuoteIdentifier(String) QuoteIdentifier(String) QuoteIdentifier(String) QuoteIdentifier(String)

올바른 카탈로그 대/소문자로 따옴표 붙지 않은 식별자가 제공되는 경우 따옴표 붙은 올바른 형식의 해당 식별자를 반환합니다. 여기에는 식별자에 포함된 모든 따옴표를 이스케이프하는 작업이 포함됩니다.Given an unquoted identifier in the correct catalog case, returns the correct quoted form of that identifier, including properly escaping any embedded quotes in the identifier.

RefreshSchema() RefreshSchema() RefreshSchema() RefreshSchema()

DbCommandBuilder와 연결된 명령을 지웁니다.Clears the commands associated with this DbCommandBuilder.

RowUpdatingHandler(RowUpdatingEventArgs) RowUpdatingHandler(RowUpdatingEventArgs) RowUpdatingHandler(RowUpdatingEventArgs) RowUpdatingHandler(RowUpdatingEventArgs)

RowUpdating 이벤트에 대한 이벤트 처리기를 추가합니다.Adds an event handler for the RowUpdating event.

SetRowUpdatingHandler(DbDataAdapter) SetRowUpdatingHandler(DbDataAdapter) SetRowUpdatingHandler(DbDataAdapter) SetRowUpdatingHandler(DbDataAdapter)

DbCommandBuilder에 대한 RowUpdating 이벤트를 처리하기 위해 DbDataAdapter를 등록합니다.Registers the DbCommandBuilder to handle the RowUpdating event for a DbDataAdapter.

ToString() ToString() ToString() ToString()

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

(Inherited from Component)
UnquoteIdentifier(String) UnquoteIdentifier(String) UnquoteIdentifier(String) UnquoteIdentifier(String)

따옴표 붙은 식별자가 제공되는 경우 따옴표 붙지 않은 올바른 형식의 해당 식별자를 반환합니다. 여기에는 식별자에 포함된 모든 따옴표를 이스케이프 해제하는 작업이 포함됩니다.Given a quoted identifier, returns the correct unquoted form of that identifier, including properly un-escaping any embedded quotes in the identifier.

이벤트

Disposed Disposed Disposed Disposed

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

(Inherited from Component)

적용 대상

추가 정보