IBackupRestore.OnPreRestore method

Artigo
05/12/2015

Fornece processamento de preparação de restauração.

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

Syntax

'Declaração
Function OnPreRestore ( _
    sender As Object, _
    args As SPRestoreInformation _
) As Boolean
'Uso
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
)

Parâmetros

sender
Type: System.Object

O objeto que chama OnPreRestore.

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

Um objeto SPRestoreInformation que contém dados sobre a operação.

Valor retornado

Type: System.Boolean
true se for bem-sucedida; Caso contrário, false.

Comentários

Na maioria das situações, uma operação de restauração requer sem preparação e implementação do OnPreRestore deve retornar apenas true.

Alguns exemplos de coisas que talvez você precise realizar com sua implementação:

Se a propriedade de Name do objeto de conteúdo não foi inicializado, defina-o com o parâmetro de SPName de args usando o método GetParameter() , conforme mostrado neste exemplo:
```
this.Name = args.GetParameter(SPBackupRestoreObject.SPName);
```
```
Me.Name = args.GetParameter(SPBackupRestoreObject.SPName)
```
Se o componente de conteúdo representado pelo objeto IBackupRestore algum tipo de banco de dados, OnPreRestore pode ser usado para especificar informações de configurações necessárias para conectar-se com o aplicativo de banco de dados.
Se a sua implementação de OnPreRestore usa uma parte significativa do tempo total para a operação de backup, defina args.CurrentProgess() para um valor apropriado.
Se desejar que os usuários finais tenham a opção de migrar o conteúdo do backup, sua implementação de OnPreRestore também deve ser inicializada, SPServer, SPNamee SPLocation para seus valores atuais. Se você não fizer essa inicialização, o aplicativo da Administração Central não apresentar ao usuário final com uma interface do usuário em que ele ou ela pode inserir um novo servidor, o nome do componente ou o local. Em SharePoint Foundation, essa interface do usuário está na seção Novos nomes da página do aplicativo Administração Central para Restaurar do Backup - Etapa 4 de 4 . (Também é necessário que CanRenameOnRestore ser definido como true.)

Importante

Não parar ou pausar um serviço ou aplicativo da Web no método OnPreRestore(Object, SPBackupInformation) . Consulte OnRestore(Object, SPBackupInformation) para motivo.

O método OnPreRestore sempre será executado quando o objeto IBackupRestore foi selecionado para restauração. Se ele retornar false, nem o OnRestore como os métodos de OnPostRestore serão executado.

Ver também

Referência

IBackupRestore interface

IBackupRestore members

Microsoft.SharePoint.Administration.Backup namespace

Compartilhar via