Méthode IDataCollector ::p ut_FileName (pla.h)

Récupère ou définit le nom de base du fichier qui contiendra les données du collecteur de données.

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT put_FileName(
  BSTR name
);

Paramètres

name

Valeur de retour

None

Remarques

Le nom de fichier utilisé peut être différent si vous avez spécifié des options de mise en forme dans la propriété IDataCollector ::FileNameFormat . La propriété IDataCollector ::LatestOutputLocation contient le nom de fichier réel utilisé.

N’incluez pas le chemin d’accès dans le nom du fichier ; les propriétés IDataCollectorSet ::RootPath et IDataCollectorSet ::Subdirectory déterminent le chemin d’accès au fichier.

L’extension de nom de fichier que vous spécifiez dépend du type de collecteur de données. Le tableau suivant montre l’extension appropriée à utiliser pour chaque collecteur de données. Si vous spécifiez une autre extension, PLA l’utilisera. Si vous ne spécifiez pas d’extension, PLA ajoute l’extension appropriée au fichier.

Type de collecteur de données	Extension à utiliser
Collecteurs de données de configuration	.xml
Collecteurs de données de performances	Peut être .blg, .csv ou .tsv en fonction de la valeur de la propriété IPerformanceCounterDataCollector ::LogFileFormat .
Collecteurs de données de suivi	.etl

 

Les propriétés IDataCollector ::LogAppend et IDataCollector ::LogOverwrite déterminent l’action effectuée si le fichier existe déjà.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	pla.h
DLL	Pla.dll

Voir aussi

IDataCollector

IDataCollector ::FileNameFormat

IDataCollector ::FileNameFormatPattern