EventSourceCreationData.LogName Propriété

Définition

Obtient ou définit le nom du journal des événements dans lequel la source écrit des entrées.

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

Valeur de propriété

Nom du journal des événements. Il peut s'agir d'application, système ou d'un nom de journal personnalisé. La valeur par défaut est « application ».

Exemples

L’exemple de code suivant définit les propriétés de configuration d’une source d’événement à partir d’arguments de ligne de commande. Les arguments d’entrée spécifient le nom de la source de l’événement, le nom du journal des événements, le nom de l’ordinateur et le fichier de ressources du message d’événement. Cet exemple fait partie d’un exemple plus grand fourni pour 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

Remarques

Utilisez la LogName propriété pour identifier le journal des événements dans lequel votre application écrit des entrées à l’aide de la nouvelle source. Le journal des événements peut être un nouveau journal ou un journal existant. Les applications et les services doivent écrire dans le journal des applications ou dans un journal personnalisé. Les pilotes de périphérique doivent écrire dans le journal système. Si vous ne définissez pas explicitement la LogName propriété, le journal des événements est défini par défaut sur le journal des applications.

Notes

Le journal de sécurité est en lecture seule.

Pour cibler un journal existant pour la nouvelle source, définissez la propriété sur LogName le nom du journal des événements existant. Pour créer un journal des événements pour la source, vous devez définir la LogName propriété . Les noms du journal des événements doivent se composer de caractères imprimables et ne peuvent pas inclure les caractères « * », « ? » ou « \ ». Les 8 premiers caractères du nom du journal des événements doivent être différents des 8 premiers caractères des noms existants des journaux d’événements sur l’ordinateur spécifié.

Le système d’exploitation stocke les journaux des événements sous forme de fichiers. Lorsque vous utilisez EventLogInstaller ou la CreateEventSource méthode pour créer un journal des événements, le fichier associé est stocké dans le répertoire %SystemRoot%\System32\Config sur l’ordinateur spécifié. Le nom de fichier est défini en ajoutant les 8 premiers caractères de la propriété avec l’extension LogName de nom de fichier .evt ».

S’applique à

Voir aussi