IBackupRestore.OnPreRestore-Methode

Artikel
05/06/2015

Bietet Wiederherstellung Vorbereitung Verarbeitung.

Namespace: Microsoft.SharePoint.Administration.Backup
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaration
Function OnPreRestore ( _
    sender As Object, _
    args As SPRestoreInformation _
) As Boolean
'Usage
Dim instance As IBackupRestore
Dim sender As Object
Dim args As SPRestoreInformation
Dim returnValue As Boolean

returnValue = instance.OnPreRestore(sender, _
    args)

bool OnPreRestore(
    Object sender,
    SPRestoreInformation args
)

Parameter

sender
Typ: System.Object

Das Objekt, das OnPreRestoreaufruft.

args
Typ: Microsoft.SharePoint.Administration.Backup.SPRestoreInformation

Ein SPRestoreInformation -Objekt, das Daten über den Vorgang enthält.

Rückgabewert

Typ: System.Boolean
true bei erfolgreicher; andernfalls false.

Hinweise

In den meisten Fällen eine Wiederherstellung erfordert keine Vorbereitungen und die Implementierung von OnPreRestore sollte nur truezurückgegeben.

Einige Beispiele für Aufgaben müssen Sie mit der Implementierung erreichen:

Wenn Ihre Inhaltsobjekt Name -Eigenschaft nicht initialisiert werden, legen Sie es mit dem Parameter SPNameargs mithilfe der GetParameter() -Methode, wie im folgenden Beispiel dargestellt:
```
this.Name = args.GetParameter(SPBackupRestoreObject.SPName);
```
```
Me.Name = args.GetParameter(SPBackupRestoreObject.SPName)
```
Wenn der durch das IBackupRestore -Objekt dargestellten Inhaltskomponente verschiedenste der Datenbank ist, kann OnPreRestore Einstellungsinformationen zum Verbinden mit der Datenbankanwendung erforderliche angeben verwendet werden.
Wenn die Implementierung von OnPreRestore einen Großteil der Gesamtzeit für den Sicherungsvorgang akzeptiert, legen Sie args.CurrentProgess() einen geeigneten Wert.
Wenn Sie Endbenutzern die Möglichkeit der Migration des gesicherten Inhalts haben möchten, muss die Implementierung von OnPreRestore auch SPServer, SPNameund SPLocation auf ihre aktuellen Werte initialisiert werden. Wenn Sie nicht die Initialisierung auszuführen, präsentiert die Zentraladministrationsanwendung nicht der Endbenutzer mit einer Benutzeroberfläche in dem er einen neuen Server, der Name der Komponente oder der Speicherort eingeben können. In SharePoint Foundationist diese Benutzeroberfläche im Abschnitt Neue Namen der Seite Wiederherstellung von Sicherung - Schritt 4 von 4 der Anwendung der Zentraladministration. (Es ist auch erforderlich, dass diese CanRenameOnRestore auf truegesetzt werden.)

Wichtig

Beenden Sie oder unterbrechen Sie Diensts oder einer Webanwendung in der OnPreRestore(Object, SPBackupInformation) -Methode nicht. Finden Sie unter OnRestore(Object, SPBackupInformation) warum.

Die OnPreRestore -Methode wird immer ausgeführt, wenn das Objekt IBackupRestore für die Wiederherstellung ausgewählt wurde. Wenn falsezurückgegeben wird, werden weder die OnRestore noch die OnPostRestore Methoden ausgeführt.

Siehe auch

Referenz

IBackupRestore Schnittstelle

IBackupRestore-Member

Microsoft.SharePoint.Administration.Backup-Namespace

Freigeben über