整理几段操作 SQL Server Mobile 数据库的常用 C# 代码,供刚刚接触 SQL Server Mobile 开发的朋友参考。
1. 创建数据库
2. 验证和修复数据库
3. 压缩数据库
5. 合并复制
6. 远程数据访问(RDA)
7. 使用 SqlCeResultSet
8. 处理 SqlCeException
参考:
SQL Server Mobile 2005 联机丛书
MSDN Library
1. 创建数据库
// 创建数据库
File.Delete("Test.sdf");
SqlCeEngine engine = new SqlCeEngine(
"Data Source='Test.sdf';LCID=1033;Password=\"s$;2'!dS64\";Encrypt=TRUE;");
engine.CreateDatabase();
File.Delete("Test.sdf");
SqlCeEngine engine = new SqlCeEngine(
"Data Source='Test.sdf';LCID=1033;Password=\"s$;2'!dS64\";Encrypt=TRUE;");
engine.CreateDatabase();
2. 验证和修复数据库
// 验证和修复数据库
SqlCeEngine engine = new SqlCeEngine("Data Source=AdventureWorks.sdf");
if (false == engine.Verify())
{
MessageBox.Show("Database is corrupted.");
engine.Repair(null, RepairOption.RecoverCorruptedRows);
}
SqlCeEngine engine = new SqlCeEngine("Data Source=AdventureWorks.sdf");
if (false == engine.Verify())
{
MessageBox.Show("Database is corrupted.");
engine.Repair(null, RepairOption.RecoverCorruptedRows);
}
3. 压缩数据库
// 压缩数据库
// 通过从现有文件新建数据库文件来回收 SQL Server Mobile 数据库中浪费的空间。
// 此方法还可用来更改数据库的排序顺序、加密或密码设置。
// 该连接字符串指定一个指向将由此方法创建的目标数据库的连接。
// 如果指定的数据库已经存在或者具有相同名称的另一文件已经存在,则会引发异常。
// 如果为连接字符串传递空字符串,则新的数据库文件将改写旧的数据库文件,
// 但名称保持不变。
SqlCeEngine engine = new SqlCeEngine("Data Source=AdventureWorks.sdf");
//engine.Compact(null);
engine.Compact("Data Source=; Password=a@3!7f$dQ;");
// 通过从现有文件新建数据库文件来回收 SQL Server Mobile 数据库中浪费的空间。
// 此方法还可用来更改数据库的排序顺序、加密或密码设置。
// 该连接字符串指定一个指向将由此方法创建的目标数据库的连接。
// 如果指定的数据库已经存在或者具有相同名称的另一文件已经存在,则会引发异常。
// 如果为连接字符串传递空字符串,则新的数据库文件将改写旧的数据库文件,
// 但名称保持不变。
SqlCeEngine engine = new SqlCeEngine("Data Source=AdventureWorks.sdf");
//engine.Compact(null);
engine.Compact("Data Source=; Password=a@3!7f$dQ;");
4. 收缩数据库
// 收缩数据库
// 通过将空页移动到文件的结尾然后截断该文件,
// 来回收 SQL Server Mobile 数据库中浪费的空间。
// 与 Compact 方法不同,Shrink 方法不创建临时数据库文件,
// 而是将所有空页和未分配的页都移到了文件的结尾,然后截断,从而减小数据库的总大小。
SqlCeEngine engine = new SqlCeEngine("Data Source=AdventureWorks.sdf");
engine.Shrink();
// 通过将空页移动到文件的结尾然后截断该文件,
// 来回收 SQL Server Mobile 数据库中浪费的空间。
// 与 Compact 方法不同,Shrink 方法不创建临时数据库文件,
// 而是将所有空页和未分配的页都移到了文件的结尾,然后截断,从而减小数据库的总大小。
SqlCeEngine engine = new SqlCeEngine("Data Source=AdventureWorks.sdf");
engine.Shrink();
5. 合并复制
// 合并复制
// 实例化并配置 SqlCeReplication 对象
SqlCeReplication repl = new SqlCeReplication();
repl.InternetUrl = "http://www.adventure-works.com/sqlmobile/sqlcesa30.dll";
repl.InternetLogin = "MyInternetLogin";
repl.InternetPassword = "<password>";
repl.Publisher = "MyPublisher";
repl.PublisherDatabase = "MyPublisherDatabase";
repl.PublisherLogin = "MyPublisherLogin";
repl.PublisherPassword = "<password>";
repl.Publication = "MyPublication";
repl.Subscriber = "MySubscriber";
repl.SubscriberConnectionString = "Data Source=MyDatabase.sdf";
// 创建一个本地 SQL Server Mobile 数据库的订阅
repl.AddSubscription(AddOption.CreateDatabase);
// 跟 SQL Server 数据库进行同步
repl.Synchronize();
// 清理 repl 对象
repl.Dispose();
// 实例化并配置 SqlCeReplication 对象
SqlCeReplication repl = new SqlCeReplication();
repl.InternetUrl = "http://www.adventure-works.com/sqlmobile/sqlcesa30.dll";
repl.InternetLogin = "MyInternetLogin";
repl.InternetPassword = "<password>";
repl.Publisher = "MyPublisher";
repl.PublisherDatabase = "MyPublisherDatabase";
repl.PublisherLogin = "MyPublisherLogin";
repl.PublisherPassword = "<password>";
repl.Publication = "MyPublication";
repl.Subscriber = "MySubscriber";
repl.SubscriberConnectionString = "Data Source=MyDatabase.sdf";
// 创建一个本地 SQL Server Mobile 数据库的订阅
repl.AddSubscription(AddOption.CreateDatabase);
// 跟 SQL Server 数据库进行同步
repl.Synchronize();
// 清理 repl 对象
repl.Dispose();
6. 远程数据访问(RDA)
// 远程数据访问
// 实例化并配置 SqlCeRemoteDataAccess 对象
SqlCeRemoteDataAccess rda = new SqlCeRemoteDataAccess();
rda.InternetUrl = "http://www.adventure-works.com/sqlmobile/sqlcesa30.dll";
rda.InternetLogin = "MyInternetLogin";
rda.InternetPassword = "<password>";
rda.LocalConnectionString = "Data Source=MyDatabase.sdf";
// 从 SQL Server 下载数据
rda.Pull(
"Employees",
"SELECT * FROM DimEmployee",
"Provider=sqloledb;server=MySqlServer;database=AdventureWorks;uid=sa;pwd=;",
RdaTrackOption.TrackingOnWithIndexes,
"ErrorTable");
//
// 修改本地数据
//
// 将已修改的数据上传到 SQL Server
rda.Push(
"DimEmployee",
"Provider=sqloledb;server=MySqlServer;database=AdventureWorks;uid=sa;pwd=;");
// 提交 SQL 语句在 SQL Server 上执行
rda.SubmitSql(
"CREATE TABLE MyRemoteTable (colA int)",
"Provider=sqloledb;server=MySqlServer;database=AdventureWorks;uid=sa;pwd=;");
// 实例化并配置 SqlCeRemoteDataAccess 对象
SqlCeRemoteDataAccess rda = new SqlCeRemoteDataAccess();
rda.InternetUrl = "http://www.adventure-works.com/sqlmobile/sqlcesa30.dll";
rda.InternetLogin = "MyInternetLogin";
rda.InternetPassword = "<password>";
rda.LocalConnectionString = "Data Source=MyDatabase.sdf";
// 从 SQL Server 下载数据
rda.Pull(
"Employees",
"SELECT * FROM DimEmployee",
"Provider=sqloledb;server=MySqlServer;database=AdventureWorks;uid=sa;pwd=;",
RdaTrackOption.TrackingOnWithIndexes,
"ErrorTable");
//
// 修改本地数据
//
// 将已修改的数据上传到 SQL Server
rda.Push(
"DimEmployee",
"Provider=sqloledb;server=MySqlServer;database=AdventureWorks;uid=sa;pwd=;");
// 提交 SQL 语句在 SQL Server 上执行
rda.SubmitSql(
"CREATE TABLE MyRemoteTable (colA int)",
"Provider=sqloledb;server=MySqlServer;database=AdventureWorks;uid=sa;pwd=;");
7. 使用 SqlCeResultSet
// 使用 SqlCeResultSet
// 创建 SQL Server Mobile 数据库连接
SqlCeConnection conn = new SqlCeConnection("Data Source=Northwind.sdf");
// 创建并配置 SqlCeCommand 对象
SqlCeCommand cmd = conn.CreateCommand();
cmd.CommandText = "SELECT * FROM Orders";
// 创建 SqlCeResultSet 对象,并配置为可滚动、可更新、检测数据源更改
ResultSetOptions options = ResultSetOptions.Scrollable |
ResultSetOptions.Sensitive |
ResultSetOptions.Updatable;
SqlCeResultSet resultSet = cmd.ExecuteResultSet(options);
// 创建 ResultSetView 对象,配置为只显示序号为 1,3,5,8 的列
ResultSetView resultSetView = resultSet.ResultSetView;
int[] ordinals = new int[] { 1,3,5,8};
resultSetView.Ordinals = ordinals;
// 将 ResultSetView 绑定到 DataGrid 控件
this.dataGrid.DataSource = resultSetView;
// 创建 SQL Server Mobile 数据库连接
SqlCeConnection conn = new SqlCeConnection("Data Source=Northwind.sdf");
// 创建并配置 SqlCeCommand 对象
SqlCeCommand cmd = conn.CreateCommand();
cmd.CommandText = "SELECT * FROM Orders";
// 创建 SqlCeResultSet 对象,并配置为可滚动、可更新、检测数据源更改
ResultSetOptions options = ResultSetOptions.Scrollable |
ResultSetOptions.Sensitive |
ResultSetOptions.Updatable;
SqlCeResultSet resultSet = cmd.ExecuteResultSet(options);
// 创建 ResultSetView 对象,配置为只显示序号为 1,3,5,8 的列
ResultSetView resultSetView = resultSet.ResultSetView;
int[] ordinals = new int[] { 1,3,5,8};
resultSetView.Ordinals = ordinals;
// 将 ResultSetView 绑定到 DataGrid 控件
this.dataGrid.DataSource = resultSetView;
8. 处理 SqlCeException
// 处理 SqlCeException
public static void ShowErrors(SqlCeException e)
{
SqlCeErrorCollection errorCollection = e.Errors;
StringBuilder bld = new StringBuilder();
Exception inner = e.InnerException;
foreach (SqlCeError err in errs)
{
// 标识错误类型的 HRESULT 值,这些错误不是 SQL Server CE 固有的
bld.Append("\r\nError Code: ").Append(err.HResult.ToString("X"));
// 对错误进行描述的文本
bld.Append("\r\nMessage: ").Append(err.Message);
// 获取 SqlCeError 的本机错误号
bld.Append("\r\nMinor Err.: ").Append(err.NativeError);
// 生成错误的提供程序的名称
bld.Append("\r\nSource: ").Append(err.Source);
// 遍历前三个错误参数。SQL Server CE 使用错误参数来提供有关错误的其他详细信息。
foreach (int numPara in err.NumericErrorParameters)
{
// 虽然错误可能存在参数,但并非发生的所有错误都返回参数。
// 如果发生某个错误时没有返回任何参数,则该数组的值为 0。
if (numPara != 0)
{
bld.Append("\r\nNum. Par.: ").Append(numPara);
}
}
// 遍历最后三个错误参数。SQL Server CE 使用错误参数来提供有关错误的其他详细信息。
foreach (string errPara in err.ErrorParameters)
{
// 虽然错误可能存在参数,但并非发生的所有错误都返回参数。
// 如果发生某个错误时没有返回任何参数,则该数组的值将为空字符串。
if (errPara != String.Empty)
{
bld.Append("\r\nErr. Par.: ").Append(errPara);
}
}
}
MessageBox.Show(bld.ToString());
}
public static void ShowErrors(SqlCeException e)
{
SqlCeErrorCollection errorCollection = e.Errors;
StringBuilder bld = new StringBuilder();
Exception inner = e.InnerException;
foreach (SqlCeError err in errs)
{
// 标识错误类型的 HRESULT 值,这些错误不是 SQL Server CE 固有的
bld.Append("\r\nError Code: ").Append(err.HResult.ToString("X"));
// 对错误进行描述的文本
bld.Append("\r\nMessage: ").Append(err.Message);
// 获取 SqlCeError 的本机错误号
bld.Append("\r\nMinor Err.: ").Append(err.NativeError);
// 生成错误的提供程序的名称
bld.Append("\r\nSource: ").Append(err.Source);
// 遍历前三个错误参数。SQL Server CE 使用错误参数来提供有关错误的其他详细信息。
foreach (int numPara in err.NumericErrorParameters)
{
// 虽然错误可能存在参数,但并非发生的所有错误都返回参数。
// 如果发生某个错误时没有返回任何参数,则该数组的值为 0。
if (numPara != 0)
{
bld.Append("\r\nNum. Par.: ").Append(numPara);
}
}
// 遍历最后三个错误参数。SQL Server CE 使用错误参数来提供有关错误的其他详细信息。
foreach (string errPara in err.ErrorParameters)
{
// 虽然错误可能存在参数,但并非发生的所有错误都返回参数。
// 如果发生某个错误时没有返回任何参数,则该数组的值将为空字符串。
if (errPara != String.Empty)
{
bld.Append("\r\nErr. Par.: ").Append(errPara);
}
}
}
MessageBox.Show(bld.ToString());
}
参考:
SQL Server Mobile 2005 联机丛书
MSDN Library