Sync Interface
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Esse objeto, membro ou enumeração é preterido e não se destina a ser usado em seu código. Use o objeto Sync para gerenciar a sincronização das cópias locais e de servidor de um documento compartilhado armazenado em um workspace de documento Windows SharePoint Services.
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
- Implementações
Comentários
A propriedade Sync do objeto Documento do Microsoft Office Word 2003, o objeto Workbook do Microsoft Office Excel 2003 e o objeto Apresentação do Microsoft Office PowerPoint 2003 retorna um objeto Sync .
A Status propriedade retorna informações importantes sobre o estado atual de sincronização. Use o GetUpdate() método para atualizar o status de 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 diferenças entre as cópias locais e do servidor ou o OpenVersion(MsoSyncVersionType) método para abrir uma versão diferente ao lado da versão local atualmente aberta do documento.
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:
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.
Propriedades
Application |
Retorna um objeto Application que representa o aplicativo de contêiner para o objeto. |
Creator |
Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado. |
ErrorType |
Retorna uma constante que indica o tipo do erro de sincronização de documento mais recente. |
LastSyncTime |
Retorna a data e a hora em que a cópia local do documento ativo foi sincronizada pela última vez com a cópia do servidor. |
Parent |
Retorna o objeto Pai para o objeto especificado. |
Status |
Retorna o status da sincronização da cópia local do documento ativo com a cópia do servidor. |
WorkspaceLastChangedBy |
Exibe o nome amigável do usuário que salvou alterações pela última vez na cópia do servidor de um documento compartilhado. |
Métodos
GetUpdate() |
Compara a versão local do documento compartilhado com a versão do servidor. |
OpenVersion(MsoSyncVersionType) |
Abre uma versão diferente do documento compartilhado junto com a versão local aberta no momento. |
PutUpdate() |
Atualiza a cópia de servidor do documento compartilhado com a cópia local. |
ResolveConflict(MsoSyncConflictResolutionType) |
Resolve conflitos entre as cópias local e do servidor de um documento compartilhado. |
Unsuspend() |
Reinicia a sincronização entre a cópia local e a cópia do servidor de um documento compartilhado. |