ProfileName 屬性 (複寫)
ProfileName 屬性會指定在散發者上要給 SQL Server Compact 3.5 訂閱者使用的合併代理程式設定檔的名稱。設定檔會定義各種行為,例如逾時值。您只要在散發者上建立設定檔,並用 ProfileName 指定為此檔案的名稱,便可覆寫預設值。
語法
object.ProfileName [= value]
適用於
SQL Server Compact 3.5 Replication 物件
參數
- value
代理程式設定檔名稱
資料類型
字串
可修改
讀取/寫入
原型
HRESULT get_ProfileName(BSTR *pVal);
HRESULT put_ProfileName(BSTR newVal);
備註
設定檔內含有控制 SQL Server Reconciler 行為的參數集。例如,設定檔內會指定給 SQL Server Reconciler 使用的 LoginTimeOut 與 QueryTimeOut 值。設定檔存放在散發者上。每次對訂閱進行同步處理時,就會讀取此設定檔。如需詳細資訊,請參閱《SQL Server 線上叢書》的<代理程式設定檔>。
此設定檔能讓您輕易地對所有訂閱者一併更改同步處理的金鑰參數,而不需要分別更改各訂閱者上的這些值。舉例來說,如果您有 5 個共用設定檔的 SQL Server Compact 3.5 用戶端,且您想要變更這 5 個用戶端的查詢逾時設定值,則您只要變更設定檔內的 QueryTimeOut 值,接著所有的 SQL Server Compact 3.5 用戶端就會使用這個新的 QueryTimeOut 設定值。
您也可以為不同的 SQL Server Compact 3.5 用戶端建立不同的設定檔。例如,某一個使用撥接網際網路連接的 SQL Server Compact 3.5 用戶端,可能採用一種逾時設定值,而另一個使用高速內部網路的用戶端可能就使用另一種逾時設定值。使用者便是利用 ProfileName 來指定設定檔的名稱。
如果未指定 ProfileName,則將會使用預設的設定檔值。
如果有指定 ProfileName,則設定檔內指定的 LoginTimeOut 和 QueryTimeOut 參數將會覆寫 Replication 物件所指定的 LoginTimeOut 與 QueryTimeOut 屬性值。