EventSourceCreationData.LogName Vlastnost

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.EventLog.dll

Balíček:

System.Diagnostics.EventLog v8.0.0

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 to být název aplikace, systém nebo vlastní název protokolu. Výchozí hodnota je "Aplikace".

Příklady

Následující příklad kódu nastaví vlastnosti konfigurace pro zdroj událostí 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 = gcnew EventSourceCreationData( "","" );
bool registerSource = true;

// Process input parameters.
if ( args->Length > 1 )
{
   
   // Require at least the source name.
   mySourceData->Source = args[ 1 ];
   if ( args->Length > 2 )
   {
      mySourceData->LogName = args[ 2 ];
   }

   if ( args->Length > 3 )
   {
      mySourceData->MachineName = args[ 3 ];
   }

   if ( (args->Length > 4) && (args[ 4 ]->Length > 0) )
   {
      mySourceData->MessageResourceFile = args[ 4 ];
   }
}
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";
}

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 pomocí nového zdroje. Protokol událostí může být nový protokol nebo existující protokol. Aplikace a služby by se měly zapisovat do aplikačního protokolu 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í na Protokol aplikace.

Poznámka

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

Pokud chcete cílit na existující protokol nového zdroje, nastavte LogName vlastnost na název existujícího protokolu událostí. Pokud chcete 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. Při použití EventLogInstaller metody nebo CreateEventSource k vytvoření nového protokolu událostí je přidružený soubor uložen v adresáři %SystemRoot%\System32\Config v zadaném počítači. Název souboru se nastaví připojením prvních 8 znaků LogName vlastnosti k příponě názvu souboru ".evt".

Viz také

• Log
• Exists(String)