IBackupRestore.OnPreRestore - Méthode

Article
10/14/2015

Fournit le traitement de préparation de restauration.

Espace de noms : Microsoft.SharePoint.Administration.Backup
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
Function OnPreRestore ( _
    sender As Object, _
    args As SPRestoreInformation _
) As Boolean
'Utilisation
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
)

Paramètres

sender
Type : System.Object

L'objet qui appelle OnPreRestore.

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

Objet SPRestoreInformation qui contient les données relatives à l'opération.

Valeur renvoyée

Type : System.Boolean
true en cas de réussite ; dans le cas contraire, false.

Remarques

Dans la plupart des cas, une opération de restauration ne nécessite aucune préparation et l'implémentation de OnPreRestore doit simplement retourner true.

Voici quelques exemples de choses que vous devrez peut-être réaliser avec votre implémentation :

Si la propriété Name de l'objet contenu n'a pas pu être initialisé, définir avec le paramètre SPName de args à l'aide de la méthode GetParameter() comme illustré dans cet exemple :
```
this.Name = args.GetParameter(SPBackupRestoreObject.SPName);
```
```
Me.Name = args.GetParameter(SPBackupRestoreObject.SPName)
```
Si le composant de contenu représenté par l'objet IBackupRestore est un type de base de données, OnPreRestore peut être utilisé pour spécifier des informations sur les paramètres requises pour se connecter à l'application de base de données.
Si votre implémentation de OnPreRestore prend une part importante du temps total de l'opération de sauvegarde, la valeur args.CurrentProgess() à une valeur appropriée.
Si vous souhaitez que les utilisateurs finaux aient la possibilité de faire migrer le contenu sauvegardé, votre implémentation de OnPreRestore devez également initialiser SPServer, SPNameet SPLocation à leurs valeurs actuelles. Si vous ne procédez pas de cette initialisation, l'application Administration centrale présentera pas l'utilisateur final avec une interface utilisateur dans lequel il ou elle peut entrer un nouveau serveur, le nom du composant ou l'emplacement. Dans SharePoint Foundation, cette interface utilisateur est dans la section des Nouveaux noms de la page à restaurer à partir de la sauvegarde - étape 4 sur 4 de l'application d'Administration centrale. (Il est également nécessaire que CanRenameOnRestore la valeur true.)

Important

Ne pas arrêter ou suspendre un service ou une application Web dans la méthode OnPreRestore(Object, SPBackupInformation) . Reportez-vous à la OnRestore(Object, SPBackupInformation) pourquoi.

La méthode OnPreRestore est toujours exécutés lorsque l'objet IBackupRestore a été sélectionnée pour la restauration. Si elle retourne false, le OnRestore , ni les méthodes OnPostRestore seront exécute.

Voir aussi

Référence

IBackupRestore interface

IBackupRestore - Membres

Microsoft.SharePoint.Administration.Backup - Espace de noms

Partager via