EventSourceCreationData.LogName Vlastnost

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.EventLog.dll

Zdroj:

EventSourceCreationData.cs

Získá nebo nastaví název protokolu událostí, do kterého zdroj zapisuje položky.

public:
 property System::String ^ LogName { System::String ^ get(); void set(System::String ^ value); };

public string LogName { get; set; }

member this.LogName : string with get, set

Public Property LogName As String

Hodnota vlastnosti

String

Název protokolu událostí. Může se jednat o název aplikace, systému nebo vlastního protokolu. Výchozí hodnota je "Application" (Aplikace).

Příklady

Následující příklad kódu nastaví vlastnosti konfigurace pro zdroj události z argumentů příkazového řádku. Vstupní argumenty určují název zdroje událostí, název protokolu událostí, název počítače a soubor prostředků zprávy události. Tento příklad je součástí většího příkladu poskytnutého EventSourceCreationData pro třídu.

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

Poznámky

LogName Pomocí vlastnosti identifikujte protokol událostí, do kterého vaše aplikace zapisuje položky do nového zdroje. Protokol událostí může být nový protokol nebo existující protokol. Aplikace a služby by měly zapisovat do protokolu aplikace nebo do vlastního protokolu. Ovladače zařízení by se měly zapisovat do systémového protokolu. Pokud vlastnost explicitně nenastavíte LogName , protokol událostí se ve výchozím nastavení nastaví do protokolu aplikace.

Poznámka:

Protokol zabezpečení je jen pro čtení.

Pokud chcete cílit na existující protokol pro nový zdroj, nastavte LogName vlastnost na název existujícího protokolu událostí. Chcete-li vytvořit nový protokol událostí pro zdroj, musíte nastavit LogName vlastnost. Názvy protokolů událostí musí obsahovat tisknutelné znaky a nesmí obsahovat znaky *, ?nebo \. Prvních 8 znaků názvu protokolu událostí se musí lišit od prvních 8 znaků existujících názvů protokolů událostí v zadaném počítači.

Operační systém ukládá protokoly událostí jako soubory. Pokud použijete EventLogInstaller nebo metodu CreateEventSource k vytvoření nového protokolu událostí, přidružený soubor je uložen v adresáři %SystemRoot%\System32\Config v zadaném počítači. Název souboru je nastaven připojením prvních 8 znaků LogName vlastnosti s příponou názvu souboru .evt.

Viz také

• Log
• Exists(String)