OleDbCommandBuilder 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
自动生成用于协调对 DataSet 的更改与关联数据库的单表命令。 此类不能被继承。
public ref class OleDbCommandBuilder sealed : System::Data::Common::DbCommandBuilderpublic ref class OleDbCommandBuilder sealed : System::ComponentModel::Componentpublic sealed class OleDbCommandBuilder : System.Data.Common.DbCommandBuilderpublic sealed class OleDbCommandBuilder : System.ComponentModel.Componenttype OleDbCommandBuilder = class
inherit DbCommandBuildertype OleDbCommandBuilder = class
inherit ComponentPublic NotInheritable Class OleDbCommandBuilder
Inherits DbCommandBuilderPublic NotInheritable Class OleDbCommandBuilder
Inherits Component- 继承
- 继承
示例
以下示例使用 OleDbCommand、 和 OleDbDataAdapterOleDbConnection从数据源中选择行。 该示例传递了初始化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 语句。 但是，如果设置了 SelectCommand 的 属性，则可以创建对象OleDbCommandBuilder来自动生成单表更新的 OleDbDataAdapterSQL 语句。 然后，未设置的任何其他 SQL 语句都由 OleDbCommandBuilder生成。
每当设置 属性时， DataAdapter 会将OleDbCommandBuilder自身注册为事件的侦听器RowUpdating。 一次只能将一个 OleDbDataAdapter 或 OleDbCommandBuilder 对象相互关联。
若要生成 INSERT、UPDATE 或 DELETE 语句， OleDbCommandBuilder 使用 SelectCommand 属性自动检索所需的元数据集。 如果在检索元数据后（例如在第一次更新之后）更改 SelectCommand ，则应调用 RefreshSchema 方法来更新元数据。
还OleDbCommandBuilder使用 Connection引用的 SelectCommand、 CommandTimeout和 Transaction 属性。 如果修改了其中一个或多个属性，或者SelectCommand替换了自身，则用户应调用 RefreshSchema 。 否则， InsertCommandUpdateCommand和 DeleteCommand 属性将保留其以前的值。
如果调用 Dispose， OleDbCommandBuilder 则会取消与 OleDbDataAdapter的关联，并且不再使用生成的命令。
构造函数
| OleDbCommandBuilder() |
初始化 OleDbCommandBuilder 类的新实例。 |
| OleDbCommandBuilder(OleDbDataAdapter) |
使用关联的 OleDbCommandBuilder 对象初始化 OleDbDataAdapter 类的新实例。 |
属性
| CanRaiseEvents |
获取一个指示组件是否可以引发事件的值。 (继承自 Component) |
| CatalogLocation |
获取或设置 DbCommandBuilder 类的实例的 CatalogLocation。 (继承自 DbCommandBuilder) |
| CatalogSeparator |
获取或设置一个字符串，该字符串用作 DbCommandBuilder 类的实例的目录分隔符。 (继承自 DbCommandBuilder) |
| ConflictOption |
指定哪个 ConflictOption 将由 DbCommandBuilder 使用。 (继承自 DbCommandBuilder) |
| Container |
获取包含 IContainer 的 Component。 (继承自 Component) |
| DataAdapter |
获取或设置为其自动生成 SQL 语句的 OleDbDataAdapter 对象。 |
| DesignMode |
获取一个值，用以指示 Component 当前是否处于设计模式。 (继承自 Component) |
| Events |
获取附加到此 Component 的事件处理程序的列表。 (继承自 Component) |
| QuotePrefix |
获取或设置指定其名称包含空格或保留标记等字符的数据库对象（例如，表或列）时使用的开始字符。 |
| QuotePrefix |
获取或设置指定其名称包含空格或保留标记等字符的数据库对象（例如，表或列）时使用的开始字符。 (继承自 DbCommandBuilder) |
| QuoteSuffix |
获取或设置一个或多个结束字符，供指定其名称中包含空格或保留标记等字符的数据库对象（例如，表或列）时使用。 |
| QuoteSuffix |
获取或设置一个或多个结束字符，供指定其名称中包含空格或保留标记等字符的数据库对象（例如，表或列）时使用。 (继承自 DbCommandBuilder) |
| SchemaSeparator |
获取或设置要用作架构标识符和任何其他标识符之间的分隔符的字符。 (继承自 DbCommandBuilder) |
| SetAllValues |
指定 update 语句中是包含所有列值还是仅包含更改的列值。 (继承自 DbCommandBuilder) |
| Site | (继承自 Component) |
方法
事件
| Disposed |
在通过调用 Dispose() 方法释放组件时发生。 (继承自 Component) |
