InstallContext Constructeurs

Définition

Espace de noms:

System.Configuration.Install

Assembly:

System.Configuration.Install.dll

Initialise une nouvelle instance de la classe InstallContext.

Surcharges

InstallContext()	Initialise une nouvelle instance de la classe InstallContext.
InstallContext(String, String[])	Initialise une nouvelle instance de la classe InstallContext et crée un fichier journal pour l'installation.

InstallContext()

Initialise une nouvelle instance de la classe InstallContext.

public:
 InstallContext();

public InstallContext ();

Public Sub New ()

Exemples

Notes

Cet exemple montre comment utiliser l’une des versions surchargées du InstallContext constructeur. Pour obtenir d’autres exemples qui peuvent être disponibles, consultez les rubriques de surcharge individuelles.

Lorsque le programme est appelé sans arguments, un vide InstallContext est créé.

// There are no command line arguments, create an empty 'InstallContext'.
myInstallObject->myInstallContext = gcnew InstallContext;

// There are no command line arguments, create an empty 'InstallContext'.
myInstallObject.myInstallContext = new InstallContext();

' There are no command line arguments, create an empty 'InstallContext'.
myInstallObject.myInstallContext = New InstallContext()

Remarques

Cette surcharge ne crée pas de fichier journal pour l’installation.

InstallContext(String, String[])

Initialise une nouvelle instance de la classe InstallContext et crée un fichier journal pour l'installation.

public:
 InstallContext(System::String ^ logFilePath, cli::array <System::String ^> ^ commandLine);

public InstallContext (string logFilePath, string[] commandLine);

new System.Configuration.Install.InstallContext : string * string[] -> System.Configuration.Install.InstallContext

Public Sub New (logFilePath As String, commandLine As String())

Paramètres

logFilePath

String

Chemin d'accès du fichier journal pour cette installation, ou null si aucun fichier journal ne doit être créé.

commandLine

String[]

Paramètres de ligne de commande entrés lors de l'exécution du programme d'installation, ou null si aucun paramètre n'a été entré.

Exemples

Cet exemple est un extrait de l’exemple dans la vue d’ensemble de la classe de la InstallContext classe.

Lorsque « /LogFile » et « /LogtoConsole » sont spécifiés, le InstallContext est créé en passant les arguments respectifs à InstallContext.

// Create an InstallContext object with the given parameters.
array<String^>^commandLine = gcnew array<String^>(args->Length - 1);
for ( int i = 0; i < args->Length - 1; i++ )
{
   commandLine[ i ] = args[ i + 1 ];
}
myInstallObject->myInstallContext = gcnew InstallContext( args[ 1 ],commandLine );

// Create an InstallContext object with the given parameters.
String[] commandLine = new string[ args.Length ];
for( int i = 0; i < args.Length; i++ )
{
   commandLine[ i ] = args[ i ];
}
myInstallObject.myInstallContext = new InstallContext( args[ 0 ], commandLine);

' Create an InstallContext object with the given parameters.
Dim commandLine() As String = New String(args.Length - 2) {}
Dim i As Integer
For i = 1 To args.Length - 1
   commandLine(i-1) = args(i)
Next i
myInstallObject.myInstallContext = _
   New InstallContext("/LogFile:example.log", commandLine)

Remarques

Si l’installation utilise Installutil.exe (Outil d’installation), ce constructeur crée un fichier journal au niveau du chemin spécifié et analyse le tableau des paramètres de ligne de commande dans la Parameters propriété . Si un chemin d’accès de fichier journal est spécifié dans les paramètres de ligne de commande, il est utilisé pour créer le fichier. Si l’argument du fichier journal n’est pas spécifié dans la ligne de commande, la valeur du logFilePath paramètre est utilisée. Pour supprimer la création d’un fichier journal, passez le paramètre de ligne de commande « /logfile= ».

Notes pour les appelants

Transmettez votre chemin de fichier journal par défaut dans le logFilePath paramètre lorsque vous appelez ce constructeur. Il s’agit de l’emplacement où le fichier journal est créé, sauf si le paramètre de ligne de commande /logfile est utilisé lors de l’exécution de l’exécutable d’installation.

Voir aussi

• Parameters
• LogMessage(String)