Installer.Install(IDictionary) 메서드

정의

파생 클래스에서 재정의할 때 설치를 수행합니다.When overridden in a derived class, performs the installation.

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

매개 변수

stateSaver
IDictionary

커밋, 롤백 또는 제거 작업 수행에 필요한 정보를 저장하는 데 사용되는 IDictionary입니다.An IDictionary used to save information needed to perform a commit, rollback, or uninstall operation.

예외

stateSaver 매개 변수가 null인 경우The stateSaver parameter is null.

컬렉션에 있는 설치 관리자 중 하나의 BeforeInstall 이벤트 처리기에 예외가 발생한 경우An exception occurred in the BeforeInstall event handler of one of the installers in the collection.

또는-or- 컬렉션에 있는 설치 관리자 중 하나의 AfterInstall 이벤트 처리기에 예외가 발생한 경우An exception occurred in the AfterInstall event handler of one of the installers in the collection.

예제

다음 예제는 Install 메서드는 Installer 클래스입니다.The following example demonstrates the Install method of the Installer class. 클래스에서 파생 되는 Installer 기본 클래스 및 Install 메서드를 재정의 합니다.A class is derived from the Installer base class and the Install method is overridden.

   // Override the 'Install' method of the Installer class.
public:
   virtual void Install( IDictionary^ mySavedState ) override
   {
      Installer::Install( mySavedState );
      // Code maybe written for installation of an application.
      Console::WriteLine( "The Install method of 'MyInstallerSample' has been called" );
   }
// Override the 'Install' method of the Installer class.
public override void Install( IDictionary mySavedState )
{
   base.Install( mySavedState );
   // Code maybe written for installation of an application.
   Console.WriteLine( "The Install method of 'MyInstallerSample' has been called" );
}
' Override the 'Install' method of the Installer class.
Public Overrides Sub Install(mySavedState As IDictionary)
   MyBase.Install(mySavedState)
   ' Code maybe written for installation of an application.
   Console.WriteLine("The Install method of 'MyInstallerSample' has been called")
End Sub

상속자 참고

-재정의 하는 경우는 Install(IDictionary) 파생된 클래스에서 메서드를 기본 클래스를 호출 해야 Install(IDictionary) 메서드를 먼저 파생된 메서드.- If you override the Install(IDictionary) method in a derived class, be sure to call the base class's Install(IDictionary) method first in your derived method. 합니다 Install(IDictionary) 메서드 호출을 Install(IDictionary) 에 포함 된 각 설치 관리자의 메서드는 Installers 이 인스턴스의 속성입니다.The Install(IDictionary) method calls the Install(IDictionary) method of each installer contained in the Installers property of this instance. 포함된 된 설치 관리자를 실행 한 후이 메서드를 업데이트 합니다 IDictionary 개체 (통해 지정 된는 stateSaver 매개 변수) 설치의 상태를 반영 하도록 합니다.After the contained installers run, this method updates the IDictionary object (specified through the stateSaver parameter) to reflect the status of the installation. 합니다 IDictionary 에 전달 될 때 비어 있어야 합니다 Install(IDictionary) 메서드.The IDictionary should be empty when passed to the Install(IDictionary) method. 모든 경우는 Install(IDictionary) 메서드 성공는 Commit(IDictionary) 메서드가 호출 됩니다.If all the Install(IDictionary) methods succeed, the Commit(IDictionary) method is called. 그렇지 않은 경우는 Rollback(IDictionary) 메서드가 호출 됩니다.Otherwise, the Rollback(IDictionary) method is called.

-설치 관리자 인스턴스를 추가 해야 하는 경우는 Installers 컬렉션에는 Install(IDictionary) 메서드를 컬렉션에 동일한 추가 수행 해야 합니다 Uninstall(IDictionary) 메서드.- If you need to add installer instances to the Installers collection in the Install(IDictionary) method, be sure to perform the same additions to the collection in the Uninstall(IDictionary) method. 설치 관리자 인스턴스를 추가 하는 경우 모두 메서드 컬렉션을 유지 관리를 방지할 수는 있지만 Installers 사용자 지정 설치 관리자에 대 한 클래스 생성자의 컬렉션입니다.However, you can avoid maintaining the collection in both methods if you add installer instances to the Installers collection in the class constructor for your custom installer.

적용 대상

추가 정보