Sync 接口
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
此对象、成员或枚举已弃用,不应在代码中使用。使用 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
- 属性
- 实现
注解
Microsoft Office Word 2003 Document 对象的 Sync 属性、Microsoft Office Excel 2003 Workbook 对象和 Microsoft Office PowerPoint 2003 Presentation 对象返回 Sync 对象。
属性 Status 返回有关同步当前状态的重要信息。 GetUpdate()使用 方法刷新同步状态。 LastSyncTime使用 、 ErrorType和 WorkspaceLastChangedBy 属性可返回其他信息。
Status有关共享文档的本地副本和服务器副本之间可能存在的差异和冲突的其他信息,请参阅 属性。
PutUpdate()使用 方法将本地更改保存到服务器。 关闭并重新打开文档可从服务器检索最新版本,未不进行任何本地更改时。 ResolveConflict(MsoSyncConflictResolutionType)使用 方法解决本地副本和服务器副本之间的差异,或使用 OpenVersion(MsoSyncVersionType) 方法打开文档当前打开的本地版本。
Sync 对象 GetUpdate 、 PutUpdate 和 ResolveConflict 方法不返回状态代码由于以异步方式完成其任务。 Sync 对象通过单个事件提供重要的状态信息,开发人员可以通过以下应用程序特定事件来访问这些信息:
上述 Sync 事件返回一个 MsoSyncEventType 值。
Sync 对象模型是否共享也可启用或禁用活动文档同步。 当活动文档未共享或未启用同步时,文档、工作簿和演示文稿对象的 Sync 属性不会返回 Nothing。 使用 Status 属性可确定文档是否共享以及是否启用同步。
不是所有文档同步问题都会引发可捕获的运行时错误。 使用 Sync 对象的方法后,最好检查 Status 属性;如果 Status 属性为 msoSyncStatusError,请检查 ErrorType 属性以获取有关已发生的错误类型的其他信息。
在许多情况下,解决错误条件的最佳方法是调用 GetUpdate 方法。 例如,如果对 PutUpdate 的调用导致错误条件,则调用 GetUpdate 会将状态重置为 msoSyncStatusLocalChanges。
属性
Application |
返回一个 Application 对象,该对象代表该对象的容器应用程序。 |
Creator |
返回一个 32 位整数,它指示在其中创建指定的对象的应用程序。 |
ErrorType |
返回一个常量,该常量指示最近的文档同步错误的类型。 |
LastSyncTime |
返回活动文档的本地副本上次与服务器副本同步的日期和时间。 |
Parent |
返回指定对象的 Parent 对象。 |
Status |
返回活动文档的本地副本与服务器副本的同步状态。 |
WorkspaceLastChangedBy |
显示上次将更改保存到共享文档的服务器副本的用户的友好名称。 |
方法
GetUpdate() |
将共享文档的本地版本与服务器上的版本进行比较。 |
OpenVersion(MsoSyncVersionType) |
在当前打开的本地版本旁打开共享文档的另一个版本。 |
PutUpdate() |
用共享文档的本地副本更新其服务器副本。 |
ResolveConflict(MsoSyncConflictResolutionType) |
解决共享文档的本地副本和服务器副本之间的冲突。 |
Unsuspend() |
继续执行共享文档的本地副本和服务器副本之间的同步。 |