IBackupRestore.OnPreRestore method
提供還原準備處理。
Namespace: Microsoft.SharePoint.Administration.Backup
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'宣告
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
Type: System.Object呼叫OnPreRestore物件。
args
Type: Microsoft.SharePoint.Administration.Backup.SPRestoreInformationSPRestoreInformation物件包含關於作業的資料。
傳回值
Type: System.Boolean
true如果成功 ;否則,請false。
備註
在大多數情況下,還原作業需要沒有準備並實作OnPreRestore應該只會傳回true。
您可能需要一些事項的範例完成實作:
如果尚未初始化內容物件的Name屬性,將它設argsSPName參數搭配使用**GetParameter()**方法,在此範例所示:
this.Name = args.GetParameter(SPBackupRestoreObject.SPName);
Me.Name = args.GetParameter(SPBackupRestoreObject.SPName)
如果資料庫某種內容IBackupRestore物件所代表的元件, OnPreRestore可用來指定要連線之資料庫應用程式與所需的設定資訊。
如果您的OnPreRestore實作需備份作業的總時間重要部分,設定args。**CurrentProgess()**適當的值。
如果您希望使用者可以選擇移轉完成備份的內容,必須也會初始化OnPreRestore實作, SPServer、 SPName,以及SPLocation為其目前的值。如果您不會做此初始化,管理中心應用程式不會顯示使用者與在其中一次可以輸入新的伺服器、 元件名稱或位置的 UI。在SharePoint Foundation,此 UI 是在 [新增名稱] 區段中的 [從備份還原-步驟 4 之 4 ] 頁面上的管理中心應用程式。(它是也需要該CanRenameOnRestore設為true)。
重要
請勿停止或暫停服務或OnPreRestore(Object, SPBackupInformation)方法中的 Web 應用程式。請參閱 < OnRestore(Object, SPBackupInformation)的原因。
還原已選取IBackupRestore物件時,一律會執行OnPreRestore方法。如果它會傳回false,將會執行OnRestore皆OnPostRestore方法。