InstanceDataCollectionCollection Класс

Определение

Предоставляет строго типизированную коллекцию объектов InstanceDataCollection.Provides a strongly typed collection of InstanceDataCollection objects.

public ref class InstanceDataCollectionCollection : System::Collections::DictionaryBase
public class InstanceDataCollectionCollection : System.Collections.DictionaryBase
type InstanceDataCollectionCollection = class
    inherit DictionaryBase
Public Class InstanceDataCollectionCollection
Inherits DictionaryBase
Наследование
InstanceDataCollectionCollection

Примеры

В следующем примере кода выводятся данные экземпляра для определенного PerformanceCounterCategory на локальном компьютере.The following code example displays the instance data for a particular PerformanceCounterCategory on the local computer. Сначала он отображает нумерованный список имен PerformanceCounterCategory.It first displays a numbered list of PerformanceCounterCategory names. После того как пользователь введет номер одной из категорий, в примере получается InstanceDataCollectionCollection для этого PerformanceCounterCategory.After the user enters the number of one of the categories, the example gets the InstanceDataCollectionCollection for that PerformanceCounterCategory. Затем Коллекция, возвращаемая свойством Values, преобразуется в массив объектов InstanceDataCollection.It then converts the collection returned by the Values property to an array of InstanceDataCollection objects. В примере отображаются данные экземпляра, связанные с каждым InstanceData каждой InstanceDataCollection.The example displays the instance data associated with each InstanceData of each 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

Комментарии

Класс InstanceDataCollectionCollection представляет коллекцию, возвращенную методом ReadCategory.The InstanceDataCollectionCollection class represents the collection returned from the ReadCategory method. Эта коллекция содержит все данные счетчика и экземпляра.This collection contains all the counter and instance data. Коллекция содержит объект InstanceDataCollection для каждого счетчика.The collection contains an InstanceDataCollection object for each counter. Каждый объект InstanceDataCollection содержит данные о производительности для всех счетчиков данного экземпляра.Each InstanceDataCollection object contains the performance data for all counters for that instance. Поэтому данные индексируются по имени счетчика, а затем по имени экземпляра.Thus, the data is indexed by counter name and then by instance name.

Конструкторы

InstanceDataCollectionCollection()

Инициализирует новый экземпляр класса InstanceDataCollectionCollection.Initializes a new instance of the InstanceDataCollectionCollection class.

Свойства

Count

Получает число элементов, содержащихся в экземпляре класса DictionaryBase.Gets the number of elements contained in the DictionaryBase instance.

(Унаследовано от DictionaryBase)
Dictionary

Получает список элементов, содержащихся в экземпляре DictionaryBase.Gets the list of elements contained in the DictionaryBase instance.

(Унаследовано от DictionaryBase)
InnerHashtable

Получает список элементов, содержащихся в экземпляре DictionaryBase.Gets the list of elements contained in the DictionaryBase instance.

(Унаследовано от DictionaryBase)
Item[String]

Возвращает данные экземпляра для указанного счетчика.Gets the instance data for the specified counter.

Keys

Возвращает объект и разделы реестра счетчика для объектов, связанных с этой коллекцией данных экземпляра.Gets the object and counter registry keys for the objects associated with this instance data collection.

Values

Возвращает значения данных экземпляра, в которых содержится коллекция экземпляров счетчика.Gets the instance data values that comprise the collection of instances for the counter.

Методы

Clear()

Удаляет содержимое экземпляра DictionaryBase.Clears the contents of the DictionaryBase instance.

(Унаследовано от DictionaryBase)
Contains(String)

Определяет наличие коллекции данных экземпляра для указанного счетчика (определяется по одному из индексированных объектов InstanceDataCollection) в соответствующей коллекции.Determines whether an instance data collection for the specified counter (identified by one of the indexed InstanceDataCollection objects) exists in the collection.

CopyTo(Array, Int32)

Копирует элементы класса DictionaryBase в одномерный массив класса Array с указанного индекса.Copies the DictionaryBase elements to a one-dimensional Array at the specified index.

(Унаследовано от DictionaryBase)
CopyTo(InstanceDataCollection[], Int32)

Копирует массив экземпляров InstanceDataCollection в коллекцию по указанному индексу.Copies an array of InstanceDataCollection instances to the collection, at the specified index.

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetEnumerator()

Возвращает перечислитель IDictionaryEnumerator, осуществляющий перебор элементов экземпляра класса DictionaryBase.Returns an IDictionaryEnumerator that iterates through the DictionaryBase instance.

(Унаследовано от DictionaryBase)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnClear()

Осуществляет дополнительные пользовательские действия перед удалением содержимого экземпляра класса DictionaryBase.Performs additional custom processes before clearing the contents of the DictionaryBase instance.

(Унаследовано от DictionaryBase)
OnClearComplete()

Осуществляет дополнительные пользовательские действия после удаления содержимого экземпляра класса DictionaryBase.Performs additional custom processes after clearing the contents of the DictionaryBase instance.

(Унаследовано от DictionaryBase)
OnGet(Object, Object)

Получает элемент с указанными ключом и значением из экземпляра класса DictionaryBase.Gets the element with the specified key and value in the DictionaryBase instance.

(Унаследовано от DictionaryBase)
OnInsert(Object, Object)

Выполняет дополнительные пользовательские действия перед вставкой нового элемента в экземпляр класса DictionaryBase.Performs additional custom processes before inserting a new element into the DictionaryBase instance.

(Унаследовано от DictionaryBase)
OnInsertComplete(Object, Object)

Выполняет дополнительные пользовательские действия после вставки нового элемента в экземпляр класса DictionaryBase.Performs additional custom processes after inserting a new element into the DictionaryBase instance.

(Унаследовано от DictionaryBase)
OnRemove(Object, Object)

Осуществляет дополнительные пользовательские действия перед удалением элемента из экземпляра класса DictionaryBase.Performs additional custom processes before removing an element from the DictionaryBase instance.

(Унаследовано от DictionaryBase)
OnRemoveComplete(Object, Object)

Осуществляет дополнительные пользовательские действия после удаления элемента из экземпляра класса DictionaryBase.Performs additional custom processes after removing an element from the DictionaryBase instance.

(Унаследовано от DictionaryBase)
OnSet(Object, Object, Object)

Выполняет дополнительные пользовательские действия перед заданием значения в экземпляре класса DictionaryBase.Performs additional custom processes before setting a value in the DictionaryBase instance.

(Унаследовано от DictionaryBase)
OnSetComplete(Object, Object, Object)

Выполняет дополнительные пользовательские действия после задания значения в экземпляре класса DictionaryBase.Performs additional custom processes after setting a value in the DictionaryBase instance.

(Унаследовано от DictionaryBase)
OnValidate(Object, Object)

Выполняет дополнительные пользовательские операции при проверке элемента с указанными ключом и значением.Performs additional custom processes when validating the element with the specified key and value.

(Унаследовано от DictionaryBase)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Явные реализации интерфейса

ICollection.IsSynchronized

Возвращает значение, указывающее на то, является ли доступ к объекту DictionaryBase синхронизированным (потокобезопасным).Gets a value indicating whether access to a DictionaryBase object is synchronized (thread safe).

(Унаследовано от DictionaryBase)
ICollection.SyncRoot

Получает объект, который позволяет синхронизировать доступ к объекту DictionaryBase.Gets an object that can be used to synchronize access to a DictionaryBase object.

(Унаследовано от DictionaryBase)
IDictionary.Add(Object, Object)

Добавляет элемент с указанными ключом и значением в словарь DictionaryBase.Adds an element with the specified key and value into the DictionaryBase.

(Унаследовано от DictionaryBase)
IDictionary.Contains(Object)

Определяет, содержит ли объект DictionaryBase указанный ключ.Determines whether the DictionaryBase contains a specific key.

(Унаследовано от DictionaryBase)
IDictionary.IsFixedSize

Получает значение, показывающее, имеет ли объект DictionaryBase фиксированный размер.Gets a value indicating whether a DictionaryBase object has a fixed size.

(Унаследовано от DictionaryBase)
IDictionary.IsReadOnly

Возвращает значение, указывающее, является ли объект DictionaryBase доступным только для чтения.Gets a value indicating whether a DictionaryBase object is read-only.

(Унаследовано от DictionaryBase)
IDictionary.Item[Object]

Получает или задает значение, связанное с указанным ключом.Gets or sets the value associated with the specified key.

(Унаследовано от DictionaryBase)
IDictionary.Keys

Получает объект ICollection, содержащий ключи из объекта DictionaryBase.Gets an ICollection object containing the keys in the DictionaryBase object.

(Унаследовано от DictionaryBase)
IDictionary.Remove(Object)

Удаляет элемент с указанным ключом из объекта DictionaryBase.Removes the element with the specified key from the DictionaryBase.

(Унаследовано от DictionaryBase)
IDictionary.Values

Получает объект ICollection, содержащий значения из объекта DictionaryBase.Gets an ICollection object containing the values in the DictionaryBase object.

(Унаследовано от DictionaryBase)
IEnumerable.GetEnumerator()

Возвращает объект IEnumerator, осуществляющий перебор DictionaryBase.Returns an IEnumerator that iterates through the DictionaryBase.

(Унаследовано от DictionaryBase)

Методы расширения

Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

AsQueryable(IEnumerable)

Преобразовывает коллекцию IEnumerable в объект IQueryable.Converts an IEnumerable to an IQueryable.

Применяется к

Дополнительно