Sync インターフェイス

定義

名前空間:

Microsoft.Office.Core

アセンブリ:

office.dll

このオブジェクト、メンバー、または列挙型は非推奨であり、コードで使用することを意図していません。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

属性

GuidAttribute

実装

_IMsoDispObj

注釈

Microsoft Office Word 2003 Document オブジェクト、Microsoft Office Excel 2003 Workbook オブジェクト、および Microsoft Office PowerPoint 2003 Presentation オブジェクトの Sync プロパティは、Sync オブジェクトを返します。

プロパティは Status 、同期の現在の状態に関する重要な情報を返します。 同期状態を GetUpdate() 更新するには、 メソッドを使用します。 、、および WorkspaceLastChangedBy の各プロパティをLastSyncTimeErrorType使用して、追加情報を返します。

共有ドキュメントの Status ローカル コピーとサーバー コピーの間に存在する可能性がある違いと競合の詳細については、プロパティを参照してください。

メソッドを PutUpdate() 使用して、ローカルの変更をサーバーに保存します。 閉じるし、ローカルの変更が加えられていない場合、サーバーから最新バージョンを取得するためにドキュメントを再度開きます。 メソッドを ResolveConflict(MsoSyncConflictResolutionType) 使用して、ローカル コピーとサーバー コピーの違いを解決するか、 メソッドを OpenVersion(MsoSyncVersionType) 使用して、ドキュメントの現在開いているローカル バージョンと共に別のバージョンを開きます。

Sync オブジェクトの GetUpdate 、 PutUpdate 、および ResolveConflict メソッドは、各自のタスクを非同期的に完了するためのステータス コードを返しません。 同期 オブジェクトには、状態情報は次のアプリケーション固有のイベントを通じて、開発者がアクセスできる 1 つのイベントが用意されています。

上記の Sync イベントは値を MsoSyncEventType 返します。

Sync オブジェクト モデルは、使用可能な共有するかどうかと同期が有効になっているまたは作業中の文書で無効にします。 同期 オブジェクトのプロパティ、 ドキュメント 、 ブック 、および プレゼンテーション を返さない 何も 作業中の文書が共有されていない、または同期が有効になっていない場合です。 ドキュメントが共有されているかどうかとの同期が有効になっているかどうかを決定するのにには、 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()	共有ドキュメントのローカル コピーとサーバー コピーの同期を再開します。