InstallContext コンストラクタ (String, String )

2007-08-14

InstallContext クラスの新しいインスタンスを初期化し、インストール用のログファイルを作成します。

名前空間: System.Configuration.Install
アセンブリ: System.Configuration.Install (system.configuration.install.dll 内)

構文

'宣言
Public Sub New ( _
    logFilePath As String, _
    commandLine As String() _
)
'使用
Dim logFilePath As String
Dim commandLine As String()

Dim instance As New InstallContext(logFilePath, commandLine)

public InstallContext (
    string logFilePath,
    string[] commandLine
)

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

public InstallContext (
    String logFilePath, 
    String[] commandLine
)

public function InstallContext (
    logFilePath : String, 
    commandLine : String[]
)

パラメータ

logFilePath
インストール用のログファイルのパス。ログファイルを作成しない場合は null 参照 (Visual Basic では Nothing)。

commandLine
セットアッププログラムの実行時に入力されたコマンドラインパラメータ。入力されなかった場合は null 参照 (Visual Basic では Nothing)。

解説

インストールにインストーラツール (Installutil.exe) を使用する場合、このコンストラクタは指定したパスにログファイルを作成し、コマンドラインパラメータの配列を解析した結果を Parameters プロパティに格納します。コマンドラインパラメータでログファイルのパスが指定されている場合は、このパスを使用してファイルが作成されます。コマンドラインでログファイルの引数が指定されていない場合は、logFilePath パラメータの値が使用されます。ログファイルを作成しない場合は、"/logfile=" コマンドラインパラメータを渡します。

呼び出し時の注意 このコンストラクタを呼び出すときは、logFilePath パラメータに既定のログファイルパスを渡します。インストール実行可能ファイルの実行時に /logfile コマンドラインパラメータが使用される場合を除いて、指定した場所にログファイルが作成されます。

使用例

この例は、InstallContext クラスの概要で紹介されているクラスの例からの抜粋です。

"/LogFile" および "/LogtoConsole" を指定した場合、それぞれの引数を InstallContext に渡して、InstallContext が作成されます。

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

// 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.
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.set_Item(i, args[i]);
}
myInstallObject.myInstallContext = 
    new InstallContext(args[0], commandLine);

.NET Framework のセキュリティ

直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework

サポート対象 : 2.0、1.1、1.0