BeginSession-Methode
Benachrichtigt den Anbieter beim Überschreiben in einer abgeleiteten Klasse darüber, dass er einer Synchronisierungssitzung beitritt.
Namespace: Microsoft.Synchronization
Assembly: Microsoft.Synchronization (in Microsoft.Synchronization.dll)
Syntax
'Declaration
Public MustOverride Sub BeginSession ( _
position As SyncProviderPosition, _
syncSessionContext As SyncSessionContext _
)
'Usage
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
)
Parameter
- position
Typ: Microsoft.Synchronization. . :: . .SyncProviderPosition
Die Position dieses Anbieters relativ zum anderen Anbieter in der Sitzung.
- syncSessionContext
Typ: Microsoft.Synchronization. . :: . .SyncSessionContext
Der aktuelle Status der entsprechenden Sitzung.
Hinweise
Diese Methode löst eine InvalidOperationException aus, wenn der Anbieter keine Sitzung starten kann, beispielsweise, wenn der Anbieter nicht initialisiert wurde, über eine ungültige Konfiguration verfügt oder bereits in einer nicht abgeschlossenen Sitzung eingetragen ist.
Beispiele
Im folgenden Beispiel wird der Sitzungskontext gespeichert. Dieser Gegenstand wird in der EndSession-Methode freigegeben.
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;
}