EventSourceCreationData.LogName Proprietà

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Pacchetto:

System.Diagnostics.EventLog v8.0.0

Source:

EventSourceCreationData.cs

Ottiene o imposta il nome del log eventi nel quale l'origine scrive le voci.

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

Valore della proprietà

String

Nome del log eventi. Può trattarsi di un nome di log personalizzato o dei log Applicazione o Sistema. Il valore predefinito è "Applicazione".

Esempio

Nell'esempio di codice seguente vengono impostate le proprietà di configurazione per un'origine evento dagli argomenti della riga di comando. Gli argomenti di input specificano il nome dell'origine evento, il nome del registro eventi, il nome del computer e il file di risorse del messaggio di evento. Questo esempio fa parte di un esempio più ampio fornito per la EventSourceCreationData classe .

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

Commenti

Usare la LogName proprietà per identificare il registro eventi in cui l'applicazione scrive le voci usando la nuova origine. Il registro eventi può essere un nuovo log o un log esistente. Le applicazioni e i servizi devono scrivere nel log applicazioni o in un log personalizzato. I driver di dispositivo devono scrivere nel log di sistema. Se la proprietà non viene impostata LogName in modo esplicito, per impostazione predefinita il registro eventi viene impostato sul registro applicazioni.

Nota

Il log di sicurezza è di sola lettura.

Per impostare come destinazione un log esistente per la nuova origine, impostare la LogName proprietà sul nome del registro eventi esistente. Per creare un nuovo registro eventi per l'origine, è necessario impostare la LogName proprietà . I nomi del registro eventi devono essere costituiti da caratteri stampabili e non possono includere i caratteri '*', '?' o '\'. I primi 8 caratteri del nome del registro eventi devono essere diversi dai primi 8 caratteri dei nomi esistenti dei registri eventi nel computer specificato.

Il sistema operativo archivia i registri eventi come file. Quando si utilizza EventLogInstaller o il CreateEventSource metodo per creare un nuovo registro eventi, il file associato viene archiviato nella directory %SystemRoot%\System32\Config nel computer specificato. Il nome del file viene impostato aggiungendo i primi 8 caratteri della LogName proprietà con l'estensione del nome di file ".evt".

Vedi anche

• Log
• Exists(String)