RelationalSyncProvider.ScopeName Property

Gets or sets the name of the scope to synchronize.

This property is not CLS-compliant.  

Namespace: Microsoft.Synchronization.Data
Assembly: Microsoft.Synchronization.Data (in microsoft.synchronization.data.dll)

Syntax

'Declaration
Public Overridable Property ScopeName As String
'Usage
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);
}

/** @property */
public String get_ScopeName ()

/** @property */
public void set_ScopeName (String value)

public function get ScopeName () : String

public function set ScopeName (value : String)

Property Value

The name of the scope, which is a set of objects to synchronize.

Remarks

For database synchronization, a scope is a set of tables. For more information about how scopes are used, see How to: Provision a Server Database for Collaborative Synchronization (Non-SQL Server) and How to: Configure and Execute Collaborative Synchronization (SQL Server).

Example

The following code example specifies the scope for a DbSyncProvider object in the SetupSyncProvider method that was created for this documentation. This method is used so that providers can be configured easily for multiple nodes. To view this code in the context of a complete example, see How to: Configure and Execute Collaborative Synchronization (Non-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"

The following code example specifies the scope for a SqlSyncProvider object by using the DbSyncScopeDescription object, rather than setting ScopeName directly. To view this code in the context of a complete example, see How to: Configure and Execute Collaborative Synchronization (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)

See Also

Reference

RelationalSyncProvider Class
RelationalSyncProvider Members
Microsoft.Synchronization.Data Namespace