InstanceDataCollection Třída

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.PerformanceCounter.dll

Balíček:

System.Diagnostics.PerformanceCounter v8.0.0

Zdroj:

InstanceDataCollection.cs

Poskytuje kolekci objektů se silnými typy InstanceData .

public ref class InstanceDataCollection : System::Collections::DictionaryBase

public class InstanceDataCollection : System.Collections.DictionaryBase

type InstanceDataCollection = class
    inherit DictionaryBase

Public Class InstanceDataCollection
Inherits DictionaryBase

Dědičnost

Object

DictionaryBase

InstanceDataCollection

Příklady

Následující příklad kódu zobrazí data instance pro konkrétní PerformanceCounterCategory v místním počítači. Nejdřív se zobrazí očíslovaný seznam PerformanceCounterCategory jmen. Jakmile uživatel zadá číslo jedné z kategorií, získá příklad hodnotu pro PerformanceCounterCategorydanou InstanceDataCollectionCollection kategorii . Poté převede kolekci vrácenou nástrojem Values na pole InstanceDataCollection objektů. V příkladu se také zobrazí data instance přidružená ke každému InstanceData z nich InstanceDataCollection.

using System;
using System.Diagnostics;
using System.Collections;

class InstDataKeysValuesMod
{

    private static string categoryName;

    public static void Main()
    {
        string catNumStr;
        int categoryNum;

        PerformanceCounterCategory[] categories = PerformanceCounterCategory.GetCategories();

        Console.WriteLine("These categories are registered on this computer:");

        int catX;
        for(catX=0; catX<categories.Length; catX++)
        {
            Console.WriteLine("{0,4} - {1}", catX+1, categories[catX].CategoryName);
        }

        // Ask the user to choose a category.
        Console.Write("Enter the category number from the above list: ");
        catNumStr = Console.ReadLine();

        // Validate the entered category number.
        try
        {
            categoryNum = int.Parse(catNumStr);
            if (categoryNum<1||categoryNum>categories.Length)
            {
                throw new Exception(String.Format("The category number must be in the " +
                    "range 1..{0}.", categories.Length));
            }
            categoryName = categories[(categoryNum - 1)].CategoryName;
        }
        catch(Exception ex)
        {
            Console.WriteLine("\"{0}\" is not a valid category number." +
                "\r\n{1}", catNumStr, ex.Message);
            return;
        }

        // Process the InstanceDataCollectionCollection for this category.
        PerformanceCounterCategory pcc = new PerformanceCounterCategory(categoryName);
        InstanceDataCollectionCollection idColCol = pcc.ReadCategory();

        ICollection idColColKeys = idColCol.Keys;
        string[] idCCKeysArray = new string[idColColKeys.Count];
        idColColKeys.CopyTo(idCCKeysArray, 0);

        ICollection idColColValues = idColCol.Values;
        InstanceDataCollection[] idCCValuesArray = new InstanceDataCollection[idColColValues.Count];
        idColColValues.CopyTo(idCCValuesArray, 0);

        Console.WriteLine("InstanceDataCollectionCollection for \"{0}\" " +
            "has {1} elements.", categoryName, idColCol.Count);

        // Display the InstanceDataCollectionCollection Keys and Values.
        // The Keys and Values collections have the same number of elements.
        int index;
        for(index=0; index<idCCKeysArray.Length; index++)
        {
            Console.WriteLine("  Next InstanceDataCollectionCollection " +
                "Key is \"{0}\"", idCCKeysArray[index]);
            ProcessInstanceDataCollection(idCCValuesArray[index]);
        }
    }

    // Display the contents of an InstanceDataCollection.
    public static void ProcessInstanceDataCollection(InstanceDataCollection idCol)
    {

        ICollection idColKeys = idCol.Keys;
        string[] idColKeysArray = new string[idColKeys.Count];
        idColKeys.CopyTo(idColKeysArray, 0);

        ICollection idColValues = idCol.Values;
        InstanceData[] idColValuesArray = new InstanceData[idColValues.Count];
        idColValues.CopyTo(idColValuesArray, 0);

        Console.WriteLine("  InstanceDataCollection for \"{0}\" " +
            "has {1} elements.", idCol.CounterName, idCol.Count);

        // Display the InstanceDataCollection Keys and Values.
        // The Keys and Values collections have the same number of elements.
        int index;
        for(index=0; index<idColKeysArray.Length; index++)
        {
            Console.WriteLine("    Next InstanceDataCollection " +
                "Key is \"{0}\"", idColKeysArray[index]);
            ProcessInstanceDataObject(idColValuesArray[index]);
        }
    }

    // Display the contents of an InstanceData object.
    public static void ProcessInstanceDataObject(InstanceData instData)
    {
        CounterSample sample = instData.Sample;

        Console.WriteLine("    From InstanceData:\r\n      " +
            "InstanceName: {0,-31} RawValue: {1}", instData.InstanceName, instData.Sample.RawValue);
        Console.WriteLine("    From CounterSample:\r\n      " +
            "CounterType: {0,-32} SystemFrequency: {1}\r\n" +
            "      BaseValue: {2,-34} RawValue: {3}\r\n" +
            "      CounterFrequency: {4,-27} CounterTimeStamp: {5}\r\n" +
            "      TimeStamp: {6,-34} TimeStamp100nSec: {7}", sample.CounterType, sample.SystemFrequency, sample.BaseValue, sample.RawValue, sample.CounterFrequency, sample.CounterTimeStamp, sample.TimeStamp, sample.TimeStamp100nSec);
    }
}

Imports System.Diagnostics
Imports System.Collections

Module InstDataKeysValuesMod

    Private categoryName As String

    Sub Main()
        Dim catNumStr As String
        Dim categoryNum As Integer

        Dim categories As PerformanceCounterCategory() = _
            PerformanceCounterCategory.GetCategories()

        Console.WriteLine( _
            "These categories are registered on this computer:")

        Dim catX As Integer
        For catX = 0 To categories.Length - 1
            Console.WriteLine("{0,4} - {1}", catX + 1, _
                categories(catX).CategoryName)
        Next catX

        ' Ask the user to choose a category.
        Console.Write( _
            "Enter the category number from the above list: ")
        catNumStr = Console.ReadLine()

        ' Validate the entered category number.
        Try
            categoryNum = Integer.Parse(catNumStr)
            If categoryNum < 1 Or categoryNum > categories.Length Then
                Throw New Exception( _
                    String.Format("The category number must be in the " & _
                        "range 1..{0}.", categories.Length))
            End If
            categoryName = categories((categoryNum - 1)).CategoryName

        Catch ex As Exception
            Console.WriteLine("""{0}"" is not a valid category number." & _
                vbCrLf & "{1}", catNumStr, ex.Message)
            Return
        End Try

        ' Process the InstanceDataCollectionCollection for this category.
        Dim pcc As New PerformanceCounterCategory(categoryName)
        Dim idColCol As InstanceDataCollectionCollection = pcc.ReadCategory()

        Dim idColColKeys As ICollection = idColCol.Keys
        Dim idCCKeysArray(idColColKeys.Count - 1) As String
        idColColKeys.CopyTo(idCCKeysArray, 0)

        Dim idColColValues As ICollection = idColCol.Values
        Dim idCCValuesArray(idColColValues.Count - 1) As InstanceDataCollection
        idColColValues.CopyTo(idCCValuesArray, 0)

        Console.WriteLine("InstanceDataCollectionCollection for ""{0}"" " & _
            "has {1} elements.", categoryName, idColCol.Count)

        ' Display the InstanceDataCollectionCollection Keys and Values.
        ' The Keys and Values collections have the same number of elements.
        Dim index As Integer
        For index = 0 To idCCKeysArray.Length - 1
            Console.WriteLine("  Next InstanceDataCollectionCollection " & _
                "Key is ""{0}""", idCCKeysArray(index))
            ProcessInstanceDataCollection(idCCValuesArray(index))
        Next index
    End Sub

    ' Display the contents of an InstanceDataCollection.
    Sub ProcessInstanceDataCollection(ByVal idCol As InstanceDataCollection)

        Dim idColKeys As ICollection = idCol.Keys
        Dim idColKeysArray(idColKeys.Count - 1) As String
        idColKeys.CopyTo(idColKeysArray, 0)

        Dim idColValues As ICollection = idCol.Values
        Dim idColValuesArray(idColValues.Count - 1) As InstanceData
        idColValues.CopyTo(idColValuesArray, 0)

        Console.WriteLine("  InstanceDataCollection for ""{0}"" " & _
            "has {1} elements.", idCol.CounterName, idCol.Count)

        ' Display the InstanceDataCollection Keys and Values.
        ' The Keys and Values collections have the same number of elements.
        Dim index As Integer
        For index = 0 To idColKeysArray.Length - 1
            Console.WriteLine("    Next InstanceDataCollection " & _
                "Key is ""{0}""", idColKeysArray(index))
            ProcessInstanceDataObject(idColValuesArray(index))
        Next index
    End Sub

    ' Display the contents of an InstanceData object.
    Sub ProcessInstanceDataObject(ByVal instData As InstanceData)
        Dim sample As CounterSample = instData.Sample

        Console.WriteLine("    From InstanceData:" & vbCrLf & "      " & _
            "InstanceName: {0,-31} RawValue: {1}", _
            instData.InstanceName, instData.Sample.RawValue)
        Console.WriteLine("    From CounterSample:" & vbCrLf & "      " & _
            "CounterType: {0,-32} SystemFrequency: {1}" & vbCrLf & _
            "      BaseValue: {2,-34} RawValue: {3}" & vbCrLf & _
            "      CounterFrequency: {4,-27} CounterTimeStamp: {5}" & vbCrLf & _
            "      TimeStamp: {6,-34} TimeStamp100nSec: {7}", _
            sample.CounterType, sample.SystemFrequency, sample.BaseValue, _
            sample.RawValue, sample.CounterFrequency, sample.CounterTimeStamp, _
            sample.TimeStamp, sample.TimeStamp100nSec)
    End Sub
End Module

Poznámky

Třída InstanceDataCollection představuje kolekci obsahující všechna data instance pro čítač. Tato kolekce je obsažena v objektu InstanceDataCollectionCollection při použití ReadCategory metody .

Konstruktory

InstanceDataCollection(String)

Zastaralé. Inicializuje novou instanci InstanceDataCollection třídy pomocí zadaného čítače výkonu (který definuje instanci výkonu).

Vlastnosti

Count	Získá počet prvků obsažených DictionaryBase v instanci. (Zděděno od DictionaryBase)
CounterName	Získá název čítače výkonu, jehož data instance chcete získat.
Dictionary	Získá seznam prvků obsažených DictionaryBase v instanci. (Zděděno od DictionaryBase)
InnerHashtable	Získá seznam prvků obsažených DictionaryBase v instanci. (Zděděno od DictionaryBase)
Item[String]	Získá data instance přidružená k tomuto čítači. Obvykle se jedná o sadu nezpracovaných hodnot čítačů.
Keys	Získá klíče registru objektu a čítače pro objekty přidružené k této instanci dat.
Values	Získá nezpracované hodnoty čítače, které tvoří data instance čítače.

Metody

Clear()	Vymaže obsah DictionaryBase instance. (Zděděno od DictionaryBase)
Contains(String)	Určuje, zda instance výkonu se zadaným názvem (identifikovaná jedním z indexovaných InstanceData objektů) existuje v kolekci.
CopyTo(Array, Int32)	Zkopíruje elementy DictionaryBase do jednorozměrného Array v zadaném indexu. (Zděděno od DictionaryBase)
CopyTo(InstanceData[], Int32)	Zkopíruje položky v kolekci do zadaného jednorozměrného pole v zadaném indexu.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetEnumerator()	Vrátí hodnotu , IDictionaryEnumerator která iteruje prostřednictvím DictionaryBase instance. (Zděděno od DictionaryBase)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnClear()	Před vymazáním obsahu DictionaryBase instance provede další vlastní procesy. (Zděděno od DictionaryBase)
OnClearComplete()	Provádí další vlastní procesy po vymazání obsahu DictionaryBase instance. (Zděděno od DictionaryBase)
OnGet(Object, Object)	Získá prvek se zadaným klíčem a hodnotou v DictionaryBase instanci. (Zděděno od DictionaryBase)
OnInsert(Object, Object)	Provádí další vlastní procesy před vložením nového prvku do DictionaryBase instance. (Zděděno od DictionaryBase)
OnInsertComplete(Object, Object)	Provádí další vlastní procesy po vložení nového prvku do DictionaryBase instance. (Zděděno od DictionaryBase)
OnRemove(Object, Object)	Provádí další vlastní procesy před odebráním elementu DictionaryBase z instance. (Zděděno od DictionaryBase)
OnRemoveComplete(Object, Object)	Provádí další vlastní procesy po odebrání prvku z DictionaryBase instance. (Zděděno od DictionaryBase)
OnSet(Object, Object, Object)	Před nastavením hodnoty v DictionaryBase instanci provede další vlastní procesy. (Zděděno od DictionaryBase)
OnSetComplete(Object, Object, Object)	Provádí další vlastní procesy po nastavení hodnoty v DictionaryBase instanci. (Zděděno od DictionaryBase)
OnValidate(Object, Object)	Provádí další vlastní procesy při ověřování elementu pomocí zadaného klíče a hodnoty. (Zděděno od DictionaryBase)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Metody rozšíření

Viz také

• ReadCategory()
• InstanceDataCollectionCollection
• InstanceData
• CounterSample