EventSourceCreationData.LogName Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen des Namens des Ereignisprotokolls, in das die Quelle Einträge schreibt.
public:
property System::String ^ LogName { System::String ^ get(); void set(System::String ^ value); };public string LogName { get; set; }member this.LogName : string with get, setPublic Property LogName As StringEigenschaftswert
Der Name des Ereignisprotokolls. Dies kann ein Anwendungs-, System- oder ein benutzerdefinierter Protokollname sein. Der Standardwert ist "Application".
Beispiele
Im folgenden Codebeispiel werden die Konfigurationseigenschaften für eine Ereignisquelle aus Befehlszeilenargumenten festgelegt. Die Eingabeargumente geben den Namen der Ereignisquelle, den Namen des Ereignisprotokolls, den Computernamen und die Ressourcendatei für Ereignisnachrichten an. Dieses Beispiel ist Teil eines größeren Beispiels, das für die EventSourceCreationData Klasse bereitgestellt wird.
EventSourceCreationData mySourceData = new EventSourceCreationData("", "");
bool registerSource = true;
// Process input parameters.
if (args.Length > 0)
{
// Require at least the source name.
mySourceData.Source = args[0];
if (args.Length > 1)
{
mySourceData.LogName = args[1];
}
if (args.Length > 2)
{
mySourceData.MachineName = args[2];
}
if ((args.Length > 3) && (args[3].Length > 0))
{
mySourceData.MessageResourceFile = args[3];
}
}
else
{
// Display a syntax help message.
Console.WriteLine("Input:");
Console.WriteLine(" source [event log] [machine name] [resource file]");
registerSource = false;
}
// Set defaults for parameters missing input.
if (mySourceData.MachineName.Length == 0)
{
// Default to the local computer.
mySourceData.MachineName = ".";
}
if (mySourceData.LogName.Length == 0)
{
// Default to the Application log.
mySourceData.LogName = "Application";
}
Dim mySourceData As EventSourceCreationData = new EventSourceCreationData("", "")
Dim registerSource As Boolean = True
' Process input parameters.
If args.Length > 0
' Require at least the source name.
mySourceData.Source = args(0)
If args.Length > 1
mySourceData.LogName = args(1)
End If
If args.Length > 2
mySourceData.MachineName = args(2)
End If
If args.Length > 3 AndAlso args(3).Length > 0
mySourceData.MessageResourceFile = args(3)
End If
Else
' Display a syntax help message.
Console.WriteLine("Input:")
Console.WriteLine(" source [event log] [machine name] [resource file]")
registerSource = False
End If
' Set defaults for parameters missing input.
If mySourceData.MachineName.Length = 0
' Default to the local computer.
mySourceData.MachineName = "."
End If
If mySourceData.LogName.Length = 0
' Default to the Application log.
mySourceData.LogName = "Application"
End If
Hinweise
Verwenden Sie die LogName Eigenschaft, um das Ereignisprotokoll zu identifizieren, in das ihre Anwendung Einträge in die Verwendung der neuen Quelle schreibt. Das Ereignisprotokoll kann ein neues Protokoll oder ein vorhandenes Protokoll sein. Anwendungen und Dienste sollten in das Anwendungsprotokoll oder ein benutzerdefiniertes Protokoll schreiben. Gerätetreiber sollten in das Systemprotokoll schreiben. Wenn Sie die LogName Eigenschaft nicht explizit festlegen, wird das Ereignisprotokoll standardmäßig im Anwendungsprotokoll gespeichert.
Hinweis
Das Sicherheitsprotokoll ist schreibgeschützt.
Wenn Sie ein vorhandenes Protokoll für die neue Quelle als Ziel festlegen möchten, legen Sie die LogName Eigenschaft auf den namen des vorhandenen Ereignisprotokolls fest. Um ein neues Ereignisprotokoll für die Quelle zu erstellen, müssen Sie die LogName Eigenschaft festlegen. Ereignisprotokollnamen müssen aus druckbaren Zeichen bestehen und dürfen die Zeichen '*', '?' oder '\' nicht enthalten. Die ersten 8 Zeichen des Ereignisprotokollnamens müssen sich von den ersten 8 Zeichen vorhandener Namen von Ereignisprotokollen auf dem angegebenen Computer unterscheiden.
Das Betriebssystem speichert Ereignisprotokolle als Dateien. Wenn Sie ein neues Ereignisprotokoll mithilfe EventLogInstaller oder der CreateEventSource Methode erstellen, wird die zugeordnete Datei im Verzeichnis %SystemRoot%\System32\Config auf dem angegebenen Computer gespeichert. Der Dateiname wird festgelegt, indem die ersten 8 Zeichen der LogName Eigenschaft mit der Dateinamenerweiterung ".evt" angefügt werden.
