KnowledgeSyncProvider.BeginSession メソッド

派生クラスでオーバーライドされると、同期セッションに参加していることをプロバイダーに通知します。

名前空間: Microsoft.Synchronization
アセンブリ: Microsoft.Synchronization (microsoft.synchronization.dll 内)

構文

'宣言
Public MustOverride Sub BeginSession ( _
    position As SyncProviderPosition, _
    syncSessionContext As SyncSessionContext _
)
'使用
Dim instance As KnowledgeSyncProvider
Dim position As SyncProviderPosition
Dim syncSessionContext As SyncSessionContext

instance.BeginSession(position, syncSessionContext)
public abstract void BeginSession (
    SyncProviderPosition position,
    SyncSessionContext syncSessionContext
)
public:
virtual void BeginSession (
    SyncProviderPosition position, 
    SyncSessionContext^ syncSessionContext
) abstract
public abstract void BeginSession (
    SyncProviderPosition position, 
    SyncSessionContext syncSessionContext
)
public abstract function BeginSession (
    position : SyncProviderPosition, 
    syncSessionContext : SyncSessionContext
)

パラメーター

  • position
    セッションの他のプロバイダーに対して相対的な、プロバイダーの位置です。
  • syncSessionContext
    対応するセッションの現在の状態です。

解説

このメソッドは、プロバイダーがセッションを開始できない場合に、InvalidOperationException をスローします。たとえば、プロバイダーが初期化されていない場合、プロバイダーの構成が無効な場合、プロバイダーが未完了のセッションに既に参加している場合があります。

次の例では、セッション コンテキストを格納します。このオブジェクトは、EndSession メソッドで解放されます。

public override void BeginSession(SyncProviderPosition position, SyncSessionContext syncSessionContext)
{
    // If this object is already in a session, throw an exception.
    if (null != _sessionContext)
    {
        throw new SyncInvalidOperationException();
    }
    
    _sessionContext = syncSessionContext;
}

参照

リファレンス

KnowledgeSyncProvider クラス
KnowledgeSyncProvider メンバー
Microsoft.Synchronization 名前空間