PerformanceCounter.InstanceName Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u een exemplaarnaam voor deze prestatiemeteritem op of stelt u deze in.
public:
property System::String ^ InstanceName { System::String ^ get(); void set(System::String ^ value); };public string InstanceName { get; set; }[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }member this.InstanceName : string with get, set[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, setPublic Property InstanceName As StringWaarde van eigenschap
De naam van het exemplaar van de prestatiemeteritemcategorie of een lege tekenreeks (""), als de teller een teller met één exemplaar is.
- Kenmerken
Voorbeelden
In het volgende codevoorbeeld wordt een standaardexemplaren van de PerformanceCounter klasse gemaakt. Nadat het exemplaar is gemaakt, worden de CategoryName, CounterNameen InstanceName eigenschapswaarden ingesteld en worden de resultaten van een aanroep naar de NextValue methode weergegeven.
PerformanceCounter performanceCounter = new PerformanceCounter();
performanceCounter.CategoryName = "Process";
performanceCounter.CounterName = "Private Bytes";
performanceCounter.InstanceName = "Explorer";
MessageBox.Show(performanceCounter.NextValue().ToString());
Dim PC As New PerformanceCounter()
PC.CategoryName = "Process"
PC.CounterName = "Private Bytes"
PC.InstanceName = "Explorer"
MessageBox.Show(PC.NextValue().ToString())
Opmerkingen
Note
Exemplaarnamen moeten korter zijn dan 128 tekens.
In sommige situaties worden categorieën onderverdeeld in exemplaren, die gegevens bijhouden over meerdere exemplaren van het object waarop een categorie betrekking heeft. Exemplaren zijn van toepassing op de categorie als geheel, in plaats van op afzonderlijke tellers. Elke teller binnen een categorie heeft elk exemplaar gedefinieerd voor de categorie. De categorie Proces bevat bijvoorbeeld exemplaren met de naam Niet-actief en Systeem. Elke teller binnen de categorie Proces bevat dus gegevens voor elk exemplaar, met informatie over niet-actieve processen of systeemprocessen.
Veel categorieën bevatten niet meerdere exemplaren, dus u kunt deze eigenschap leeg laten om aan te geven dat er geen exemplaar aan de categorie is gekoppeld.
Als dit PerformanceCounter exemplaar verwijst naar een niet-aangepaste categorie, kunt u alleen kiezen uit de bestaande categorie-exemplaren. U kunt alleen nieuwe categorie-exemplaren maken in aangepaste categorieën, zodat u zoveel tellers en categorie-exemplaren kunt definiëren als u nodig hebt.
Als u een exemplaar van een prestatiecategorie wilt maken, geeft u een instanceName op de PerformanceCounter constructor op. Als het categorie-exemplaar dat is opgegeven door instanceName al bestaat, verwijst het nieuwe object naar het bestaande categorie-exemplaar.
Note
Gebruik de tekens "(", ")", "#", "\" of "/" niet in de naam van het exemplaar. Als een van deze tekens wordt gebruikt, worden de exemplaarwaarden mogelijk niet correct weergegeven in de Performance Console (zie Runtimeprofilering).
Als de exemplaarnaam automatisch wordt gegenereerd en de tekens '(", ")", "#", "\" of "/" bevat, gebruikt u de tekentoewijzing in de volgende tabel.
| Karakter | Toegewezen teken |
|---|---|
| ( | [ |
| ) | ] |
| # | _ |
| \ | _ |
| / | _ |
De FriendlyName eigenschap van het AppDomain object dat is verkregen uit de AppDomain.CurrentDomain eigenschap is een algemene bron van exemplaarnamen die ongeldige tekens kunnen bevatten.
