AssemblyInstaller.Install(IDictionary) Metoda

Definice

Obor názvů:

System.Configuration.Install

Sestavení:

System.Configuration.Install.dll

Provede instalaci.

public:
 override void Install(System::Collections::IDictionary ^ savedState);

public override void Install (System.Collections.IDictionary savedState);

override this.Install : System.Collections.IDictionary -> unit

Public Overrides Sub Install (savedState As IDictionary)

Parametry

savedState

IDictionary

Slouží IDictionary k uložení informací potřebných k provedení operace potvrzení, vrácení zpět nebo odinstalace.

Výjimky

ArgumentException

Parametr savedState je null.

-nebo-

Soubor nebyl nalezen.

Exception

V obslužné rutině BeforeInstall události jednoho z instalačních programů v kolekci došlo k výjimce.

-nebo-

V obslužné rutině AfterInstall události jednoho z instalačních programů v kolekci došlo k výjimce.

-nebo-

V jednom ze sestavení nebyly nalezeny typy instalačního programu.

-nebo-

Instanci jednoho z typů instalačního programu nelze vytvořit.

Příklady

Následující příklad ukazuje AssemblyInstaller konstruktor a Install metody a třídy AssemblyInstaller .Commit

Objekt AssemblyInstaller třídy je vytvořen vyvoláním konstruktoru AssemblyInstaller . Vlastnosti tohoto objektu Install jsou nastaveny a metody a Commit jsou volány pro instalaci sestavení "MyAssembly_Install.exe".

#using <System.dll>
#using <System.Configuration.Install.dll>

using namespace System;
using namespace System::Configuration::Install;
using namespace System::Collections;
using namespace System::Collections::Specialized;
void main()
{
   IDictionary^ mySavedState = gcnew Hashtable;
   Console::WriteLine( "" );
   try
   {
      // Set the commandline argument array for 'logfile'.
      array<String^>^myString = {"/logFile=example.log"};
      
      // Create an Object* of the 'AssemblyInstaller' class.
      AssemblyInstaller^ myAssemblyInstaller = gcnew AssemblyInstaller;

      // Set the properties to install the required assembly.
      myAssemblyInstaller->Path = "MyAssembly_Install.exe";
      myAssemblyInstaller->CommandLine = myString;
      myAssemblyInstaller->UseNewContext = true;
      
      // Clear the 'IDictionary' Object*.
      mySavedState->Clear();
      
      // Install the 'MyAssembly_Install' assembly.
      myAssemblyInstaller->Install( mySavedState );
      
      // Commit the 'MyAssembly_Install' assembly.
      myAssemblyInstaller->Commit( mySavedState );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( e );
   }
}

using System;
using System.Configuration.Install;
using System.Collections;
using System.Collections.Specialized;

class MyInstallClass
{
   static void Main()
   {
      IDictionary mySavedState = new Hashtable();

      Console.WriteLine( "" );

      try
      {
         // Set the commandline argument array for 'logfile'.
         string[] myString = new string[ 1 ];
         myString[ 0 ] = "/logFile=example.log";

         // Create an object of the 'AssemblyInstaller' class.
         AssemblyInstaller myAssemblyInstaller = new AssemblyInstaller();

         // Set the properties to install the required assembly.
         myAssemblyInstaller.Path = "MyAssembly_Install.exe";
         myAssemblyInstaller.CommandLine = myString;
         myAssemblyInstaller.UseNewContext = true;

         // Clear the 'IDictionary' object.
         mySavedState.Clear();

         // Install the 'MyAssembly_Install' assembly.
         myAssemblyInstaller.Install( mySavedState );

         // Commit the 'MyAssembly_Install' assembly.
         myAssemblyInstaller.Commit( mySavedState );
      }
      catch( Exception )
      {
      }
   }
}

Imports System.Configuration.Install
Imports System.Collections
Imports System.Collections.Specialized

Class MyInstallClass
   
   Shared Sub Main()
      Dim mySavedState = New Hashtable()
      
      Console.WriteLine("")
      

      Try
         ' Set the commandline argument array for 'logfile'.
         Dim myString(0) As String
         myString(0) = "/logFile=example.log"
         ' Create an object of the 'AssemblyInstaller' class.
         Dim myAssemblyInstaller As New AssemblyInstaller()
         ' Set the properties to install the required assembly.
         myAssemblyInstaller.Path = "MyAssembly_Install.exe"
         myAssemblyInstaller.CommandLine = myString
         myAssemblyInstaller.UseNewContext = True
         
         ' Clear the 'IDictionary' object.
         mySavedState.Clear()
         
         ' Install the 'MyAssembly_Install' assembly.
         myAssemblyInstaller.Install(mySavedState)
         
         ' Commit the 'MyAssembly_Install' assembly.
         myAssemblyInstaller.Commit(mySavedState)
      Catch
      End Try

   End Sub
End Class

Poznámky

Tato metoda volá metodu Install každého instalačního programu obsaženého ve Installers vlastnosti této instance. Objekt IDictionary určený parametrem savedState se aktualizuje tak, aby odrážel stav instalace po spuštění instalačních programů s omezením. Pokud jsou všechny Install metody úspěšné, volá se Commit metoda. V opačném Rollback případě je volána metoda.

Poznámky pro volající

Parametr IDictionary zadaný parametrem savedState by měl být při předání Install(IDictionary) metodě prázdný.