学步园

整理几段操作 SQL Server Mobile 数据库的常用 C# 代码，供刚刚接触 SQL Server Mobile 开发的朋友参考。

1. 创建数据库
// 创建数据库
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);
}

3. 压缩数据库
// 压缩数据库
// 通过从现有文件新建数据库文件来回收 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();

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); [Page]

// 跟 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=;\");

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; [Page]
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 errs = 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)
            { [Page]
                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());
}