InstallContext 构造函数

定义

命名空间:

System.Configuration.Install

程序集:

System.Configuration.Install.dll

初始化 InstallContext 类的新实例。

重载

InstallContext()	初始化 InstallContext 类的新实例。
InstallContext(String, String[])	初始化 InstallContext 类的新实例，并创建安装的日志文件。

InstallContext()

初始化 InstallContext 类的新实例。

public:
 InstallContext();

public InstallContext ();

Public Sub New ()

示例

注意

此示例演示如何使用构造函数的重载版本 InstallContext 之一。 有关可能可用的其他示例，请参阅各个重载主题。

当调用程序而不使用任何参数时，将创建一个空 InstallContext 的 。

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

注解

此重载不会为安装创建日志文件。

InstallContext(String, String[])

初始化 InstallContext 类的新实例，并创建安装的日志文件。

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())

参数

logFilePath

String

此安装的日志文件的路径，或者如果无须创建日志文件，则为 null。

commandLine

String[]

运行安装程序时输入的命令行参数，或者如果未输入任何内容，则为 null。

示例

此示例是类的类概述中示例的 InstallContext 摘录。

指定“/LogFile”和“/LogtoConsole”时， InstallContext 通过将相应的参数 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)

注解

如果安装使用 Installutil.exe (安装程序工具) ，则此构造函数会在指定路径处创建日志文件，并将命令行参数数组分析为 Parameters 属性。 如果在命令行参数中指定了日志文件路径，则用于创建该文件。 如果未在命令行中指定日志文件参数，则使用 参数的值 logFilePath 。 若要禁止创建日志文件，请传递“/logfile= ”命令行参数。

调用方说明

调用此构造函数时， logFilePath 在 参数中传递默认日志文件路径。 这是创建日志文件的 ，除非在运行安装可执行文件时使用 /logfile 命令行参数。

另请参阅

• Parameters
• LogMessage(String)