Installer.Install(IDictionary) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Configuration.Install

Assembly:: System.Configuration.Install.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Quando ne viene eseguito l'override in una classe derivata, esegue l'installazione.

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)

Parametri

stateSaver: IDictionary

Oggetto IDictionary usato per salvare le informazioni necessarie per eseguire un'operazione di commit, di rollback o di disinstallazione.

Eccezioni

ArgumentException

Il valore del parametro stateSaver è null.

Exception

È stata generata un'eccezione nel gestore eventi BeforeInstall di uno dei programmi di installazione contenuti nell'insieme.

-oppure-

È stata generata un'eccezione nel gestore eventi AfterInstall di uno dei programmi di installazione contenuti nell'insieme.

Esempio

Nell'esempio seguente viene illustrato il Install metodo della Installer classe . Una classe è derivata dalla Installer classe di base e il Install metodo viene sottoposto a override.

   // 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

Note per gli eredi

Se si esegue l'override del Install(IDictionary) metodo in una classe derivata, assicurarsi di chiamare prima il metodo della classe di Install(IDictionary) base nel metodo derivato. Il Install(IDictionary) metodo chiama il Install(IDictionary) metodo di ogni programma di installazione contenuto nella Installers proprietà di questa istanza. Dopo l'esecuzione dei programmi di installazione contenuti, questo metodo aggiorna l'oggetto IDictionary (specificato tramite il stateSaver parametro ) in modo da riflettere lo stato dell'installazione. Deve IDictionary essere vuoto quando viene passato al Install(IDictionary) metodo . Se tutti i Install(IDictionary) metodi hanno esito positivo, viene chiamato il Commit(IDictionary) metodo . In caso contrario, viene chiamato il Rollback(IDictionary) metodo .
Se è necessario aggiungere istanze del programma di installazione alla Installers raccolta nel Install(IDictionary) metodo , assicurarsi di eseguire le stesse aggiunte alla raccolta nel Uninstall(IDictionary) metodo . Tuttavia, è possibile evitare di mantenere la raccolta in entrambi i metodi se si aggiungono istanze del Installers programma di installazione alla raccolta nel costruttore della classe per il programma di installazione personalizzato.

Si applica a