整理幾段操作 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 資料庫中浪費的空間。
// 此方法還可用來更改資料庫的排序次序、加密或密碼設定。
// 該連接字串指定一個指向將由此方法建立的目標資料庫的串連。
// 如果指定的資料庫已經存在或者具有相同名稱的另一檔案已經存在,則會引發異常。
// 如果為連接字串傳遞Null 字元串,則新的資料庫檔案將改寫舊的資料庫檔案,
// 但名稱保持不變。
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);
// 跟 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;
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());
}