Installer.Install(IDictionary) 메서드

정의

네임스페이스:

System.Configuration.Install

어셈블리:

System.Configuration.Install.dll

파생 클래스에서 재정의할 때 설치를 수행합니다.

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입니다.

예외

ArgumentException

stateSaver 매개 변수가 null인 경우

Exception

컬렉션에 있는 설치 관리자 중 하나의 BeforeInstall 이벤트 처리기에 예외가 발생한 경우

또는

컬렉션에 있는 설치 관리자 중 하나의 AfterInstall 이벤트 처리기에 예외가 발생한 경우

예제

다음 예제에서는 클래스의 Install 메서드를 보여 줍니다 Installer . 클래스는 기본 클래스에서 Installer 파생되고 메서드는 재정의 Install 됩니다.

   // 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) 메서드를 호출해야 합니다. 메서드는 Install(IDictionary) 이 instance 속성에 Installers 포함된 각 설치 관리자의 메서드를 호출 Install(IDictionary) 합니다. 포함된 설치 관리자를 실행한 후 이 메서드는 개체(매개 변수를 통해 stateSaver 지정됨)를 업데이트 IDictionary 하여 설치의 상태 반영합니다. 메서드에 전달 Install(IDictionary) 될 때 는 IDictionary 비어 있어야 합니다. 모든 경우는 Install(IDictionary) 메서드 성공는 Commit(IDictionary) 메서드가 호출 됩니다. 그렇지 않으면 메서드가 Rollback(IDictionary) 호출됩니다.

• 메서드의 컬렉션 Install(IDictionary) 에 설치 관리자 인스턴스를 추가해야 하는 Installers 경우 메서드의 컬렉션에 Uninstall(IDictionary) 동일한 추가를 수행해야 합니다. 그러나 사용자 지정 설치 관리자에 대한 클래스 생성자의 컬렉션에 설치 관리자 인스턴스를 Installers 추가하는 경우 두 방법 모두에서 컬렉션을 유지 관리하지 않도록 할 수 있습니다.

추가 정보

• Commit(IDictionary)
• IDictionary
• InstallerCollection
• Installers
• Rollback(IDictionary)
• Uninstall(IDictionary)