pla.h (iDataCollector 介面)

使用 XML 設定和擷取收集器屬性、指定記錄檔名稱，以及擷取記錄檔的位置。

這個介面是抽象類，下列數據收集器衍生自此類別：

• IAlertDataCollector
• IApiTracingDataCollector
• IConfigurationDataCollector
• IPerformanceCounterDataCollector
• ITraceDataCollector

繼承

IDataCollector 介面繼承自 IDispatch 介面。 IDataCollector 也有下列類型的成員：

方法

IDataCollector 介面具有這些方法。

IDataCollector：：get_DataCollectorSet 擷取這個數據收集器所屬的數據收集器集合。
IDataCollector：：get_DataCollectorType 擷取此數據收集器的類型，例如效能數據收集器。
IDataCollector：：get_FileName 擷取或設定將包含數據收集器數據的檔案基底名稱。 (取得)
IDataCollector：：get_FileNameFormat 擷取或設定旗標，描述如何裝飾檔名。 (取得)
IDataCollector：：get_FileNameFormatPattern 擷取或設定裝飾檔名時要使用的格式模式。 (取得)
IDataCollector：：get_Index 擷取數據收集器的索引值。 索引值會識別數據收集器集合內的數據收集器。
IDataCollector：：get_LatestOutputLocation 擷取或設定 PLA 上次建立檔案時所使用的完整裝飾檔名。 (IDataCollector.get_LatestOutputLocation)
IDataCollector：：get_LogAppend 擷取或設定值，指出 PLA 是否應該將收集的數據附加至目前的檔案。 (取得)
IDataCollector：：get_LogCircular 擷取或設定值，指出 PLA 是否應該建立循環檔案。 (取得)
IDataCollector：：get_LogOverwrite 擷取或設定值，指出 PLA 是否應該覆寫目前的檔案。 (取得)
IDataCollector：：get_Name 擷取或設定資料收集器的名稱。 (取得)
IDataCollector：：get_OutputLocation 如果 PLA 現在要建立，則會擷取裝飾的檔名。
IDataCollector：：get_Xml 擷取 XML 字串，描述數據收集器屬性的值。
IDataCollector：:p ut_FileName 擷取或設定將包含數據收集器數據的檔案基底名稱。 (Put)
IDataCollector：:p ut_FileNameFormat 擷取或設定旗標，描述如何裝飾檔名。 (Put)
IDataCollector：:p ut_FileNameFormatPattern 擷取或設定裝飾檔名時要使用的格式模式。 (Put)
IDataCollector：:p ut_LatestOutputLocation 擷取或設定 PLA 上次建立檔案時所使用的完整裝飾檔名。 (IDataCollector.put_LatestOutputLocation)
IDataCollector：:p ut_LogAppend 擷取或設定值，指出 PLA 是否應該將收集的數據附加至目前的檔案。 (Put)
IDataCollector：:p ut_LogCircular 擷取或設定值，指出 PLA 是否應該建立循環檔案。 (Put)
IDataCollector：:p ut_LogOverwrite 擷取或設定值，指出 PLA 是否應該覆寫目前的檔案。 (Put)
IDataCollector：:p ut_Name 擷取或設定資料收集器的名稱。 (Put)
IDataCollector：：SetXml 設定 XML 中包含的這些屬性的屬性值。 (IDataCollector.SetXml)

備註

如果您呼叫 IDataCollectorCollection：：CreateDataCollectorFromXml 屬性來建立其中一個衍生數據收集器，下列範例會顯示可用來初始化這個物件的 XML。 IDataCollector：：Xml 屬性也會傳回這個 XML。

    <FileName/>
    <FileNameFormat/>
    <FileNameFormatPattern/>
    <Index/>
    <LatestOutputLocation/>
    <LogAppend/>
    <LogCircular/>
    <LogOverwrite/>
    <Name/>
    <OutputLocation/>

請注意，此範例不會顯示衍生數據收集器的屬性元素 (查看其 XML 元素的每個數據收集器) 。 視需要將這些元素包含在數據收集器 XML 中。 下列範例顯示警示數據收集器的 XML。 您可以依任何順序指定專案。

<AlertDataCollector>
    <FileName/>
    <FileNameFormat/>
    <FileNameFormatPattern/>
    <Index/>
    <LatestOutputLocation/>
    <LogAppend/>
    <LogCircular/>
    <LogOverwrite/>
    <Name/>
    <OutputLocation/>
    <Alert/>  <!-- Specify an <Alert> element for each alert -->
    <EventLog/>
    <SampleInterval/>
    <Task/>
    <TaskArguments/>
    <TaskUserTextArguments/>
    <TaskSetWorkingDirectory/>
    <TriggerDataCollectorSet/>
</AlertDataCollector>

當您指定要建立收集器的 XML 時，您只能指定您想要設定之屬性的專案。 如果您未指定屬性，PLA 會提供預設值。 當您擷取收集器的 XML 時，XML 會提供所有元素，包括 來自 IDataCollector 的專案。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	pla.h