LoadProperties 方法
擷取針對同步處理屬性儲存的所有值,然後將這些儲存的值填入 SqlCeReplication 類別屬性。
命名空間: System.Data.SqlServerCe
組件: System.Data.SqlServerCe (在 System.Data.SqlServerCe.dll 中)
語法
'宣告
Public Function LoadProperties As Boolean
'用途
Dim instance As SqlCeReplication
Dim returnValue As Boolean
returnValue = instance.LoadProperties()
public bool LoadProperties()
public:
bool LoadProperties()
member LoadProperties : unit -> bool
public function LoadProperties() : boolean
傳回值
備註
若要 LoadProperties 函數成功,必須提供所有的 SqlCeReplication 物件屬性,除非 SubscriberConnectionString 中指定的資料庫只擁有一個訂閱。如果資料庫只訂閱一個發行物,您可以省略下列屬性:
如果在未設定這些屬性的情況下呼叫 LoadProperties,且資料庫中有一個以上的訂閱,則會對資料庫中的每個訂閱引發錯誤。集合中的每個錯誤,都包含資料庫中每個訂閱之 Publisher、Publication 和 PublisherDatabase 屬性的字串參數。
呼叫 SaveProperties 時,密碼屬性的值會儲存在資料庫中。這些值會自動以唯一的裝置硬體機碼來加密。因此,如果在某個裝置 (或伺服器) 上建立訂閱設定檔,然後將資料庫複製到新裝置,LoadProperties 將無法從設定檔擷取密碼。您可以透過手動方式提供正確的密碼,然後再次呼叫 SaveProperties,以便在新裝置上保存設定檔。
範例
下列範例顯示如何使用 LoadProperties 方法。
Try
'
'NOTE: when possible, prompt users to enter security
'credentials at runtime. If you store credentials in a file,
'you must secure the file to prevent unauthorized access.
'
Dim repl As New SqlCeReplication()
repl.SubscriberConnectionString = "Data Source='Test.sdf'; Pwd='<enterStrongPassword>'"
repl.LoadProperties()
repl.Synchronize()
Catch
' Handle errors here
End Try
try
{
//NOTE: when possible, prompt users to enter security
//credentials at runtime. If you store credentials in a file,
//you must secure the file to prevent unauthorized access.
//
SqlCeReplication repl = new SqlCeReplication();
repl.SubscriberConnectionString = "Data Source='Test.sdf'; Pwd='<enterStrongPassword>'";
repl.LoadProperties();
repl.Synchronize();
}
catch (SqlCeException)
{
// Handle errors here
}