Propriedade ScopeName

Artigo
08/18/2010

Obtém ou define o nome do escopo a ser sincronizado.

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

Sintaxe

'Declaração
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 da propriedade

Tipo: System. . :: . .String
O nome do escopo, que é um conjunto de objetos a serem sincronizados.

Exceções

Exceção	Condição
ObjectDisposedException	Este RelationalSyncProvider está descartado.
ArgumentNullException	value é null Nothing nullptr unit uma referência nula (Nothing no Visual Basic) .

Comentários

Para sincronização de banco de dados, um escopo é um conjunto de tabelas. Para obter mais informações sobre como os escopos são usados, consulte Como provisionar um banco de dados de servidor para sincronização de colaboração (não SQL Server) e Como configurar e executar a sincronização de bancos de dados (SQL Server).

Exemplos

O exemplo de código a seguir especifica o escopo para um objeto DbSyncProvider no método SetupSyncProvider criado para esta documentação. Esse método é usado de forma que os provedores possam ser configurados facilmente para vários nós. Para exibir esse código no contexto de um exemplo completo, consulte Como configurar e executar a sincronização de colaboração (não 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"

O exemplo de código a seguir especifica o escopo para um objeto SqlSyncProvider usando o objeto DbSyncScopeDescription, em vez de definir ScopeName diretamente. Para exibir esse código no contexto de um exemplo completo, consulte Como configurar e executar a sincronização de bancos de dados (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)

Consulte também

Referência

RelationalSyncProvider Classe

Membros RelationalSyncProvider

Namespace Microsoft.Synchronization.Data

Compartilhar via