EventSourceCreationData.LogName Propriété

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Source:

EventSourceCreationData.cs

Obtient ou définit le nom du journal des événements sur 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é

String

Nom du journal des événements. Il peut s’agir d’application, de 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 d’événement, le nom du journal des événements, le nom de l’ordinateur et le fichier de ressources de message d’événement. Cet exemple fait partie d’un exemple plus large fourni pour la EventSourceCreationData classe.

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 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.

Note

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

Pour cibler un journal existant pour la nouvelle source, définissez la LogName propriété sur 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 être composés 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 d’événements existants sur l’ordinateur spécifié.

Le système d’exploitation stocke les journaux d’é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 LogName propriété avec l’extension de nom de fichier .evt ».

Voir aussi

• Log
• Exists(String)