IBackupRestore.OnPreRestore 方法

提供恢复准备处理。

命名空间：  Microsoft.SharePoint.Administration.Backup
程序集：  Microsoft.SharePoint（位于 Microsoft.SharePoint.dll 中）

语法

声明
Function OnPreRestore ( _
    sender As Object, _
    args As SPRestoreInformation _
) As Boolean
用法
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
)

参数

• sender
  类型：System.Object

  调用OnPreRestore的对象。

• args
  类型：Microsoft.SharePoint.Administration.Backup.SPRestoreInformation

  SPRestoreInformation对象，该对象包含有关该操作的数据。

返回值

类型：System.Boolean
true如果成功 ；否则为false。

备注

在大多数情况下，还原操作需要任何准备，和OnPreRestore的实现应只会返回true。

您可能需要与您的实现来完成的事情的一些示例：

• 如果具有未初始化内容对象的Name属性，它与args的SPName参数通过设置使用**GetParameter()**方法，如本示例所示：

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

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

• 如果IBackupRestore对象所表示的内容的组件是某种类型的数据库， OnPreRestore可用于指定连接与数据库应用程序所需的设置信息。

• 如果您的OnPreRestore的实现采用大部分用于备份操作的总时间，设置args。为适当的值CurrentProgess() 。

• 如果您希望最终用户就可以选择迁移备份的内容， OnPreRestore的实现还必须初始化， SPServer， SPName， SPLocation为其当前值。如果不做这种初始化，管理中心应用程序将不提供最终用户可以在其中他或她输入新的服务器、 组件名称或位置的用户界面。在SharePoint Foundation，此 UI 是管理中心应用程序从备份还原-4 步 （共 4页的新名称部分中。（它也是必要的CanRenameOnRestore设置为true。

重要信息
不要停止或暂停服务或 Web 应用程序中的OnPreRestore(Object, SPBackupInformation)方法。请参阅OnRestore(Object, SPBackupInformation)中的原因。

OnPreRestore方法总是在运行时选择了IBackupRestore对象进行恢复。如果它返回false， OnRestore和OnPostRestore方法都不会运行。

另请参阅

引用

IBackupRestore 接口

IBackupRestore 成员

Microsoft.SharePoint.Administration.Backup 命名空间