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
abstract BeginSession :
position:SyncProviderPosition *
syncSessionContext:SyncSessionContext -> unit
public abstract function BeginSession(
position : SyncProviderPosition,
syncSessionContext : SyncSessionContext
)
パラメーター
- position
型 : Microsoft.Synchronization. . :: . .SyncProviderPosition
セッションの他のプロバイダーに対して相対的な、プロバイダーの位置です。
- syncSessionContext
型 : Microsoft.Synchronization. . :: . .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;
}