EventSourceCreationData.LogName Właściwość

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.EventLog.dll

Pakiet:

System.Diagnostics.EventLog v8.0.0

Źródło:

EventSourceCreationData.cs

Pobiera lub ustawia nazwę dziennika zdarzeń, do którego źródło zapisuje wpisy.

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

Wartość właściwości

String

Nazwa dziennika zdarzeń. Może to być nazwa aplikacji, systemu lub niestandardowego dziennika. Wartość domyślna to "Aplikacja".

Przykłady

Poniższy przykład kodu ustawia właściwości konfiguracji źródła zdarzeń z argumentów wiersza polecenia. Argumenty wejściowe określają nazwę źródła zdarzeń, nazwę dziennika zdarzeń, nazwę komputera i plik zasobu komunikatu o zdarzeniu. Ten przykład jest częścią większego przykładu udostępnionego EventSourceCreationData dla klasy.

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

Uwagi

LogName Użyj właściwości , aby zidentyfikować dziennik zdarzeń, do którego aplikacja zapisuje wpisy przy użyciu nowego źródła. Dziennik zdarzeń może być nowym dziennikiem lub istniejącym dziennikiem. Aplikacje i usługi powinny zapisywać w dzienniku aplikacji lub dzienniku niestandardowym. Sterowniki urządzeń powinny zapisywać w dzienniku systemu. Jeśli właściwość nie zostanie jawnie ustawiona, dziennik zdarzeń zostanie domyślnie ustawiony LogName na dziennik aplikacji.

Uwaga

Dziennik zabezpieczeń jest tylko do odczytu.

Aby kierować istniejący dziennik dla nowego źródła, ustaw LogName właściwość na istniejącą nazwę dziennika zdarzeń. Aby utworzyć nowy dziennik zdarzeń dla źródła, należy ustawić LogName właściwość . Nazwy dziennika zdarzeń muszą składać się z znaków drukowalnych i nie mogą zawierać znaków "*", "?" lub "\". Pierwsze 8 znaków nazwy dziennika zdarzeń musi się różnić od pierwszych 8 znaków istniejących nazw dzienników zdarzeń na określonym komputerze.

System operacyjny przechowuje dzienniki zdarzeń jako pliki. W przypadku użycia EventLogInstaller metody lub CreateEventSource utworzenia nowego dziennika zdarzeń skojarzony plik jest przechowywany w katalogu %SystemRoot%\System32\Config na określonym komputerze. Nazwa pliku jest ustawiana przez dołączenie pierwszych 8 znaków LogName właściwości z rozszerzeniem nazwy pliku ".evt".

Zobacz też

• Log
• Exists(String)