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)