Sync Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Этот объект, элемент или перечисление не рекомендуется использовать и не предназначен для использования в коде. Используйте объект Sync для управления синхронизацией локальных и серверных копий общего документа, хранящегося в рабочей области документа 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
- Атрибуты
- Реализации
Комментарии
Свойство Sync объекта Документа Microsoft Office Word 2003, microsoft Office Excel 2003 Workbook и объекта Презентации Microsoft Office PowerPoint 2003 возвращает объект Sync .
Свойство Status возвращает важные сведения о текущем состоянии синхронизации. Используйте метод для GetUpdate() обновления состояния синхронизации. LastSyncTimeИспользуйте свойства , ErrorTypeи WorkspaceLastChangedBy для возврата дополнительных сведений.
Status Дополнительные сведения о различиях и конфликтах, которые могут существовать между локальными и серверными копиями общих документов, см. в свойстве .
Используйте метод для PutUpdate() сохранения локальных изменений на сервере. Закройте и снова откройте документ, чтобы получить последнюю версию с сервера, если локальные изменения не были внесены. Используйте метод , ResolveConflict(MsoSyncConflictResolutionType) чтобы устранить различия между локальной и серверной копиями, или OpenVersion(MsoSyncVersionType) метод , чтобы открыть другую версию вместе с открытой локальной версией документа.
Методы GetUpdate, PutUpdate и ResolveConflict объекта Sync не возвращают коды состояния, так как они выполняют свои задачи асинхронно. Объект Sync предоставляет важные сведения о состоянии через одно событие, к которому разработчик может получить доступ с помощью следующих событий, относящихся к приложению:
Событие Синхронизации , описанное выше, MsoSyncEventType возвращает значение.
Объектная модель синхронизации доступна независимо от того, включены ли в активном документе общий доступ и синхронизация. Свойство Sync объектов Document, Workbook и Presentation не возвращает Значение Nothing, если активный документ не предоставлен или синхронизация не включена. Используйте свойство Status , чтобы определить, является ли документ общим и включена ли синхронизация.
Не все проблемы синхронизации документов создают перехватываемые ошибки времени выполнения. После использования методов объекта Sync рекомендуется проверить свойство Status ; Если свойство Status имеет значение msoSyncStatusError, проверьте свойство ErrorType для получения дополнительных сведений о типе произошедшей ошибки.
Во многих случаях лучшим способом устранения ошибки является вызов метода GetUpdate . Например, если вызов результатов PutUpdate приводит к состоянию ошибки, вызов метода GetUpdate восстановит состояние msoSyncStatusLocalChanges.
Свойства
Application |
Возвращает объект Application , представляющий приложение-контейнер для объекта . |
Creator |
Возвращает 32-разрядное целое число, указывающее приложение, в котором был создан указанный объект. |
ErrorType |
Возвращает константу, указывающую тип последней ошибки синхронизации документов. |
LastSyncTime |
Возвращает дату и время последней синхронизации локальной копии активного документа с копией сервера. |
Parent |
Возвращает родительский объект для указанного объекта. |
Status |
Возвращает состояние синхронизации локальной копии активного документа с серверной копией. |
WorkspaceLastChangedBy |
Отображает понятное имя пользователя, который последним сохранил изменения в серверной копии общего документа. |
Методы
GetUpdate() |
Сравнивает локальную версию общего документа с версией на сервере. |
OpenVersion(MsoSyncVersionType) |
Открывает другую версию общего документа вместе с открытой локальной версией. |
PutUpdate() |
Обновления серверную копию общего документа с локальной копией. |
ResolveConflict(MsoSyncConflictResolutionType) |
Разрешает конфликты между локальными и серверными копиями общего документа. |
Unsuspend() |
Возобновляет синхронизацию между локальной копией и серверной копией общего документа. |