Freigeben über


ScopeName-Eigenschaft

Ruft den Namen des zu synchronisierenden Bereichs ab oder legt diesen fest.

Namespace:  Microsoft.Synchronization.Data
Assembly:  Microsoft.Synchronization.Data (in Microsoft.Synchronization.Data.dll)

Syntax

'Declaration
Public Overridable Property ScopeName As String
    Get
    Set
'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);
}
abstract ScopeName : string with get, set
override ScopeName : string with get, set
function get ScopeName () : String
function set ScopeName (value : String)

Eigenschaftenwert

Typ: System. . :: . .String
Der Name des Bereichs, der einer Gruppe zu synchronisierender Objekte entspricht.

Ausnahmen

Ausnahme Bedingung
ObjectDisposedException

RelationalSyncProvider wird gelöscht.

ArgumentNullException

value ist NULL.

Hinweise

Bei Datenbanksynchronisierungen ist ein Bereich eine Gruppe von Tabellen. Weitere Informationen zur Verwendung von Bereichen finden Sie unter Vorgehensweise: Bereitstellen einer Serverdatenbank für die Synchronisierung für die Zusammenarbeit (Nicht-SQL Server) und Vorgehensweise: Konfigurieren und Ausführen der Datenbanksynchronisierung (SQL Server).

Beispiele

Das folgende Codebeispiel gibt den Bereich für ein DbSyncProvider-Objekt in der SetupSyncProvider-Methode an, die für diese Dokumentation erstellt wurde. Diese Methode wird verwendet, damit Anbieter einfacher für mehrere Knoten konfiguriert werden können. Eine Darstellung dieses Codes im Kontext eines vollständigen Beispiels finden Sie unter Vorgehensweise: Konfigurieren und Ausführen der Synchronisierung für die Zusammenarbeit (Nicht-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"

Im folgenden Codebeispiel wird der Bereich für ein SqlSyncProvider-Objekt mithilfe des DbSyncScopeDescription-Objekts anstatt durch direktes Festlegen von ScopeName angegeben. Eine Darstellung dieses Codes im Kontext eines vollständigen Beispiels finden Sie unter Vorgehensweise: Konfigurieren und Ausführen der Datenbanksynchronisierung (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)

Siehe auch

Verweis

RelationalSyncProvider Klasse

RelationalSyncProvider-Member

Microsoft.Synchronization.Data-Namespace