del método IBackupRestore.OnPreRestore

Proporciona el proceso de preparación de restauración.

Espacio de nombres:  Microsoft.SharePoint.Administration.Backup
Ensamblado:  Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
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
  Tipo: System.Object

  El objeto que llama a OnPreRestore.

• args
  Tipo: Microsoft.SharePoint.Administration.Backup.SPRestoreInformation

  Un objeto SPRestoreInformation que contiene datos acerca de la operación.

Valor devuelto

Tipo: System.Boolean
true si es correcto; en caso contrario, false.

Comentarios

En la mayoría de las situaciones, una operación de restauración no requiere ninguna preparación y la implementación de OnPreRestore sólo debe devolver true.

Algunos ejemplos de cosas que es posible que debe llevar a cabo con su implementación:

• Si no se inicializó la propiedad de Name del objeto content, establecer con el parámetro SPName de args mediante el método de GetParameter() , como se muestra en este ejemplo:

  this.Name = args.GetParameter(SPBackupRestoreObject.SPName);
  

  Me.Name = args.GetParameter(SPBackupRestoreObject.SPName)
  

• Si el componente de contenido representado por el objeto IBackupRestore es algún tipo de base de datos, OnPreRestore puede utilizarse para especificar la información de configuración necesaria para conectarse con la aplicación de base de datos.

• Si su implementación de OnPreRestore toma una parte importante del tiempo total para la operación de copia de seguridad, establezca args.CurrentProgess() a un valor apropiado.

• Si desea que los usuarios finales tengan la opción de migrar el contenido de la copia de seguridad, la implementación de OnPreRestore también debe inicializar SPServer, SPNamey SPLocation a sus valores actuales. Si no hace esta inicialización, la aplicación de Administración Central no presentará al usuario final con una interfaz de usuario en el que se puede escribir un nuevo servidor, el nombre del componente o la ubicación. En SharePoint Foundation, esta interfaz de usuario está en la sección Nombres nuevos de la página Restaurar a partir de copia de seguridad - paso 4 de 4 de la aplicación de Administración Central. (También es necesario que establecer que CanRenameOnRestore en true).

Importante

No detener o pausar un servicio o aplicación Web en el método OnPreRestore(Object, SPBackupInformation) . Vea OnRestore(Object, SPBackupInformation) por qué.

El método OnPreRestore siempre se ejecutará cuando se ha seleccionado el objeto IBackupRestore para la restauración. Si devuelve false, se ejecutarán ni el OnRestore ni los métodos de OnPostRestore .

Vea también

Referencia

interfaz IBackupRestore

Miembros IBackupRestore

Espacio de nombres Microsoft.SharePoint.Administration.Backup