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 |