Freigeben über


SO WIRD'S GEMACHT: Konfigurieren von Instanzen von PerformanceCounter-Komponenten

Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]

Es gibt eine Reihe von Eigenschaften auf der Komponenten PerformanceCounter festlegen müssen, die Sie erstellen. Bestimmt den Leistungsindikator, mit dem die Komponente interagiert. Die Eigenschaften festgelegt werden müssen, gehören:

  • CategoryName, die das Leistungsobjekt bestimmt, mit dem die Komponente interagiert. Alle Leistungsindikatoren in Windows werden nach Kategorien, z. B. Speicher, Prozesse und Prozessor gruppiert.

  • CounterName, dadurch wird der Zähler in der angegebenen Kategorie bestimmt, mit dem die Komponente interagiert.

  • InstanceName, dem die Instanz der Kategorie identifiziert, mit denen die Komponente interagiert. Beachten Sie, dass viele Kategorien Instanzen nicht enthalten werden. Daher kann diese Eigenschaft leer sein. Dies bedeutet einen Einzelinstanz-Zähler.

    Hinweis

    Wenn die Kategorie auf eine Kategorie festgelegt wurde, die nicht vom Benutzer definiert wurde, müssen Sie aus vorhandenen Leistungsindikatoren und Instanzen auswählen.Sie können nur neue Leistungsindikatoren und Instanzen in benutzerdefinierte Kategorien erstellen.Z. B. Sie können einen neuen Indikator erstellen, in der Kategorie Speicher, aber wenn Sie eine neue Kategorie Orders erstellen, Sie können beliebig viele Leistungsindikatoren definieren und wie Sie Instanzen müssen innerhalb dieser Kategorie.

  • MachineName, der den Server identifiziert, auf dem der Leistungsindikator mit dem die Komponente interagieren soll befindet. Sie können diese Eigenschaft zum Festlegen "."die den lokalen Computer anzugeben oder lassen Sie es leer, um diesen Wert als Standard.

  • ReadOnly, der bestimmt, ob alle benutzerdefinierten Leistungsindikator Sie erstellen können geschrieben werden. Standardmäßig sämtliche Instanzen von PerformanceCounter Komponenten konfigurieren mit vorhandenen Windows-Leistungsindikatorfunktionen im Nur-Lesen-Modus arbeiten und nicht können Sie Werte in diesen Leistungsindikatoren zu ändern. Jedoch, wenn Sie die Komponenteninstanz zum Arbeiten mit einem benutzerdefinierten Leistungsindikator konfigurieren, müssen Sie eine Auswahl um den Standardwert in Nur-Lese-Modus arbeiten, oder der Wert der Eigenschaft in false damit zu schreibenden Werte zurücksetzen zu übernehmen.

    Hinweis

    Sie können Leistungsindikatoren nur auf dem lokalen Computer schreiben.Wenn Sie Leistungsindikatorwerte lesen möchten, können Sie jedem Computer auswählen, zu denen Sie Zugriff haben.

So konfigurieren Sie eine Instanz der PerformanceCounter-Komponente

  1. Erstellen Sie eine Instanz der Komponente PerformanceCounter. Weitere Informationen finden Sie unter SO WIRD'S GEMACHT: Erstellen von Instanzen von PerformanceCounter-Komponenten.

  2. Geben Sie den Leistungsindikator, mit dem Ihre Komponente interagieren sollte, indem Sie die folgenden Eigenschaften festlegen.

    -Eigenschaft

    Einstellung

    MachineName

    Auf jedem Server für die Sie Zugriff haben.

    CategoryName

    Jede Kategorie, die auf dem Server vorhanden ist.

    CounterName

    Jeder Leistungsindikator in der ausgewählten Kategorie.

  3. Wenn Leistungsindikator mit dem mehrere Instanzen verfügt, legen den richtigen Typ als Wert der Eigenschaft InstanceName fest.

  4. Wenn Sie mit einem benutzerdefinierten Leistungsindikator arbeiten und Schreibzugriff zugreifen möchten, legen Sie die ReadOnly -Eigenschaft auf false.

    Hinweis

    Sie können diese Eigenschaften entweder im Eigenschaftenfenster im Code, oder durch Verwenden besonderer Formen des Konstruktors für die Komponenteninstanz PerformanceCounter angeben.

    Das folgende Beispiel zeigt, wie diese Werte programmgesteuert einen vorhandenen Windows-Leistungsindikator namens "Transaktionen abgebrochen" Verbindung festgelegt würdeauf dem lokalen Server.

                                ' Connect to an existing Windows counter and category
                                Dim abortedTransactions AsNew PerformanceCounter()
    abortedTransactions.CategoryName =
       "distributed transaction coordinator"
    abortedTransactions.CounterName = "aborted transactions"
    abortedTransactions.MachineName = "."' Connect to a custom counter and category in writable mode
    PerformanceCounterCategory.Create("orders", "desc",
    PerformanceCounterCategoryType.SingleInstance, "milk", "desc")
    Dim myCounter2 AsNew PerformanceCounter("orders", "milk", False)
    
                                // Connect to an existing Windows counter and category
            System.Diagnostics.PerformanceCounter abortedTransactions =
               new System.Diagnostics.PerformanceCounter();
            abortedTransactions.CategoryName =
               "distributed transaction coordinator";
            abortedTransactions.CounterName = "aborted transactions";
            abortedTransactions.MachineName = ".";
            // Connect to a custom counter and category in writable mode
            System.Diagnostics.PerformanceCounterCategory.Create(
               "orders", "desc", PerformanceCounterCategoryType.SingleInstance,
               "milk", "desc");
            System.Diagnostics.PerformanceCounter myCounter2 =
               new System.Diagnostics.PerformanceCounter("orders", "milk", false);
    

Hinweis

In diesem Code "."repräsentiert den lokalen Computer.

Siehe auch

Aufgaben

SO WIRD'S GEMACHT: Erstellen von Instanzen von PerformanceCounter-Komponenten

SO WIRD'S GEMACHT: Erstellen benutzerdefinierter Leistungsindikatoren

Konzepte

Kategorie- und Indikatorverwaltung