Sync Framework 2.0 no se puede instalar en un equipo que tenga instalada la versión Sync Framework 2.0 Community Technology Preview (CTP). Esto significa que no es posible actualizar desde Sync Framework 2.0 CTP1 o CTP2 a la versión RTM de Sync Framework 2.0. Para instalar Sync Framework 2.0, desinstale primero cualquier versión de Sync Framework 2.0 CTP.

Sync Framework 2.0 se puede instalar, funcionando en paralelo, con Sync Framework 1.0.

Entre Sync Framework 1.0 y Sync Framework 2.0 se han producido los cambios siguientes.

• Se creó la clase base Microsoft.Synchronization.Data.RelationalSyncProvider para encapsular la lógica que es común a todos los proveedores de bases de datos de Sync Framework. Muchos de los miembros de DbSyncProvider fueron movidos a RelationalSyncProvider, pero la superficie de la API general no cambió significativamente. Microsoft.Synchronization.Data.DbSyncProvider, Microsoft.Synchronization.Data.SqlServer.SqlSyncProvider y Microsoft.Synchronization.Data.SqlServerCe.SqlCeSyncProvider se han heredado de RelationalSyncProvider.
  
• Se ha quitado la colección SyncConflict que estaba disponible desde Microsoft.Synchronization.Data.DbSyncTableProgress. Esto mejoró el rendimiento al reducir el uso de memoria para las sesiones de sincronización con un gran número de conflictos. Ahora se recomienda interactuar con los conflictos sobre una base individual utilizando el evento ApplyChangeFailed por cada proveedor.
  

Entre Sync Framework 2.0 CTP2 y la versión final de Sync Framework 2.0 se han producido los cambios siguientes.

• Se quitó la propiedad Microsoft.Synchronization.Data.SqlServer.SqlSyncProviderAdapterConfiguration.PkColumnNames. Ahora en su lugar debería usar la propiedad Microsoft.Synchronization.Data.SqlServer.SqlSyncProviderAdapterConfiguration.Columns.
  
• Se cambiaron las colecciones siguientes en las colecciones enumerables para que se adhieran a los patrones existentes para los conocidos tipos ADO.Net, como DataSet:
  
  • Microsoft.Synchronization.Data.DbSyncTableDescription, que está disponible mediante la propiedad Microsoft.Synchronization.Data.DbSyncScopeDescription.Tables.
    
  • Microsoft.Synchronization.Data.SqlServer.SqlSyncTableProvisioning, que está disponible mediante la propiedad Microsoft.Synchronization.Data.SqlServer.SqlSyncScopeProvisioning.Tables.
    
  • Microsoft.Synchronization.Data.SqlServerCe.SqlCeSyncTableProvisioning, que está disponible mediante la propiedad Microsoft.Synchronization.Data.SqlServerCe.SqlCeSyncScopeProvisioning.Tables.
    
• El método Microsoft.Synchronization.Data.DbSyncColumnDescription.GetInitialParameterName se convirtió a una propiedad para que se conformase a las prácticas recomendadas de diseño de las API. Ahora debe usar en su lugar la propiedad Microsoft.Synchronization.Data.DbSyncColumnDescription.ParameterName.
  
• El nombre del método de inicialización de instantánea se cambió a Microsoft.Synchronization.Data.SqlServerCe.SqlCeSyncStoreSnapshotInitialization.InitializeFromSnapshot.
  

En algunos casos, Sync Framework usa el atributo XmlIgnoreAttribute cuando se aprovisionan las bases de datos. En las versiones más antiguas de .NET Framework, el uso de XmlIgnoreAttribute causa la excepción siguiente:

Message: Unable to generate a temporary class (result=1).
error CS0200: Property or indexer 'Microsoft.Synchronization.Data.DbSyncColumnDescription.IsNullableSpecified' cannot be assigned to -- it is read only
error CS0200: Property or indexer 'Microsoft.Synchronization.Data.DbSyncColumnDescription.IsPrimaryKeySpecified' cannot be assigned to -- it is read only

Para evitar este problema, asegúrese de que tiene .NET Framework 2.0 SP1 o una versión posterior instalada en el equipo que está ejecutando el proveedor de bases de datos de Sync Framework.

Si el proceso de sincronización se está ejecutando bajo LUA, se produce el error siguiente cuando intenta aprovisionar una base de datos:

Message: Unable to generate a temporary class (result=1).
error CS2001: Source file 'D:\WINDOWS\TEMP\ycwdmrz3.0.cs' could not be found
error CS2008: No inputs specified

Este error se produce porque el serializador que usa Sync Framework necesita acceso de lectura y escritura al directorio temporal de Windows, que LUA no permite.

Cuando la aplicación de ejemplo intenta configurar el tamaño del lote de sincronización en un valor que no sea cero, se producen las excepciones siguientes:

Outer Exception: An unexpected error occurred when applying batch file.
Inner Exception: Attempting to deserialize an empty stream.

Para arreglar la aplicación de ejemplo, modifique el método GetChangeBatch() en RelationalProviderProxy.cs (line106) para que la creación de instancias del objeto Filestream se haga dentro de la declaración If.

//ORIGINAL CODE
string localFileName = Path.Combine(this.localBatchingDirectory.FullName, context.BatchFileName);
FileInfo localFileInfo = new FileInfo(localFileName);

//Download the file only if it doesn't exist
FileStream localFileStream = new FileStream(localFileName, FileMode.Create, FileAccess.Write);

                if (!localFileInfo.Exists)
                {
                    byte[] remoteFileContents = this.proxy.DownloadBatchFile(context.BatchFileName);
                    using (localFileStream)
                    {
                        localFileStream.Write(remoteFileContents, 0, remoteFileContents.Length);
     }
  }

                  }
                }

//UPDATED CODE
string localFileName = Path.Combine(this.localBatchingDirectory.FullName, context.BatchFileName);
FileInfo localFileInfo = new FileInfo(localFileName);
                
                if (!localFileInfo.Exists)
                {
                    //Download the file only if doesnt exist
                    FileStream localFileStream = new FileStream(localFileName, FileMode.Create, FileAccess.Write);
                    byte[] remoteFileContents = this.proxy.DownloadBatchFile(context.BatchFileName);
                    using (localFileStream)
                    {
                        localFileStream.Write(remoteFileContents, 0, remoteFileContents.Length);
     }
  }

Entre Sync Framework 1.0 y Sync Framework 2.0 se han producido los cambios siguientes.

• La enumeración Microsoft.Synchronization.FilterType (para código administrado) y la enumeración FILTER_TYPE (para código no administrado) no se usan y se han quitado. Debe quitarse también cualquier referencia a estas enumeraciones que haya en su código.
  

En el espacio de nombres Microsoft.Synchronization.SimpleProviders se produjeron los siguientes cambios entre Sync Framework 2.0 CTP2 y Sync Framework 2.0 RTM.

• Se quitaron las siguientes clases y métodos.
  
  • El constructor AnchorEnumerationContext.
    
  • El método AnchorEnumerationSimpleSyncProvider.EnumerateItems.
    
  • El método ISimpleSyncProviderIdGenerator.GenerateNewReplicaId.
    
  • El método RecoverableErrorReportingContext.RecordRecoverableErrorForChangeUnit.
    
  • El método SimpleSyncProvider.ChangeReplicaId.
    
  • La clase ChangeDetectionFailedException.
    
  • La clase CustomConflictResolutionNotSupportedException.
    
  • La clase ItemSchemaNotDefinedException.
    
  • La clase NewItemDoesNotContainAllFieldsException.
    
  • La clase NoCommonChangeUnitsException.
    
  • La clase UnknownChangeUnitException.
    
• Se cambió el nombre de los métodos siguientes o se cambiaron los parámetros.
  
  • Se cambió el nombre del método AnchorEnumerationContext.AutodetectDeletes por el de AnchorEnumerationContext.ReportItemsAndAutodetectDeletes y los parámetros del método se cambiaron.
    
  • Se cambiaron los parámetros del método AnchorEnumerationSimpleSyncProvider.EnumerateChanges.
    
  • Se cambiaron los parámetros del método ISimpleSyncProviderIdGenerator.GenerateNewItemId.
    
  • La clase ItemFieldDictionary ya no implementa la interfaz System.Collections.ICollection.
    
  • Se cambiaron los parámetros del constructor SimpleSyncServices.
    
  • Se cambió el nombre del método SimpleSyncServices.CleanupTombstones por el de SimpleSyncServices.CleanupDeletedItems.
    
  • Se cambiaron los parámetros del constructor UnmanagedSimpleSyncProviderWrapper.UnmanagedSimpleSyncProviderWrapper.
    
  • Se cambiaron los parámetros del método UnmanagedSimpleSyncProviderWrapper.Initialize.
    
• Las clases siguientes se movieron desde el espacio de nombres Microsoft.Synchronization.SimpleProviders al espacio de nombres Microsoft.Synchronization.
  
  • ChangeDeferredByProviderException
    
  • ChangeReplicaIdPendingException
    
  • DuplicateItemException
    
  • ItemNotFoundInMetadataStoreException
    
  • MetadataStoreVersion2RequiredException
    
  • OptimisticConcurrencyException
    
  • RecoverableErrorMustFailEntireItemException
    
  • SimpleProviderInvalidOperationException
    
  • SimpleProvidersException
    

Algunos métodos pueden devolver un mensaje de error genérico, como "Exception from HRESULT: 0x80041006", en lugar de una descripción de la causa del error. En la tabla siguiente se enumeran los códigos de error y sus valores. Para las descripciones de estos códigos de error, vea Códigos de error de Sync Framework en la referencia Componentes principales de Sync Framework.

Esta situación se produce cuando se usan proveedores simples y una de las réplicas de la comunidad de sincronización usa un filtro de unidad de cambio. Los pasos que causan esta situación son los siguientes:

1. El elemento I es eliminado de la réplica sin filtrar A y, a continuación, se quita el marcador de exclusión.
   
2. El elemento I se actualizó en la réplica B. La réplica B usa un filtro de unidad de cambio y, por tanto, no almacena todas las unidades de cambio correspondientes al elemento.
   
3. La sincronización se realiza utilizando la réplica B como réplica de origen y la réplica A como la de destino.
   
4. Se ha detectado un conflicto eliminación-actualización en el elemento I y se ha resuelto en favor de la actualización de la réplica B. El elemento I se ha restaurado en la réplica A, pero solo contiene los datos correspondientes a las unidades de cambio que se almacenan en la réplica B. La versión de todas las unidades de cambio se ha actualizado a la nueva versión.
   
5. La sincronización se realiza de nuevo, esta vez utilizando la réplica C sin filtrar como réplica de origen y la réplica A como la de destino.
   
6. Las unidades de cambio perdidas del elemento I no se envían desde la réplica C, porque sus versiones en la réplica A son posteriores a sus versiones en la réplica C.
   

Para evitar esta situación, actualice las unidades de cambio para el elemento I de la réplica C, para que sus versiones sean posteriores a las versiones de la réplica A y, después, sincronice desde la réplica C a la réplica A.

Cuando la réplica de destino está obsoleta y debe realizarse la sincronización de recuperación, la réplica de origen debe ser una réplica sin filtrar para recuperar plenamente la réplica obsoleta. Cuando la réplica de origen es una réplica filtrada, el proveedor de origen no debe realizar una enumeración completa, pues se pueden producir resultados inesperados.

En esta situación, la réplica de origen filtrada puede realizar una sincronización parcial con la réplica de destino obsoleta. Para ello, la aplicación especifica FullEnumerationAction.Partial como respuesta al evento FullEnumerationNeeded (para código administrado) o SFEA_PARTIAL_SYNC como respuesta al método de devolución de llamada ISyncCallback::OnFullEnumerationNeeded (para código no administrado). La aplicación también puede canelar la sincronización especificando FullEnumeration.Abort (para código administrado) o SFEA_ABORT (para código no administrado).

Cuando una réplica filtrada usa la técnica de instantánea para limpiar los marcadores de exclusión, hay que poner mucho cuidado para asegurarse de que el conocimiento de la réplica contenga siempre el conocimiento olvidado de la réplica. Esto se debe a que pueden darse situaciones en las que el conocimiento de una réplica filtrada es reducido por causa de un elemento que se mueve en relación con el filtro.

Cuando un filtro personalizado es usado por un proveedor de origen para enumerar los cambios que contienen las unidades de cambio, se pueden producir resultados inesperados, incluyendo la pérdida de datos. Por ello, cuando un cambio que contiene unidades de cambio se agrega a un lote de cambios filtrado que usa un filtro personalizado, el método ItemChange.AddChangeUnitChange causa una excepción SyncInvalidOperationException (para código administrado) o ISyncChangeBuilder::AddChangeUnitMetadata devuelve SYNC_E_INVALID_OPERATION (para código no administrado).

Los ejemplos de Sync Framework se configuran para generar en la plataforma x86. Cuando se instala Sync Framework para otra plataforma, como la plataforma x64, los ejemplos dan error al ejecutarse y causan una excepción con el mensaje siguiente: "No se pudo recuperar el generador de clases COM para el componente con CLSID {DBFD020B-D830-4FBE-A927-566B1F57A17A} debido al siguiente error: 80040154".

Para arreglar este problema, reconfigure el ejemplo para generar en la plataforma actual, como la plataforma x64. Vuelva a generar el ejemplo y se ejecutará sin errores.

• En la documentación falta una descripción del parámetro filteringType del delegado Microsoft.Synchronization.FilterRequestCallback, del tipo Microsoft.Synchronization.FilteringType. Este parámetro indica el tipo de información incluida en un lote de cambios durante la sincronización filtrada.
  
• El valor de retorno de la propiedad Microsoft.Synchronization.Data.DbSyncTableDescription.IsTableMapped se ha descrito incorrectamente en la documentación. Este valor de retorno es false si los valores de la propiedad GlobalName y LocalName son los mismos; en caso contrario es true.
  

Cuando se instala la versión de chino tradicional de Sync Framework 2.0, Microsoft Visual Studio 2008 muestra en inglés el contenido de IntelliSense. Para arreglar este problema, actualícese a Visual Studio 2008 SP1.