InstallContext.LogMessage-Methode

Gibt eine Meldung an die Konsole und in die Protokolldatei für die Installation aus.

Namespace: System.Configuration.Install
Assembly: System.Configuration.Install (in system.configuration.install.dll)

Syntax

'Declaration
Public Sub LogMessage ( _
    message As String _
)
'Usage
Dim instance As InstallContext
Dim message As String

instance.LogMessage(message)

public void LogMessage (
    string message
)

public:
void LogMessage (
    String^ message
)

public void LogMessage (
    String message
)

public function LogMessage (
    message : String
)

Parameter

• message
  Die zu schreibende Meldung.

Hinweise

Diese Methode kann von einem Installationsprogramm aufgerufen werden, um Fortschritts- und andere Statusmeldungen in die Protokolldatei zu schreiben. Wenn durch die Befehlszeilenparameter festgelegt wird, dass eine Benutzeroberfläche angezeigt werden soll, sollte das Installationsprogramm zusätzlich zum Aufrufen der LogMessage-Methode Meldungsfenster anzeigen oder Abfragen ausführen. In die Protokolldatei geschriebener Text wird dem Benutzer nur dann angezeigt, wenn die Installation mit InstallUtil.exe ausgeführt wird und in der Befehlszeile "/LogToConsole= true" festgelegt ist.

Beispiel

Dieses Beispiel ist ein Auszug aus dem Beispiel in der Klassenübersicht zur InstallContext-Klasse.

Darin wird mit der IsParameterTrue-Methode bestimmt, ob der LogtoConsole-Parameter festgelegt wurde. Bei yes werden anschließend mit der LogMessage-Methode Statusmeldungen in die Installationsprotokolldatei und auf die Konsole geschrieben.

' Check wether the "LogtoConsole" parameter has been set.
If myInstallContext.IsParameterTrue("LogtoConsole") = True Then
   ' Display the message to the console and add it to the logfile.
   myInstallContext.LogMessage("The 'Install' method has been called")
End If

// Check whether the "LogtoConsole" parameter has been set.
if( myInstallContext.IsParameterTrue( "LogtoConsole" ) == true )
{
   // Display the message to the console and add it to the logfile.
   myInstallContext.LogMessage( "The 'Install' method has been called" );
}

// Check whether the "LogtoConsole" parameter has been set.
if ( myInstallContext->IsParameterTrue( "LogtoConsole" ) )
{
   // Display the message to the console and add it to the logfile.
   myInstallContext->LogMessage( "The 'Install' method has been called" );
}

// Check whether the "LogtoConsole" parameter has been set.
if (myInstallContext.IsParameterTrue("LogtoConsole") == true) {
    // Display the message to the console and add it
    //to the logfile.
    myInstallContext.LogMessage(
        "The 'Install' method has been called");
}

.NET Framework-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

InstallContext-Klasse
InstallContext-Member
System.Configuration.Install-Namespace
Parameters