InstanceDataCollection Sınıf

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.PerformanceCounter.dll

Paket:

System.Diagnostics.PerformanceCounter v8.0.0

Kaynak:

InstanceDataCollection.cs

Kesin olarak belirlenmiş bir nesne koleksiyonu InstanceData sağlar.

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

public class InstanceDataCollection : System.Collections.DictionaryBase

type InstanceDataCollection = class
    inherit DictionaryBase

Public Class InstanceDataCollection
Inherits DictionaryBase

Devralma

Object

DictionaryBase

InstanceDataCollection

Örnekler

Aşağıdaki kod örneği, yerel bilgisayardaki belirli PerformanceCounterCategory bir örnek için örnek verilerini görüntüler. İlk olarak numaralandırılmış bir ad listesi PerformanceCounterCategory görüntüler. Kullanıcı kategorilerden birinin sayısını girdikten sonra, örnek için öğesini InstanceDataCollectionCollectionPerformanceCounterCategoryalır. Ardından tarafından Values döndürülen koleksiyonu bir nesne dizisine InstanceDataCollection dönüştürür. Örnekte ayrıca her InstanceDataInstanceDataCollectionbiriyle ilişkili örnek verileri de görüntülenir.

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

Açıklamalar

sınıfı, InstanceDataCollection bir sayaç için tüm örnek verilerini içeren bir koleksiyonu temsil eder. Bu koleksiyon yöntemi kullanılırken ReadCategory içinde InstanceDataCollectionCollection yer alır.

Oluşturucular

InstanceDataCollection(String)

Geçersiz. Belirtilen performans sayacını InstanceDataCollection (bir performans örneğini tanımlar) kullanarak sınıfının yeni bir örneğini başlatır.

Özellikler

Count	Örnekte bulunan DictionaryBase öğelerin sayısını alır. (Devralındığı yer: DictionaryBase)
CounterName	Örnek verilerini almak istediğiniz performans sayacının adını alır.
Dictionary	Örnekte bulunan DictionaryBase öğelerin listesini alır. (Devralındığı yer: DictionaryBase)
InnerHashtable	Örnekte bulunan DictionaryBase öğelerin listesini alır. (Devralındığı yer: DictionaryBase)
Item[String]	Bu sayaçla ilişkili örnek verilerini alır. Bu genellikle bir ham sayaç değerleri kümesidir.
Keys	Bu örnek verileriyle ilişkili nesnelerin nesne ve sayaç kayıt defteri anahtarlarını alır.
Values	Sayacın örnek verilerini oluşturan ham sayaç değerlerini alır.

Yöntemler

Clear()	Örneğin içeriğini DictionaryBase temizler. (Devralındığı yer: DictionaryBase)
Contains(String)	Belirtilen ada (dizinlenmiş InstanceData nesnelerden biri tarafından tanımlanan) sahip bir performans örneğinin koleksiyonda mevcut olup olmadığını belirler.
CopyTo(Array, Int32)	DictionaryBase Öğeleri belirtilen dizindeki tek boyutlu Array bir dizine kopyalar. (Devralındığı yer: DictionaryBase)
CopyTo(InstanceData[], Int32)	Koleksiyondaki öğeleri belirtilen dizindeki belirtilen tek boyutlu diziye kopyalar.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetEnumerator()	Örnekte yineleyen DictionaryBase bir IDictionaryEnumerator döndürür. (Devralındığı yer: DictionaryBase)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
OnClear()	Örneğin içeriğini DictionaryBase temizlemeden önce ek özel işlemler gerçekleştirir. (Devralındığı yer: DictionaryBase)
OnClearComplete()	Örneğin içeriğini DictionaryBase temizledikten sonra ek özel işlemler gerçekleştirir. (Devralındığı yer: DictionaryBase)
OnGet(Object, Object)	örnekte belirtilen anahtar ve değere DictionaryBase sahip öğesini alır. (Devralındığı yer: DictionaryBase)
OnInsert(Object, Object)	Örneğe yeni bir öğe DictionaryBase eklemeden önce ek özel işlemler gerçekleştirir. (Devralındığı yer: DictionaryBase)
OnInsertComplete(Object, Object)	Örneğe yeni bir öğe DictionaryBase ekledikten sonra ek özel işlemler gerçekleştirir. (Devralındığı yer: DictionaryBase)
OnRemove(Object, Object)	Bir öğeyi örnekten DictionaryBase kaldırmadan önce ek özel işlemler gerçekleştirir. (Devralındığı yer: DictionaryBase)
OnRemoveComplete(Object, Object)	Örnekten DictionaryBase bir öğeyi kaldırdıktan sonra ek özel işlemler gerçekleştirir. (Devralındığı yer: DictionaryBase)
OnSet(Object, Object, Object)	Örnekte bir değer DictionaryBase ayarlamadan önce ek özel işlemler gerçekleştirir. (Devralındığı yer: DictionaryBase)
OnSetComplete(Object, Object, Object)	Örnekte bir değer DictionaryBase ayarladıktan sonra ek özel işlemler gerçekleştirir. (Devralındığı yer: DictionaryBase)
OnValidate(Object, Object)	Öğesi belirtilen anahtar ve değerle doğrulanırken ek özel işlemler gerçekleştirir. (Devralındığı yer: DictionaryBase)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Uzantı Metotları

Ayrıca bkz.

• ReadCategory()
• InstanceDataCollectionCollection
• InstanceData
• CounterSample