OleDbCommandBuilder 클래스

정의

네임스페이스:

System.Data.OleDb

어셈블리:

System.Data.OleDb.dll

패키지:

System.Data.OleDb v11.0.0-preview.2.26159.112

Source:

OleDbCommandBuilder.cs

연결된 데이터베이스에 대한 변경 내용을 DataSet 조정하는 데 사용되는 단일 테이블 명령을 자동으로 생성합니다. 이 클래스는 상속할 수 없습니다.

public ref class OleDbCommandBuilder sealed : System::Data::Common::DbCommandBuilder

public sealed class OleDbCommandBuilder : System.Data.Common.DbCommandBuilder

type OleDbCommandBuilder = class
    inherit DbCommandBuilder

Public NotInheritable Class OleDbCommandBuilder
Inherits DbCommandBuilder

상속

Object

MarshalByRefObject

Component

DbCommandBuilder

OleDbCommandBuilder

예제

다음 예제에서는 데이터 원본에서 행을 선택하기 위해 함께 OleDbDataAdapterOleDbConnection및 를 사용합니다OleDbCommand. 이 예제는 초기화된 DataSet문자열, 연결 문자열, SQL SELECT 문인 쿼리 문자열 및 데이터 원본 테이블의 이름인 문자열을 전달합니다. 그런 다음 이 예제에서는 .를 OleDbCommandBuilder만듭니다.

public static DataSet UpdateRows(string connectionString,
    string queryString, string tableName)
{
    DataSet dataSet = new DataSet();
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString, connection);
        OleDbCommandBuilder cb = new OleDbCommandBuilder(adapter);

        connection.Open();

        adapter.Fill(dataSet, tableName);

        //code to modify data in DataSet here

        cb.GetDeleteCommand();
        //Without the OleDbCommandBuilder this line would fail
        adapter.Update(dataSet, tableName);

        connection.Close();
    }
    return dataSet;
}

Public Shared Function UpdateRows(ByVal connectionString As String, _
ByVal queryString As String, ByVal tableName As String) As DataSet

    Dim dataSet As New DataSet()

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString, connection)
        Dim builder As New OleDbCommandBuilder(adapter)

        connection.Open()

        adapter.Fill(dataSet, tableName)

        ' Code to modify data in DataSet here 

        builder.GetUpdateCommand()

        ' Without the OleDbCommandBuilder this line would fail.
        adapter.Update(dataSet, tableName)
    End Using

    Return dataSet
End Function

설명

OleDbDataAdapter 연결된 데이터 원본과 변경 내용을 DataSet 조정하는 데 필요한 SQL 문을 자동으로 생성하지는 않습니다. 그러나 개체를 OleDbCommandBuilder 만들어 단일 테이블 업데이트 SelectCommand 에 대한 SQL 문을 자동으로 생성할 수 있습니다.OleDbDataAdapter 그런 다음, 설정하지 않은 추가 SQL 문은 .에 OleDbCommandBuilder의해 생성됩니다.

속성을 OleDbCommandBuilder 설정할 때마다 이벤트에 대한 RowUpdating 수신기로 등록됩니다 DataAdapter . 한 번에 하나 OleDbDataAdapter 또는 OleDbCommandBuilder 개체를 서로 연결할 수 있습니다.

INSERT, UPDATE 또는 DELETE 문을 OleDbCommandBuilder 생성하려면 이 속성을 사용하여 SelectCommand 필요한 메타데이터 집합을 자동으로 검색합니다. 메타데이터를 SelectCommand 검색한 후(예: 첫 번째 업데이트 후)를 변경하는 경우 메서드를 RefreshSchema 호출하여 메타데이터를 업데이트해야 합니다.

또한 .OleDbCommandBuilder에서 참조SelectCommand하는 Connection, CommandTimeout및 Transaction 속성을 사용합니다. 사용자는 이러한 속성 중 하나 이상이 수정되거나 자체 속성이 바뀐 경우 SelectCommand 호출 RefreshSchema 해야 합니다. 그렇지 않으면 , UpdateCommand및 DeleteCommand 속성은 InsertCommand이전 값을 유지합니다.

호출 DisposeOleDbCommandBuilder 하면 해당 명령이 해당 명령과 OleDbDataAdapter연결되지 않으며 생성된 명령은 더 이상 사용되지 않습니다.

생성자

Name	Description
OleDbCommandBuilder()	OleDbCommandBuilder 클래스의 새 인스턴스를 초기화합니다.
OleDbCommandBuilder(OleDbDataAdapter)	연결된 OleDbDataAdapter 개체를 사용하여 클래스의 OleDbCommandBuilder 새 인스턴스를 초기화합니다.

속성

Name	Description
DataAdapter	SQL 문이 자동으로 생성되는 개체를 가져오거나 설정합니다 OleDbDataAdapter .

메서드

Name	Description
DeriveParameters(OleDbCommand)	에 지정된 OleDbCommand 저장 프로시저에서 매개 변수 정보를 검색하고 지정된 OleDbCommand 개체의 Parameters 컬렉션을 채웁니다.
GetDeleteCommand()	데이터 원본에서 삭제를 수행하는 데 필요한 자동으로 생성된 OleDbCommand 개체를 가져옵니다.
GetDeleteCommand(Boolean)	데이터 원본에서 삭제를 수행하는 데 필요한 자동으로 생성된 OleDbCommand 개체를 가져옵니다.
GetInsertCommand()	데이터 원본에서 삽입을 수행하는 데 필요한 자동으로 생성된 OleDbCommand 개체를 가져옵니다.
GetInsertCommand(Boolean)	데이터 원본에서 삽입을 수행하는 데 필요한 자동으로 생성된 OleDbCommand 개체를 가져옵니다.
GetUpdateCommand()	데이터 원본에서 업데이트를 수행하는 데 필요한 자동으로 생성된 OleDbCommand 개체를 가져옵니다.
GetUpdateCommand(Boolean)	선택적으로 매개 변수 이름에 열을 사용하여 데이터 원본에서 업데이트를 수행하는 데 필요한 자동으로 생성된 OleDbCommand 개체를 가져옵니다.
QuoteIdentifier(String, OleDbConnection)	올바른 카탈로그 사례에서 따옴표가 지정되지 않은 식별자가 지정된 경우 해당 식별자의 올바른 따옴표 붙은 형식을 반환합니다. 여기에는 식별자에 포함된 따옴표를 올바르게 이스케이프하는 것이 포함됩니다.
QuoteIdentifier(String)	올바른 카탈로그 사례에서 따옴표가 지정되지 않은 식별자가 지정된 경우 해당 식별자의 올바른 따옴표 붙은 형식을 반환합니다. 여기에는 식별자에 포함된 따옴표를 올바르게 이스케이프하는 것이 포함됩니다.
UnquoteIdentifier(String, OleDbConnection)	따옴표 붙은 식별자를 지정하면 해당 식별자의 올바른 따옴표가 지정되지 않은 형식을 반환합니다. 여기에는 식별자에 포함된 따옴표를 올바르게 이스케이프 해제하는 것이 포함됩니다.
UnquoteIdentifier(String)	따옴표 붙은 식별자를 지정하면 해당 식별자의 올바른 따옴표가 지정되지 않은 형식을 반환합니다. 여기에는 식별자에 포함된 따옴표를 올바르게 이스케이프 해제하는 것이 포함됩니다.

추가 정보

• CommandBuilders를 사용하여 명령 생성