InstanceData

.NET Framework クラス ライブラリ リファレンス

InstanceData クラス

パフォーマンス カウンタのサンプルに関連付けられたインスタンス データを保持します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Class InstanceData

Visual Basic (使用法)

Dim instance As InstanceData

C#

public class InstanceData

C++

public ref class InstanceData

J#

public class InstanceData

JScript

public class InstanceData

使用例

ローカル コンピュータの特定の PerformanceCounterCategory に存在する InstanceData オブジェクトのコンテンツを表示するコード例を次に示します。最初に PerformanceCounter カテゴリの名前の番号付きりストが表示されます。ユーザーがカテゴリの 1 つの番号を入力すると、PerformanceCounterCategory 内の各 PerformanceCounter のサンプル (PerformanceCounter の各インスタンスに関連付けられたインスタンス データ) が表示されます。

Visual Basic

Imports System
Imports System.Diagnostics
Imports Microsoft.VisualBasic

Module InstDataCopyToMod

    Private categoryName As String

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

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

        ' Create and sort an array of category names.
        Dim categoryNames(categories.Length - 1) As
 String
        Dim catX As Integer
        For catX = 0 To categories.Length -
 1
            categoryNames(catX) = categories(catX).CategoryName
        Next
        Array.Sort(categoryNames)

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

        For catX = 0 To categories.Length -
 1
            Console.WriteLine("{0,4} - {1}", catX
 + 1, _
                categoryNames(catX))
        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 = categoryNames((categoryNum - 1))

        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 idColArray(idColCol.Count - 1) As
 InstanceDataCollection

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

        ' Copy and process the InstanceDataCollection array.
        idColCol.CopyTo(idColArray, 0)

        Dim idCol As InstanceDataCollection
        For Each idCol In
 idColArray
            ProcessInstanceDataCollection(idCol)
        Next idCol
    End Sub

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

        Dim instDataArray(idCol.Count - 1) As
 InstanceData

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

        ' Copy and process the InstanceData array.
        idCol.CopyTo(instDataArray, 0)

        Dim idX As Integer
        For idX = 0 To instDataArray.Length
 - 1
            ProcessInstanceDataObject(instDataArray(idX).InstanceName, _
                instDataArray(idX).Sample)
        Next idX
    End Sub

    ' Display the contents of an InstanceData object.
    Sub ProcessInstanceDataObject(ByVal name
 As String, _
                                  ByVal CSRef As
 CounterSample)

        Dim instData As New
 InstanceData(name, CSRef)
        Console.WriteLine("    Data from InstanceData object:"
 & vbCrLf & _
            "      InstanceName: {0,-31} RawValue: {1}",
 _
            instData.InstanceName, instData.RawValue)

        Dim sample As CounterSample = instData.Sample
        Console.WriteLine("    Data from CounterSample object:"
 & 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

継承階層

System.Object
  System.Diagnostics.InstanceData

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
InstanceData メンバ
System.Diagnostics 名前空間

InstanceData コンストラクタ

指定したサンプルとパフォーマンス カウンタ インスタンスを使用して、InstanceData クラスの新しいインスタンスを初期化します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    instanceName As String, _
    sample As CounterSample _
)

Visual Basic (使用法)

Dim instanceName As String
Dim sample As CounterSample

Dim instance As New InstanceData(instanceName,
 sample)

C#

public InstanceData (
    string instanceName,
    CounterSample sample
)

C++

public:
InstanceData (
    String^ instanceName, 
    CounterSample sample
)

J#

public InstanceData (
    String instanceName, 
    CounterSample sample
)

JScript

public function InstanceData (
    instanceName : String, 
    sample : CounterSample
)

パラメータ

instanceName

パフォーマンス カウンタに関連付けられたインスタンスの名前。

sample

instanceName パラメータで指定したインスタンスから取得された CounterSample。

使用例

InstanceData を作成し、そのフィールドの一部の値を表示するコード例を次に示します。

Visual Basic

' Display the contents of an InstanceData object.
Sub ProcessInstanceDataObject(ByVal name As
 String, _
                              ByVal CSRef As
 CounterSample)

    Dim instData As New
 InstanceData(name, CSRef)
    Console.WriteLine("    Data from InstanceData object:"
 & vbCrLf & _
        "      InstanceName: {0,-31} RawValue: {1}",
 _
        instData.InstanceName, instData.RawValue)

    Dim sample As CounterSample = instData.Sample
    Console.WriteLine("    Data from CounterSample object:"
 & 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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
InstanceData クラス
InstanceData メンバ
System.Diagnostics 名前空間

InstanceData プロパティ

パブリック プロパティ

	名前	説明
	InstanceName	このインスタンス データに関連付けられているインスタンス名を取得します。
	RawValue	パフォーマンス カウンタ サンプルに関連付けられた生のデータ値を取得します。
	Sample	このデータを生成したパフォーマンス カウンタ サンプルを取得します。

参照

関連項目

InstanceData クラス
System.Diagnostics 名前空間

InstanceData メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

InstanceData クラス
System.Diagnostics 名前空間

InstanceData メンバ

パフォーマンス カウンタのサンプルに関連付けられたインスタンス データを保持します。

InstanceData データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	InstanceData	指定したサンプルとパフォーマンス カウンタ インスタンスを使用して、InstanceData クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	InstanceName	このインスタンス データに関連付けられているインスタンス名を取得します。
	RawValue	パフォーマンス カウンタ サンプルに関連付けられた生のデータ値を取得します。
	Sample	このデータを生成したパフォーマンス カウンタ サンプルを取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

InstanceData クラス
System.Diagnostics 名前空間