Partager via


ScopeName propriété

Obtient ou définit le nom de l'étendue à synchroniser.

Espace de noms :  Microsoft.Synchronization.Data
Assembly :  Microsoft.Synchronization.Data (dans Microsoft.Synchronization.Data.dll)

Syntaxe

'Déclaration
Public Overridable Property ScopeName As String
    Get
    Set
'Utilisation
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)

Valeur de la propriété

Type : System. . :: . .String
Nom de l'étendue, qui est un ensemble d'objets à synchroniser.

Exceptions

Exception Condition
ObjectDisposedException

Cet objet RelationalSyncProvider est supprimé.

ArgumentNullException

value est une null Nothing nullptr unit une référence Null (Nothing dans Visual Basic) .

Notes

Pour la synchronisation de bases de données, une étendue est un ensemble de tables. Pour plus d'informations sur l'utilisation des étendues, consultez Procédure : approvisionner une base de données serveur pour la synchronisation collaborative (non-SQL Server) et Procédure : configurer et exécuter la synchronisation de bases de données (SQL Server).

Exemples

L'exemple de code suivant spécifie l'étendue pour un objet DbSyncProvider dans la méthode SetupSyncProvider qui a été créée pour cette documentation. Cette méthode est utilisée afin que les fournisseurs puissent être aisément configurés pour plusieurs nœuds. Pour afficher ce code dans le contexte d'un exemple complet, consultez Procédure : configurer et exécuter la synchronisation collaborative (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"

L'exemple de code suivant spécifie l'étendue pour un objet SqlSyncProvider en utilisant l'objet DbSyncScopeDescription, plutôt qu'en définissant ScopeName directement. Pour afficher ce code dans le contexte d'un exemple complet, consultez Procédure : configurer et exécuter la synchronisation de bases de données (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)

Voir aussi

Référence

RelationalSyncProvider Classe

Membres RelationalSyncProvider

Espace de noms Microsoft.Synchronization.Data