「msdn」SqlCommandBuilder 类
2007-03-06 15:57
309 查看
SqlCommandBuilder 类
SqlCommandBuilder 构造函数
请参见
初始化 SqlCommandBuilder 类的新实例。
重载列表
初始化 SqlCommandBuilder 类的新实例。
受 .NET Framework 精简版的支持。
[Visual Basic] Public Sub New()
[C#] public SqlCommandBuilder();
[C++] public: SqlCommandBuilder();
[JScript] public function SqlCommandBuilder();
使用关联的 SqlDataAdapter 对象初始化 SqlCommandBuilder 类的新实例。
受 .NET Framework 精简版的支持。
[Visual Basic] Public Sub New(SqlDataAdapter)
[C#] public SqlCommandBuilder(SqlDataAdapter);
[C++] public: SqlCommandBuilder(SqlDataAdapter*);
[JScript] public function SqlCommandBuilder(SqlDataAdapter);
请参见
命名空间: System.Data.SqlClient
平台: Windows 98, Windows NT 4.0, Windows ME, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 系列, .NET Framework 精简版 - Windows CE .NET
程序集: System.Data (在 System.Data.dll 中)
自动生成具有以下用途的单表命令:使对 DataSet 所做的更改与关联的 SQL Server 数据库相协调。不能继承此类。
有关此类型所有成员的列表,请参阅 SqlCommandBuilder 成员。
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Data.SqlClient.SqlCommandBuilder
[Visual Basic]
NotInheritable Public Class SqlCommandBuilder
Inherits Component
[C#]
public sealed class SqlCommandBuilder : Component
此类型的所有公共静态(Visual Basic 中为 Shared)成员对多线程操作而言都是安全的。但不保证任何实例成员是线程安全的。
备注
SqlDataAdapter 不会自动生成实现 DataSet 的更改与关联的 SQL Server 实例之间的协调所需的 Transact-SQL 语句。但是,如果设置了 SqlDataAdapter 的 SelectCommand 属性,则可以创建一个 SqlCommandBuilder 对象来自动生成用于单表更新的 Transact-SQL 语句。然后,SqlCommandBuilder 将生成其他任何未设置的 Transact-SQL 语句。
一旦设置 DataAdapter 属性,SqlCommandBuilder 就将其自身注册为 RowUpdating 事件的侦听器。一次只能将一个 SqlDataAdapter 与一个 SqlCommandBuilder 对象(或相反)互相关联。
为了生成 INSERT、UPDATE 或 DELETE 语句,SqlCommandBuilder 会自动使用 SelectCommand 属性来检索所需的元数据集。如果在检索元数据后(例如在第一次更新后)更改 SelectCommand,则应调用 RefreshSchema 方法来更新元数据。
SelectCommand 还必须至少返回一个主键列或唯一的列。如果什么都没有返回,就会产生 InvalidOperation 异常,不生成命令。
SqlCommandBuilder 还使用由 SelectCommand 引用的 Connection、CommandTimeout 和 Transaction 属性。如果修改了任何这些属性或者替换了 SelectCommand 本身,用户则应调用 RefreshSchema。否则,InsertCommand、UpdateCommand 和 DeleteCommand 属性将保留它们以前的值。
如果调用 Dispose,则会解除 SqlCommandBuilder 与 SqlDataAdapter 的关联,并且不再使用所生成的命令。
示例
[Visual Basic, C#, C++] 下面的示例使用 SqlCommand 以及 SqlDataAdapter 和 SqlConnection 从数据源选择行。给该示例传递一个初始化的 DataSet、一个连接字符串、一个查询字符串(它是一个 Transact-SQL SELECT 语句)和一个包含数据库表名称的字符串。然后该示例创建一个 SqlCommandBuilder。
[Visual Basic]
Public Shared Function SelectSqlSrvRows(myConnection As String, mySelectQuery As String, myTableName As String) As DataSet
Dim myConn As New SqlConnection(myConnection)
Dim myDataAdapter As New SqlDataAdapter()
myDataAdapter.SelectCommand = New SqlCommand(mySelectQuery, myConn)
Dim cb As SqlCommandBuilder = New SqlCommandBuilder(myDataAdapter)
myConn.Open()
Dim ds As DataSet = New DataSet
myDataAdapter.Fill(ds, myTableName)
' Code to modify data in DataSet here
' Without the SqlCommandBuilder this line would fail.
myDataAdapter.Update(ds, myTableName)
myConn.Close()
End Function 'SelectSqlSrvRows
[C#]
public static DataSet SelectSqlSrvRows(string myConnection, string mySelectQuery, string myTableName)
{
SqlConnection myConn = new SqlConnection(myConnection);
SqlDataAdapter myDataAdapter = new SqlDataAdapter();
myDataAdapter.SelectCommand = new SqlCommand(mySelectQuery, myConn);
SqlCommandBuilder cb = new SqlCommandBuilder(myDataAdapter);
myConn.Open();
DataSet ds = new DataSet();
myDataAdapter.Fill(ds, myTableName);
//code to modify data in DataSet here
//Without the SqlCommandBuilder this line would fail
myDataAdapter.Update(ds, myTableName);
myConn.Close();
return ds;
}
[C++]
public:
static DataSet* SelectSqlSrvRows(String* myConnection, String* mySelectQuery, String* myTableName)
{
SqlConnection* myConn = new SqlConnection(myConnection);
SqlDataAdapter* myDataAdapter = new SqlDataAdapter();
myDataAdapter->SelectCommand = new SqlCommand(mySelectQuery, myConn);
SqlCommandBuilder* cb = new SqlCommandBuilder(myDataAdapter);
myConn->Open();
DataSet* ds = new DataSet();
myDataAdapter->Fill(ds, myTableName);
//code to modify data in DataSet here
//With->Item[Out] the* SqlCommandBuilder this line would fail
myDataAdapter->Update(ds, myTableName);
myConn->Close();
return ds;
};
[JScript] 没有可用于 JScript 的示例。若要查看 Visual Basic、C# 或 C++ 示例,请单击页左上角的“语言筛选器”按钮 。
要求
命名空间: System.Data.SqlClient
平台: Windows 98, Windows NT 4.0, Windows ME, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 系列, .NET Framework 精简版 - Windows CE .NET
程序集: System.Data (在 System.Data.dll 中)
请参见
SqlCommandBuilder 成员 | System.Data.SqlClient 命名空间 | 代码:使用 CommandBuilder 创建 DataCommands (Visual Basic) | SqlCommandBuilder 成员(Visual J# 语法) | C++ 托管扩展编程
发送有关此主题的意见
© 2001-2002 Microsoft Corporation。保留所有权利。
SqlCommandBuilder 构造函数
请参见
初始化 SqlCommandBuilder 类的新实例。
重载列表
初始化 SqlCommandBuilder 类的新实例。
受 .NET Framework 精简版的支持。
[Visual Basic] Public Sub New()
[C#] public SqlCommandBuilder();
[C++] public: SqlCommandBuilder();
[JScript] public function SqlCommandBuilder();
使用关联的 SqlDataAdapter 对象初始化 SqlCommandBuilder 类的新实例。
受 .NET Framework 精简版的支持。
[Visual Basic] Public Sub New(SqlDataAdapter)
[C#] public SqlCommandBuilder(SqlDataAdapter);
[C++] public: SqlCommandBuilder(SqlDataAdapter*);
[JScript] public function SqlCommandBuilder(SqlDataAdapter);
请参见
命名空间: System.Data.SqlClient
平台: Windows 98, Windows NT 4.0, Windows ME, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 系列, .NET Framework 精简版 - Windows CE .NET
程序集: System.Data (在 System.Data.dll 中)
自动生成具有以下用途的单表命令:使对 DataSet 所做的更改与关联的 SQL Server 数据库相协调。不能继承此类。
有关此类型所有成员的列表,请参阅 SqlCommandBuilder 成员。
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Data.SqlClient.SqlCommandBuilder
[Visual Basic]
NotInheritable Public Class SqlCommandBuilder
Inherits Component
[C#]
public sealed class SqlCommandBuilder : Component
[C++] [b]public __gc __sealed class SqlCommandBuilder : public Component
[JScript] public class SqlCommandBuilder extends Component线[/b]程安全
此类型的所有公共静态(Visual Basic 中为 Shared)成员对多线程操作而言都是安全的。但不保证任何实例成员是线程安全的。
备注
SqlDataAdapter 不会自动生成实现 DataSet 的更改与关联的 SQL Server 实例之间的协调所需的 Transact-SQL 语句。但是,如果设置了 SqlDataAdapter 的 SelectCommand 属性,则可以创建一个 SqlCommandBuilder 对象来自动生成用于单表更新的 Transact-SQL 语句。然后,SqlCommandBuilder 将生成其他任何未设置的 Transact-SQL 语句。
一旦设置 DataAdapter 属性,SqlCommandBuilder 就将其自身注册为 RowUpdating 事件的侦听器。一次只能将一个 SqlDataAdapter 与一个 SqlCommandBuilder 对象(或相反)互相关联。
为了生成 INSERT、UPDATE 或 DELETE 语句,SqlCommandBuilder 会自动使用 SelectCommand 属性来检索所需的元数据集。如果在检索元数据后(例如在第一次更新后)更改 SelectCommand,则应调用 RefreshSchema 方法来更新元数据。
SelectCommand 还必须至少返回一个主键列或唯一的列。如果什么都没有返回,就会产生 InvalidOperation 异常,不生成命令。
SqlCommandBuilder 还使用由 SelectCommand 引用的 Connection、CommandTimeout 和 Transaction 属性。如果修改了任何这些属性或者替换了 SelectCommand 本身,用户则应调用 RefreshSchema。否则,InsertCommand、UpdateCommand 和 DeleteCommand 属性将保留它们以前的值。
如果调用 Dispose,则会解除 SqlCommandBuilder 与 SqlDataAdapter 的关联,并且不再使用所生成的命令。
示例
[Visual Basic, C#, C++] 下面的示例使用 SqlCommand 以及 SqlDataAdapter 和 SqlConnection 从数据源选择行。给该示例传递一个初始化的 DataSet、一个连接字符串、一个查询字符串(它是一个 Transact-SQL SELECT 语句)和一个包含数据库表名称的字符串。然后该示例创建一个 SqlCommandBuilder。
[Visual Basic]
Public Shared Function SelectSqlSrvRows(myConnection As String, mySelectQuery As String, myTableName As String) As DataSet
Dim myConn As New SqlConnection(myConnection)
Dim myDataAdapter As New SqlDataAdapter()
myDataAdapter.SelectCommand = New SqlCommand(mySelectQuery, myConn)
Dim cb As SqlCommandBuilder = New SqlCommandBuilder(myDataAdapter)
myConn.Open()
Dim ds As DataSet = New DataSet
myDataAdapter.Fill(ds, myTableName)
' Code to modify data in DataSet here
' Without the SqlCommandBuilder this line would fail.
myDataAdapter.Update(ds, myTableName)
myConn.Close()
End Function 'SelectSqlSrvRows
[C#]
public static DataSet SelectSqlSrvRows(string myConnection, string mySelectQuery, string myTableName)
{
SqlConnection myConn = new SqlConnection(myConnection);
SqlDataAdapter myDataAdapter = new SqlDataAdapter();
myDataAdapter.SelectCommand = new SqlCommand(mySelectQuery, myConn);
SqlCommandBuilder cb = new SqlCommandBuilder(myDataAdapter);
myConn.Open();
DataSet ds = new DataSet();
myDataAdapter.Fill(ds, myTableName);
//code to modify data in DataSet here
//Without the SqlCommandBuilder this line would fail
myDataAdapter.Update(ds, myTableName);
myConn.Close();
return ds;
}
[C++]
public:
static DataSet* SelectSqlSrvRows(String* myConnection, String* mySelectQuery, String* myTableName)
{
SqlConnection* myConn = new SqlConnection(myConnection);
SqlDataAdapter* myDataAdapter = new SqlDataAdapter();
myDataAdapter->SelectCommand = new SqlCommand(mySelectQuery, myConn);
SqlCommandBuilder* cb = new SqlCommandBuilder(myDataAdapter);
myConn->Open();
DataSet* ds = new DataSet();
myDataAdapter->Fill(ds, myTableName);
//code to modify data in DataSet here
//With->Item[Out] the* SqlCommandBuilder this line would fail
myDataAdapter->Update(ds, myTableName);
myConn->Close();
return ds;
};
[JScript] 没有可用于 JScript 的示例。若要查看 Visual Basic、C# 或 C++ 示例,请单击页左上角的“语言筛选器”按钮 。
要求
命名空间: System.Data.SqlClient
平台: Windows 98, Windows NT 4.0, Windows ME, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 系列, .NET Framework 精简版 - Windows CE .NET
程序集: System.Data (在 System.Data.dll 中)
请参见
SqlCommandBuilder 成员 | System.Data.SqlClient 命名空间 | 代码:使用 CommandBuilder 创建 DataCommands (Visual Basic) | SqlCommandBuilder 成员(Visual J# 语法) | C++ 托管扩展编程
发送有关此主题的意见
© 2001-2002 Microsoft Corporation。保留所有权利。
相关文章推荐
- C#中SqlCommandBuilder批量数据增加修改
- 用SqlCommandBuilder 实现批量更新
- 用SqlCommandBuilder 实现批量更新
- 用SqlCommandBuilder 实现批量更新
- SqlDataAdapter.Update()方法与SqlCommandBuilder(转)
- SqlCommandBuilder 实现批量更新
- asp.net中使用sqlcommandbuilder
- asp.net 中使用sqlcommandbuilder
- 简单的运用SqlCommandBuilder
- 用SqlCommandBuilder 实现批量更新
- 用SqlCommandBuilder 实现批量更新
- SqlCommandBuilder如何实现批量更新
- asp.net中使用sqlcommandbuilder (转)
- .net 用SqlCommandBuilder 实现数据库批量更新
- SqlCommandBuilder实现大数据更新
- (2009-06-24) SqlCommandBuilder使用的注意事项 助睡眠音乐
- SqlCommandBuilder 小示例
- sqlCommandBuilder自动创建dataAdapter数据库操作命令
- DataSet SqlCommandBuilder添加修改删除数据
- SqlCommandBuilder 的使用