IDataCollector：:p ut_FileName 方法 (pla.h)

擷取或設定將包含數據收集器數據的檔案基底名稱。

這是可讀寫的屬性。

語法

HRESULT put_FileName(
  BSTR name
);

name

無

如果您在 IDataCollector：：FileNameFormat 屬性中指定格式化選項，則所使用的實際檔名可能會不同。 IDataCollector：：LatestOutputLocation 屬性包含使用的實際檔名。

請勿在檔名中包含路徑; IDataCollectorSet：：RootPath 和 IDataCollectorSet：：Subdirectory 屬性會決定檔案的路徑。

您指定的擴展名取決於資料收集器的類型。下表顯示用於每個數據收集器的正確擴充功能。如果您指定不同的擴充功能，PLA 將會使用它。如果您未指定擴展名，PLA 會將正確的擴展名新增至檔案。

數據收集器類型	要使用的擴充功能
設定數據收集器	.xml
效能數據收集器	可以是 .blg、.csv 或 .tsv，視 IPerformanceCounterDataCollector：：LogFileFormat 屬性的值而定。
追蹤數據收集器	.etl

IDataCollector：：LogAppend 和 IDataCollector：：LogOverwrite 屬性會決定檔案已經存在時所採取的動作。