IDatabaseSnapshotRestore.OnPreRestore - Méthode

Article
10/14/2015

Fournit des processus pour la restauration d'une base de données (objetSPDatabase ) à partir d'un de ses instantanés de préparation.

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

Syntaxe

'Déclaration
Sub OnPreRestore ( _
    args As SPDatabaseSnapshotRestoreEvent _
)
'Utilisation
Dim instance As IDatabaseSnapshotRestore
Dim args As SPDatabaseSnapshotRestoreEvent

instance.OnPreRestore(args)

void OnPreRestore(
    SPDatabaseSnapshotRestoreEvent args
)

Paramètres

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

Objet qui contient une référence à la capture instantanée à partir de laquelle est restaurée la base de données.

Remarques

Implémentez cette méthode pour fournir une logique personnalisée qui s'exécute avant une base de données est restaurée à partir d'une capture instantanée. Envisagez d'utiliser votre implémentation pour permettre à l'utilisateur d'annuler la restauration.

Important

Votre implémentation doit lever une exception si elle ne peut pas exécuter une condition préalable nécessaire à la restauration. Pour plus d'informations, consultez les rubriques de référence pour les surcharges de SPDatabaseSnapshot.Restore().

N'appelez pas cette méthode à partir de votre propre code. Appelle le processus de restauration.

Exemples

L'exemple suivant montre une implémentation qui peut être utilisée pour une base de données. Le «this» fait référence à un objet de personnalisé tapez appelée SupplementalDatabase qui un développeur a dérivé de SPDatabase , qui implémente IDatabaseSnapshotRestore. La méthode utilise la base de données hors connexion, puis s'interrompt le thread pendant 5 secondes avant de laisser la restauration se poursuivre.

public void OnPreRestore(SPDatabaseSnapshotRestoreEvent args)
{
    if (args == null)
    {
        throw new ArgumentNullException("args");
    }

    try
    {
        this.Status = SPObjectStatus.Offline;
        this.Update();
        Thread.Sleep(5000);
    }
    catch (exception)
    {
        Exception e = new Exception(String.Format("Restoration from {0} cancelled because pre-restoration steps could not be executed.", args.Snapshot.Name), exception);
        throw e;
    }
}

Voir aussi

Référence

IDatabaseSnapshotRestore interface

IDatabaseSnapshotRestore - Membres

Microsoft.SharePoint.Administration.Backup - Espace de noms

Partager via