共用方式為

ScopeName 屬性

  • 發行項

取得或設定要同步處理之範圍的名稱。

命名空間：  Microsoft.Synchronization.Data
組件：  Microsoft.Synchronization.Data (在 Microsoft.Synchronization.Data.dll 中)

語法

'宣告
Public Overridable Property ScopeName As String
    Get
    Set
'用途
Dim instance As RelationalSyncProvider
Dim value As String

value = instance.ScopeName

instance.ScopeName = value

public virtual string ScopeName { get; set; }

public:
virtual property String^ ScopeName {
    String^ get ();
    void set (String^ value);
}

abstract ScopeName : string with get, set
override ScopeName : string with get, set

function get ScopeName () : String
function set ScopeName (value : String)

屬性值

型別：System. . :: . .String
範圍的名稱，這個範圍是一組要同步處理的物件。

例外

例外狀況 條件
ObjectDisposedException

這個 RelationalSyncProvider 已被處置。
ArgumentNullException

value 是 null Nothing nullptr unit null 參考 (在 Visual Basic 中為 Nothing) 。

備註

就資料庫同步處理而言，範圍是一組資料表。如需如何使用範圍的詳細資訊，請參閱 HOW TO：佈建伺服器資料庫來進行共同作業同步處理 (非 SQL Server) 和 HOW TO：設定及執行資料庫同步處理 (SQL Server)。

範例

下列程式碼範例會指定 DbSyncProvider 物件的範圍，此物件在特別為本文件建立的 SetupSyncProvider 方法中。使用此方法，是為了能夠輕鬆為多個節點設定提供者。若要在完整範例的內容中檢視這段程式碼，請參閱 HOW TO：設定及執行共同作業同步處理 (非 SQL Server)。

SqlConnection peerConnection = new SqlConnection(peerConnString);
sampleProvider.Connection = peerConnection;
sampleProvider.ScopeName = "Sales";

Dim peerConnection As New SqlConnection(peerConnString)
sampleProvider.Connection = peerConnection
sampleProvider.ScopeName = "Sales"

下列程式碼範例是使用 DbSyncScopeDescription 物件來指定 SqlSyncProvider 物件的範圍，而不是直接設定 ScopeName。若要在完整範例的內容中檢視這段程式碼，請參閱 HOW TO：設定及執行資料庫同步處理 (SQL Server)。

DbSyncScopeDescription scopeDesc = new DbSyncScopeDescription("filtered_customer");

// Definition for Customer.
DbSyncTableDescription customerDescription =
    SqlSyncDescriptionBuilder.GetDescriptionForTable("Sales.Customer", serverConn);

scopeDesc.Tables.Add(customerDescription);

// Definition for CustomerContact, including the list of columns to include.
Collection<string> columnsToInclude = new Collection<string>();
columnsToInclude.Add("CustomerId");
columnsToInclude.Add("PhoneType");
DbSyncTableDescription customerContactDescription =
    SqlSyncDescriptionBuilder.GetDescriptionForTable("Sales.CustomerContact", columnsToInclude, serverConn);

scopeDesc.Tables.Add(customerContactDescription);

Dim scopeDesc As New DbSyncScopeDescription("filtered_customer")

' Definition for Customer. 
Dim customerDescription As DbSyncTableDescription = _
    SqlSyncDescriptionBuilder.GetDescriptionForTable("Sales.Customer", serverConn)

scopeDesc.Tables.Add(customerDescription)


' Definition for CustomerContact, including the list of columns to include. 
Dim columnsToInclude As New Collection(Of String)()
columnsToInclude.Add("CustomerId")
columnsToInclude.Add("PhoneType")
Dim customerContactDescription As DbSyncTableDescription = _
    SqlSyncDescriptionBuilder.GetDescriptionForTable("Sales.CustomerContact", columnsToInclude, serverConn)

scopeDesc.Tables.Add(customerContactDescription)

請參閱

參考

RelationalSyncProvider類別

RelationalSyncProvider 成員

Microsoft.Synchronization.Data 命名空間