Utilisation du fichier des paramètres d'application

Article
09/12/2008

Le fichier des paramètres d'application contient plusieurs données d'application utilisées par cet exemple. Les paramètres d'application proposent un emplacement de stockage et de récupération des paramètres de propriété et autres informations relatives à l'application au moment de l'exécution. Ces paramètres indiquent le type d'événements à écouter, s'il convient d'utiliser une base de données ou un fichier XML pour stocker les événements reçus, la base de données à utiliser, la taille des lots requise pour enregistrer les événements, etc. Le tableau suivant répertorie le nom, le type, la description et la valeur de chaque paramètre.

Exemple

Description

Le tableau suivant répertorie le nom, le type, la description et la valeur de chaque paramètre.

Nom du paramètre	Type	Description	Valeur
BatchSize	Entier	Entier indiquant le nombre d'entrées d'événements devant être écrites une fois dans la base de données. Ce paramètre contrôle la fréquence des transferts de données réseau vers la base de données en regroupant plusieurs enregistrements avant de les envoyer sur le réseau.	1000
DatabaseName	Chaîne	Nom de la base de données utilisée ou nom du fichier s'il est utilisé en mode XML.	EventsDatabase
EventQuery	Chaîne	Requête indiquant les événements à écouter.	<QueryList><Query Id="0" > <Select Path="Application"></Select> <Select Path="Security"></Select></Query></QueryList>
LogPath	Chaîne	Chemin d'accès au journal des événements.	System
ReadExistingEvents	Booléen	Indicateur déterminant si les événements existants doivent être lus ou si seuls les nouveaux doivent être écoutés.	True
SqlConnectionString	Chaîne	Chaîne indiquant la procédure de connexion à la base de données SQL. Utilisez la valeur appropriée à cet endroit pour votre configuration.	Chaîne Insert SQL-Connection à télécharger sur SQL.
SqlTableDefinition	Chaîne	Définit la structure de table pour capturer les données d'événement. L'analyseur de mise en forme obtient une paire « Table Name=XPath into EventXml » séparée par une virgule. Pour plus d'informations sur Xpath, consultez la documentation sur le schéma EventXml (page pouvant être en anglais).	ProviderName=Event/System/Provider/@Name, Channel=Event/System/Channel, TimeCreated=Event/System/TimeCreated/@SystemTime, RecordId=Event/System/EventRecordID, EventId=Event/System/EventID
SubscribeForFutureEvents	Booléen	Indicateur permettant de déterminer si vous devez continuer à exécuter l'exemple pour capturer des événements futurs ou si vous devez quitter le programme.	True
XmlMode	Booléen	Indicateur déterminant si les données d'événement sont capturées dans un fichier XML ou dans la base de données spécifiée.	True

Code

Voici le contenu du fichier des paramètres au format XML.

<?xml version='1.0' encoding='utf-8'?>
<SettingsFile xmlns="https://schemas.microsoft.com/VisualStudio/2004/01/settings" CurrentProfile="(Default)" 
GeneratedClassNamespace="EventLogSample" 
GeneratedClassName="Settings">
  <Profiles />
  <Settings>
    <Setting Name="SqlConnectionString" Type="System.String" Scope="Application">
    <!-- Insert SQL connection string to upload to XML --></Setting>
    <Setting Name="LogPath" Type="System.String" Scope="Application">
      <Value Profile="(Default)">System</Value>
    </Setting>
    <Setting Name="EventQuery" Type="System.String" Scope="Application">
      <Value Profile="(Default)">&lt;QueryList&gt;&lt;Query Id="0" &gt;
  &lt;Select Path="Application"&gt;*&lt;/Select&gt;
  &lt;Select Path="Security"&gt;*&lt;/Select&gt;&lt;/Query&gt;&lt;/QueryList&gt;</Value>
    </Setting>
    <Setting Name="SqlTableDefinition" Type="System.String" Scope="Application">
      <Value Profile="(Default)">ProviderName=Event/System/Provider/@Name,Channel=Event/System/Channel,TimeCreated=Event/System/TimeCreated/@SystemTime,RecordId=Event/System/EventRecordID,EventId=Event/System/EventID</Value>
    </Setting>
    <Setting Name="DatabaseName" Type="System.String" Scope="Application">
      <Value Profile="(Default)">EventsDatabase</Value>
    </Setting>
    <Setting Name="ReadExistingEvents" Type="System.Boolean" Scope="Application">
      <Value Profile="(Default)">True</Value>
    </Setting>
    <Setting Name="SubscribeForFutureEvents" Type="System.Boolean" Scope="Application">
      <Value Profile="(Default)">True</Value>
    </Setting>
    <Setting Name="XmlMode" Type="System.Boolean" Scope="Application">
      <Value Profile="(Default)">True</Value>
    </Setting>
    <Setting Name="BatchSize" Type="System.Int64" Scope="Application">
      <Value Profile="(Default)">1000</Value>
    </Setting>
  </Settings>
</SettingsFile>

Voir aussi

Concepts

Procédure d'écoute et de stockage d'événements dans une base de données SQL

Send comments about this topic to Microsoft.

Partager via