ScopeName Propiedad
Obtiene o establece el nombre del ámbito que se va a sincronizar.
Espacio de nombres: Microsoft.Synchronization.Data
Ensamblado: Microsoft.Synchronization.Data (en Microsoft.Synchronization.Data.dll)
Sintaxis
'Declaración
Public Overridable Property ScopeName As String
Get
Set
'Uso
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)
Valor de la propiedad
Tipo: System. . :: . .String
El nombre del ámbito, que es un conjunto de objetos que se va a sincronizar.
Excepciones
| Excepción | Condición |
|---|---|
| ObjectDisposedException | Se elimina este objeto RelationalSyncProvider. |
| ArgumentNullException | El parámetro value es una null Nothing nullptr unit es una referencia NULL (Nothing en Visual Basic). . |
Notas
En la sincronización de bases de datos, un ámbito es un conjunto de tablas. Para obtener más información sobre cómo se usan los ámbitos, vea Aprovisionar una base de datos servidor para la sincronización de colaboración (no SQL Server) y Configurar y ejecutar la sincronización de base de datos (SQL Server).
Ejemplos
En el ejemplo de código siguiente se especifica el ámbito para un objeto DbSyncProvider en el método SetupSyncProvider que se creó para esta documentación. Este método se utiliza para que los proveedores se puedan configurar fácilmente para varios nodos. Para consultar este código en el contexto de un ejemplo completo, vea Configurar y ejecutar la sincronización de colaboración (no 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"
En el ejemplo de código siguiente se especifica el ámbito de un objeto SqlSyncProvider mediante el objeto DbSyncScopeDescription, en lugar de establecer ScopeName directamente. Para consultar este código en el contexto de un ejemplo completo, vea Configurar y ejecutar la sincronización de base de datos (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)