PerformanceCounterCategory.MachineName-Eigenschaft

Artikel
08/20/2007

Ruft den Namen des Computers ab, auf dem diese Kategorie vorhanden ist, oder legt diesen fest.

Namespace: System.Diagnostics
Assembly: System (in system.dll)

Syntax

'Declaration
Public Property MachineName As String
'Usage
Dim instance As PerformanceCounterCategory
Dim value As String

value = instance.MachineName

instance.MachineName = value

public string MachineName { get; set; }

public:
property String^ MachineName {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_MachineName ()

/** @property */
public void set_MachineName (String value)

public function get MachineName () : String

public function set MachineName (value : String)

Eigenschaftenwert

Der Name des Computers, auf dem die Leistungsindikatorkategorie und die zugeordneten Zähler vorhanden sind.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Die Syntax für MachineName ist ungültig.

Beispiel

Im folgenden Beispiel wird eine PerformanceCounterCategory mit dem PerformanceCounterCategory-Konstruktor erstellt. Der Benutzer wird zum Eingeben des PerformanceCounterCategory-Namens und des Computernamens aufgefordert. Dann werden die CategoryName-Eigenschaft und die MachineName-Eigenschaft anhand der eingegebenen Werte festgelegt. Anschließend werden die Werte der CategoryName-Eigenschaft, der MachineName-Eigenschaft und der CategoryHelp-Eigenschaft angezeigt, oder es wird eine Fehlermeldung angezeigt, wenn nicht auf die PerformanceCounterCategory zugegriffen werden kann.

Sub Main(ByVal args() As String)
    Dim categoryName As String = ""
    Dim machineName As String = ""
    Dim pcc As New PerformanceCounterCategory

    ' Prompt for fields and set the corresponding properties.
    While categoryName.Length = 0
        Console.Write("Please enter a non-blank category name: ")
        categoryName = Console.ReadLine().Trim
        If categoryName.Length > 0 Then
            pcc.CategoryName = categoryName
        End If
    End While
    While machineName.Length = 0
        Console.Write( _
            "Enter a non-blank computer name ['.' for local]: ")
        machineName = Console.ReadLine().Trim
        If machineName.Length > 0 Then
            pcc.MachineName = machineName
        End If
    End While

    ' Display the properties of the PerformanceCounterCategory object.
    Try
        Console.WriteLine("  Category:  {0}", pcc.CategoryName)
        Console.WriteLine("  Computer:  {0}", pcc.MachineName)
        Console.WriteLine("  Help text: {0}", pcc.CategoryHelp)
    Catch ex As Exception
        Console.WriteLine("Error getting the properties of the " & _
            "PerformanceCounterCategory object:")
        Console.WriteLine(ex.Message)
    End Try
End Sub

.NET Framework-Sicherheit

PerformanceCounterPermissionAccess zum Lesen von Leistungsindikatorkategorien. Zugeordnete Enumeration: PerformanceCounterPermissionAccess.Read.

Plattformen

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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

PerformanceCounterCategory-Klasse
PerformanceCounterCategory-Member
System.Diagnostics-Namespace
PerformanceCounterCategory.CategoryName-Eigenschaft
PerformanceCounter-Klasse

Freigeben über