PerformanceCounterCategory.Create Metodo

Definizione

Spazio dei nomi:: System.Diagnostics

Assembly:: System.Diagnostics.PerformanceCounter.dll

Assembly:: System.dll

Pacchetto:: System.Diagnostics.PerformanceCounter v11.0.0-preview.4.26230.115

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Registra una categoria di contatori delle prestazioni personalizzata e uno o più contatori con il sistema.

Overload

Nome	Descrizione
Create(String, String, String, String)	Obsoleti. Obsoleti. Obsoleti. Registra una categoria di contatori delle prestazioni personalizzata contenente un singolo contatore di tipo `NumberOfItems32` nel computer locale.
Create(String, String, PerformanceCounterCategoryType, String, String)	Registra la categoria di contatori delle prestazioni personalizzata contenente un singolo contatore di tipo NumberOfItems32 nel computer locale.
Create(String, String, CounterCreationDataCollection)	Obsoleti. Obsoleti. Obsoleti. Registra la categoria di contatori delle prestazioni personalizzata contenente i contatori specificati nel computer locale.
Create(String, String, PerformanceCounterCategoryType, CounterCreationDataCollection)	Registra la categoria di contatori delle prestazioni personalizzata contenente i contatori specificati nel computer locale.

Create(String, String, String, String)

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Attenzione

This overload of PerformanceCounterCategory.Create has been deprecated. Use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, string counterName, string counterHelp) instead.

Attenzione

This method has been deprecated. Please use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, string counterName, string counterHelp) instead. http://go.microsoft.com/fwlink/?linkid=14202

Attenzione

Registra una categoria di contatori delle prestazioni personalizzata contenente un singolo contatore di tipo NumberOfItems32 nel computer locale.

public:
 static System::Diagnostics::PerformanceCounterCategory ^ Create(System::String ^ categoryName, System::String ^ categoryHelp, System::String ^ counterName, System::String ^ counterHelp);

[System.Obsolete("This overload of PerformanceCounterCategory.Create has been deprecated. Use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, string counterName, string counterHelp) instead.")]
public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, string counterName, string counterHelp);

public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, string counterName, string counterHelp);

[System.Obsolete("This method has been deprecated.  Please use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, string counterName, string counterHelp) instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, string counterName, string counterHelp);

[System.Obsolete("This method has been deprecated.  Please use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, string counterName, string counterHelp) instead.  https://go.microsoft.com/fwlink/?linkid=14202")]
public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, string counterName, string counterHelp);

[<System.Obsolete("This overload of PerformanceCounterCategory.Create has been deprecated. Use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, string counterName, string counterHelp) instead.")>]
static member Create : string * string * string * string -> System.Diagnostics.PerformanceCounterCategory

static member Create : string * string * string * string -> System.Diagnostics.PerformanceCounterCategory

[<System.Obsolete("This method has been deprecated.  Please use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, string counterName, string counterHelp) instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
static member Create : string * string * string * string -> System.Diagnostics.PerformanceCounterCategory

[<System.Obsolete("This method has been deprecated.  Please use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, string counterName, string counterHelp) instead.  https://go.microsoft.com/fwlink/?linkid=14202")>]
static member Create : string * string * string * string -> System.Diagnostics.PerformanceCounterCategory

Public Shared Function Create (categoryName As String, categoryHelp As String, counterName As String, counterHelp As String) As PerformanceCounterCategory

Parametri

categoryName: String

Nome della categoria di contatori delle prestazioni personalizzata da creare e registrare nel sistema.

categoryHelp: String

Descrizione della categoria personalizzata.

counterName: String

Nome di un nuovo contatore, di tipo NumberOfItems32, da creare come parte della nuova categoria.

counterHelp: String

Descrizione del contatore associato alla nuova categoria personalizzata.

Valori restituiti

PerformanceCounterCategory

Oggetto PerformanceCounterCategory associato alla nuova categoria di sistema o oggetto prestazioni.

Attributi: ObsoleteAttribute

Eccezioni

ArgumentException

counterName è o è null una stringa vuota ("").

oppure

Il contatore specificato da counterName esiste già.

oppure

counterName ha una sintassi non valida. Può contenere caratteri barra rovesciata ("\") o lunghezza maggiore di 80 caratteri.

InvalidOperationException

La categoria esiste già nel computer locale.

ArgumentNullException

categoryName è null.

oppure

counterHelp è null.

Win32Exception

Chiamata a un'API di sistema sottostante non riuscita.

UnauthorizedAccessException

Codice in esecuzione senza privilegi amministrativi che ha tentato di leggere un contatore delle prestazioni.

Commenti

Note

Per leggere i contatori delle prestazioni da una sessione di accesso non interattiva in Windows Vista e versioni successive, Windows XP Professional x64 Edition o Windows Server 2003, è necessario essere membri del gruppo Monitor prestazioni Users o disporre di privilegi amministrativi.

Per evitare di dover elevare i privilegi per accedere ai contatori delle prestazioni in Windows Vista e versioni successive, aggiungere se stessi al gruppo Utenti di Monitor prestazioni.

In Windows Vista e versioni successive, Controllo account utente determina i privilegi di un utente. Se si è membri del gruppo Administrators predefinito, vengono assegnati due token di accesso in fase di esecuzione: un token di accesso utente standard e un token di accesso amministratore. Per impostazione predefinita, si è nel ruolo utente standard. Per eseguire il codice che accede ai contatori delle prestazioni, è necessario innanzitutto elevare i privilegi dall'utente standard all'amministratore. A tale scopo, è possibile avviare un'applicazione facendo clic con il pulsante destro del mouse sull'icona dell'applicazione e indicando che si vuole eseguire come amministratore.

Vedi anche

Si applica a

Create(String, String, PerformanceCounterCategoryType, String, String)

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Registra la categoria di contatori delle prestazioni personalizzata contenente un singolo contatore di tipo NumberOfItems32 nel computer locale.

public:
 static System::Diagnostics::PerformanceCounterCategory ^ Create(System::String ^ categoryName, System::String ^ categoryHelp, System::Diagnostics::PerformanceCounterCategoryType categoryType, System::String ^ counterName, System::String ^ counterHelp);

public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, System.Diagnostics.PerformanceCounterCategoryType categoryType, string counterName, string counterHelp);

static member Create : string * string * System.Diagnostics.PerformanceCounterCategoryType * string * string -> System.Diagnostics.PerformanceCounterCategory

Public Shared Function Create (categoryName As String, categoryHelp As String, categoryType As PerformanceCounterCategoryType, counterName As String, counterHelp As String) As PerformanceCounterCategory

Parametri

categoryName: String

Nome della categoria di contatori delle prestazioni personalizzata da creare e registrare nel sistema.

categoryHelp: String

Descrizione della categoria personalizzata.

categoryType: PerformanceCounterCategoryType

Uno dei PerformanceCounterCategoryType valori che specifica se la categoria è MultiInstance, SingleInstanceo Unknown.

counterName: String

Nome di un nuovo contatore da creare come parte della nuova categoria.

counterHelp: String

Descrizione del contatore associato alla nuova categoria personalizzata.

Valori restituiti

PerformanceCounterCategory

Oggetto PerformanceCounterCategory associato alla nuova categoria di sistema o oggetto prestazioni.

Eccezioni

ArgumentException

counterName è o è null una stringa vuota ("").

oppure

Il contatore specificato da counterName esiste già.

oppure

counterName ha una sintassi non valida. Può contenere caratteri barra rovesciata ("\") o lunghezza maggiore di 80 caratteri.

InvalidOperationException

La categoria esiste già nel computer locale.

ArgumentNullException

categoryName è null.

oppure

counterHelp è null.

Win32Exception

Chiamata a un'API di sistema sottostante non riuscita.

UnauthorizedAccessException

Codice in esecuzione senza privilegi amministrativi che ha tentato di leggere un contatore delle prestazioni.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del Create metodo . L'esempio mostra come creare una categoria di contatori delle prestazioni personalizzata a istanza singola.

Console.WriteLine("Creating Inventory custom counter");
if (!PerformanceCounterCategory.Exists("Inventory"))
    PerformanceCounterCategory.Create("Inventory",
        "Truck inventory",
        PerformanceCounterCategoryType.SingleInstance,
        "Trucks", "Number of trucks on hand");

Console.WriteLine("Creating Inventory custom counter")
If Not PerformanceCounterCategory.Exists("Inventory") Then
    PerformanceCounterCategory.Create("Inventory", "Truck inventory", PerformanceCounterCategoryType.SingleInstance, "Trucks", "Number of trucks on hand")
End If

Commenti

Il categoryType parametro specifica se la categoria del contatore delle prestazioni è a istanza singola o a istanza multipla. Per impostazione predefinita, una categoria è a istanza singola quando viene creata e diventa multiistanza quando viene aggiunta un'altra istanza. Le categorie vengono create quando viene configurata un'applicazione e le istanze vengono aggiunte in fase di esecuzione. L'enumerazione PerformanceCounterCategoryType viene utilizzata per indicare se un contatore delle prestazioni può avere più istanze.

Le categorie di contatori delle prestazioni installate con .NET usano memoria condivisa separata, con ogni categoria di contatori delle prestazioni con una propria memoria. È possibile specificare le dimensioni della memoria condivisa separata creando un DWORD denominato FileMappingSize nella chiave del Registro di sistema HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<nome> categoria\Prestazioni. Il valore FileMappingSize viene impostato sulle dimensioni della memoria condivisa della categoria. La dimensione predefinita è 131072 decimale. Se il valore FileMappingSize non è presente, viene utilizzato il fileMappingSize valore dell'attributo per l'elemento specificato nel file Machine.config, causando un sovraccarico aggiuntivo per l'elaborazione performanceCounters dei file di configurazione. È possibile ottenere un miglioramento delle prestazioni per l'avvio dell'applicazione impostando le dimensioni del mapping dei file nel Registro di sistema.

Note

È consigliabile creare nuove categorie di contatori delle prestazioni durante l'installazione dell'applicazione, non durante l'esecuzione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco delle categorie di contatori delle prestazioni registrate. Se l'elenco non è stato aggiornato, il tentativo di utilizzare la categoria avrà esito negativo.

Note

Per evitare di dover elevare i privilegi per accedere ai contatori delle prestazioni in Windows Vista e versioni successive, aggiungere se stessi al gruppo Utenti di Monitor prestazioni.

Vedi anche

Si applica a

Create(String, String, CounterCreationDataCollection)

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Attenzione

This method has been deprecated. Please use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, CounterCreationDataCollection counterData) instead. http://go.microsoft.com/fwlink/?linkid=14202

Attenzione

This method has been deprecated. Please use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, CounterCreationDataCollection counterData) instead. https://go.microsoft.com/fwlink/?linkid=14202

Registra la categoria di contatori delle prestazioni personalizzata contenente i contatori specificati nel computer locale.

public:
 static System::Diagnostics::PerformanceCounterCategory ^ Create(System::String ^ categoryName, System::String ^ categoryHelp, System::Diagnostics::CounterCreationDataCollection ^ counterData);

[System.Obsolete("This overload of PerformanceCounterCategory.Create has been deprecated. Use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, CounterCreationDataCollection counterData) instead.")]
public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, System.Diagnostics.CounterCreationDataCollection counterData);

public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, System.Diagnostics.CounterCreationDataCollection counterData);

[System.Obsolete("This method has been deprecated.  Please use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, CounterCreationDataCollection counterData) instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, System.Diagnostics.CounterCreationDataCollection counterData);

[System.Obsolete("This method has been deprecated.  Please use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, CounterCreationDataCollection counterData) instead.  https://go.microsoft.com/fwlink/?linkid=14202")]
public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, System.Diagnostics.CounterCreationDataCollection counterData);

[<System.Obsolete("This overload of PerformanceCounterCategory.Create has been deprecated. Use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, CounterCreationDataCollection counterData) instead.")>]
static member Create : string * string * System.Diagnostics.CounterCreationDataCollection -> System.Diagnostics.PerformanceCounterCategory

static member Create : string * string * System.Diagnostics.CounterCreationDataCollection -> System.Diagnostics.PerformanceCounterCategory

[<System.Obsolete("This method has been deprecated.  Please use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, CounterCreationDataCollection counterData) instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
static member Create : string * string * System.Diagnostics.CounterCreationDataCollection -> System.Diagnostics.PerformanceCounterCategory

[<System.Obsolete("This method has been deprecated.  Please use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, CounterCreationDataCollection counterData) instead.  https://go.microsoft.com/fwlink/?linkid=14202")>]
static member Create : string * string * System.Diagnostics.CounterCreationDataCollection -> System.Diagnostics.PerformanceCounterCategory

Public Shared Function Create (categoryName As String, categoryHelp As String, counterData As CounterCreationDataCollection) As PerformanceCounterCategory

Parametri

categoryName: String

Nome della categoria di contatori delle prestazioni personalizzata da creare e registrare nel sistema.

categoryHelp: String

Descrizione della categoria personalizzata.

counterData: CounterCreationDataCollection

Oggetto CounterCreationDataCollection che specifica i contatori da creare come parte della nuova categoria.

Valori restituiti

PerformanceCounterCategory

Oggetto PerformanceCounterCategory associato alla nuova categoria personalizzata o oggetto prestazioni.

Attributi: ObsoleteAttribute

Eccezioni

ArgumentException

Un nome di contatore specificato all'interno della counterData raccolta è null o una stringa vuota ("").

oppure

Un contatore specificato all'interno dell'insieme counterData esiste già.

ArgumentNullException

Il categoryName parametro è null.

InvalidOperationException

La categoria esiste già nel computer locale.

oppure

Il layout della counterData raccolta non è corretto per i contatori di base. Un contatore di tipo AverageCount64, AverageTimer32CounterMultiTimer, CounterMultiTimerInverse, CounterMultiTimer100Ns, CounterMultiTimer100NsInverseRawFractionSampleFraction o SampleCounter deve essere immediatamente seguito da uno dei tipi di contatore di base (AverageBase, MultiBase, RawBaseo ).SampleBase

Win32Exception

Chiamata a un'API di sistema sottostante non riuscita.

UnauthorizedAccessException

Codice in esecuzione senza privilegi amministrativi che ha tentato di leggere un contatore delle prestazioni.

Commenti

Note

Per evitare di dover elevare i privilegi per accedere ai contatori delle prestazioni in Windows Vista e versioni successive, aggiungere se stessi al gruppo Utenti di Monitor prestazioni.

Vedi anche

Si applica a

Create(String, String, PerformanceCounterCategoryType, CounterCreationDataCollection)

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Origine:: PerformanceCounterCategory.cs

Registra la categoria di contatori delle prestazioni personalizzata contenente i contatori specificati nel computer locale.

public:
 static System::Diagnostics::PerformanceCounterCategory ^ Create(System::String ^ categoryName, System::String ^ categoryHelp, System::Diagnostics::PerformanceCounterCategoryType categoryType, System::Diagnostics::CounterCreationDataCollection ^ counterData);

public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, System.Diagnostics.PerformanceCounterCategoryType categoryType, System.Diagnostics.CounterCreationDataCollection counterData);

static member Create : string * string * System.Diagnostics.PerformanceCounterCategoryType * System.Diagnostics.CounterCreationDataCollection -> System.Diagnostics.PerformanceCounterCategory

Public Shared Function Create (categoryName As String, categoryHelp As String, categoryType As PerformanceCounterCategoryType, counterData As CounterCreationDataCollection) As PerformanceCounterCategory

Parametri

categoryName: String

Nome della categoria di contatori delle prestazioni personalizzata da creare e registrare nel sistema.

categoryHelp: String

Descrizione della categoria personalizzata.

categoryType: PerformanceCounterCategoryType

Uno dei PerformanceCounterCategoryType valori.

counterData: CounterCreationDataCollection

Oggetto CounterCreationDataCollection che specifica i contatori da creare come parte della nuova categoria.

Valori restituiti

PerformanceCounterCategory

Oggetto PerformanceCounterCategory associato alla nuova categoria personalizzata o oggetto prestazioni.

Eccezioni

ArgumentException

Un nome di contatore specificato all'interno della counterData raccolta è null o una stringa vuota ("").

oppure

Un contatore specificato all'interno dell'insieme counterData esiste già.

ArgumentNullException

categoryName è null.

oppure

counterData è null.

ArgumentOutOfRangeException

categoryType value non rientra nell'intervallo dei valori seguenti: MultiInstance, SingleInstanceo Unknown.

InvalidOperationException

La categoria esiste già nel computer locale.

oppure

Il layout della counterData raccolta non è corretto per i contatori di base. Un contatore di tipo AverageCount64, AverageTimer32CounterMultiTimerCounterMultiTimerInverseCounterMultiTimer100Ns, CounterMultiTimer100NsInverseRawFraction, , , SampleFractiono SampleCounter deve essere immediatamente seguito da uno dei tipi di contatore di base (AverageBase, MultiBase, RawBaseo ).SampleBase

Win32Exception

Chiamata a un'API di sistema sottostante non riuscita.

UnauthorizedAccessException

Codice in esecuzione senza privilegi amministrativi che ha tentato di leggere un contatore delle prestazioni.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del Create metodo . L'esempio mostra come creare una categoria di contatori delle prestazioni personalizzata a istanze multipla per il numero di ordini al secondo.

CounterCreationData data1 = new CounterCreationData("Trucks",
    "Number of orders", PerformanceCounterType.NumberOfItems32);
CounterCreationData data2 = new CounterCreationData("Rate of sales",
    "Orders/second", PerformanceCounterType.RateOfCountsPerSecond32);
CounterCreationDataCollection ccds = new CounterCreationDataCollection();
ccds.Add(data1);
ccds.Add(data2);
Console.WriteLine("Creating Orders custom counter.");
if (!PerformanceCounterCategory.Exists("Orders"))
    PerformanceCounterCategory.Create("Orders",
        "Processed orders",
        PerformanceCounterCategoryType.MultiInstance,
        ccds);

Dim data1 As New CounterCreationData("Trucks", "Number of orders", PerformanceCounterType.NumberOfItems32)
Dim data2 As New CounterCreationData("Rate of sales", "Orders/second", PerformanceCounterType.RateOfCountsPerSecond32)
Dim ccds As New CounterCreationDataCollection()
ccds.Add(data1)
ccds.Add(data2)
Console.WriteLine("Creating Orders custom counter.")
If Not PerformanceCounterCategory.Exists("Orders") Then
    PerformanceCounterCategory.Create("Orders", "Processed orders", PerformanceCounterCategoryType.MultiInstance, ccds)
End If

Commenti

Note

Per evitare di dover elevare i privilegi per accedere ai contatori delle prestazioni in Windows Vista e versioni successive, aggiungere se stessi al gruppo Utenti di Monitor prestazioni.

Vedi anche

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?