Sync Interface

Definição

public interface class Sync : Microsoft::Office::Core::_IMsoDispObj

[System.Runtime.InteropServices.Guid("000C0386-0000-0000-C000-000000000046")]
public interface Sync : Microsoft.Office.Core._IMsoDispObj

[<System.Runtime.InteropServices.Guid("000C0386-0000-0000-C000-000000000046")>]
type Sync = interface
    interface _IMsoDispObj

Public Interface Sync
Implements _IMsoDispObj

Atributos

GuidAttribute

Implementações

_IMsoDispObj

Comentários

As propriedades Sync do objeto Document do Microsoft Office Word 2003, do objeto Pasta de Trabalho do Microsoft Office Excel 2003 e do objeto Presentation do Microsoft Office PowerPoint 2003 retornam um objeto Sync.

A Status propriedade retorna informações importantes sobre o estado atual da sincronização. Use o GetUpdate() método para atualizar o status da sincronização. Use as LastSyncTimepropriedades , ErrorTypee WorkspaceLastChangedBy para retornar informações adicionais.

Consulte a Status propriedade para obter informações adicionais sobre as diferenças e conflitos que podem existir entre as cópias locais e de servidor de documentos compartilhados.

Use o PutUpdate() método para salvar alterações locais no servidor. Feche e reabra o documento para recuperar a versão mais recente do servidor quando nenhuma alteração local são feitas. Use o ResolveConflict(MsoSyncConflictResolutionType) método para resolver as diferenças entre as cópias local e de servidor ou o OpenVersion(MsoSyncVersionType) método para abrir uma versão diferente junto com a versão local do documento atualmente aberta.

Os métodos GetUpdate, PutUpdate e ResolveConflict do objeto Sync não retornam os códigos de status porque eles concluem suas tarefas de forma assíncrona. O objeto Sync fornece informações de status importantes por meio de um único evento, o desenvolvedor pode acessar através os seguintes eventos de aplicativo específico:

• No Word, por meio do evento Sync do objeto Document ou do evento DocumentSync do objeto Application.

• No Excel, por meio do evento Sync do objeto Workbook ou do evento WorkbookSync do objeto Application .

• No PowerPoint, por meio do evento PresentationSync do objeto Application .

O evento Sync descrito acima retorna um MsoSyncEventType valor.

O modelo de objeto de sincronização está disponível se o compartilhamento e a sincronização estão habilitados ou desabilitados no documento ativo. A propriedade Sync dos objetos de documento, pasta de trabalho e a apresentação não retorna nada quando o documento ativo não é compartilhado ou a sincronização não está habilitada. Use a propriedade Status para determinar se o documento está compartilhado e se a sincronização está habilitada.

Nem todos os problemas de sincronização de documento geram erros interceptáveis de tempo de execução. Depois de usar os métodos do objeto Sync, é uma boa ideia verificar a propriedade Status; Se a propriedade Status for msoSyncStatusError, verifique a propriedade ErrorType para informações adicionais sobre o tipo de erro que ocorreu.

Em muitas circunstâncias, a melhor maneira de resolver uma condição de erro é chamar o método GetUpdate. Por exemplo, se uma chamada para PutUpdate resultados em uma condição de erro, em seguida, uma chamada para GetUpdate redefinirá o status msoSyncStatusLocalChanges.