Installer.Rollback(IDictionary) 方法

  • 參考

定義

命名空間:
System.Configuration.Install
組件:
System.Configuration.Install.dll

當在衍生類別中被覆寫時，還原電腦安裝之前的狀態。

public:
 virtual void Rollback(System::Collections::IDictionary ^ savedState);
public virtual void Rollback (System.Collections.IDictionary savedState);
abstract member Rollback : System.Collections.IDictionary -> unit
override this.Rollback : System.Collections.IDictionary -> unit
Public Overridable Sub Rollback (savedState As IDictionary)

參數

savedState
IDictionary

IDictionary，包含電腦的安裝前狀態。

例外狀況

ArgumentException

savedState 參數為 null。

-或-

IDictionary 的儲存狀態可能已經損毀。

InstallException

在安裝的 Rollback(IDictionary) 階段時發生例外狀況。 這個例外狀況會被忽略，復原會繼續進行。 不過，復原完成之後，電腦可能無法完全還原至其初始狀態。

範例

下列範例示範 Rollback 的 Installer方法。 方法 Rollback 會在的 Installer衍生類別中覆寫。 產生例外狀況以強制安裝復原。

   // Override 'Rollback' method of Installer class.
public:
   virtual void Rollback( IDictionary^ mySavedState ) override
   {
      Installer::Rollback( mySavedState );
      Console::WriteLine( "The Rollback method of 'MyInstallerSample'" +
                         " has been called" );
   }

// Override 'Rollback' method of Installer class.
public override void Rollback( IDictionary mySavedState )
{
   base.Rollback( mySavedState );
   Console.WriteLine( "The Rollback method of 'MyInstallerSample'" +
                     " has been called" );
}

' Override 'Rollback' method of Installer class.
Public Overrides Sub Rollback(mySavedState As IDictionary)
   MyBase.Rollback(mySavedState)
   Console.WriteLine("The Rollback method of 'MyInstallerSample'" + _
                                                " has been called")
End Sub

給繼承者的注意事項

當您覆寫 Rollback(IDictionary) 衍生類別中的 方法時，請務必先在衍生方法中呼叫基類 Rollback(IDictionary) 的 方法。 復原作業會將計算機還原到安裝發生之前所在的狀態。 Rollback(IDictionary)如果Install(IDictionary)這個 實例的 Installer方法或任何安裝程式集合中的安裝程式無法正確執行，就會呼叫 方法。 系統會忽略透過呼叫 Rollback(IDictionary) 安裝程式集合中安裝程式方法所產生的任何例外狀況，並繼續復原其他安裝程式。

適用於

另請參閱