<forcePerformanceCounterUniqueSharedMemoryReads> elemento<forcePerformanceCounterUniqueSharedMemoryReads> Element

Specifica se PerfCounter.dll usa l'impostazione del Registro di sistema CategoryOptions in un'applicazione di .NET Framework versione 1.1 per determinare se caricare i dati del contatore delle prestazioni dalla memoria condivisa specifica della categoria o dalla memoria globale.Specifies whether PerfCounter.dll uses the CategoryOptions registry setting in a .NET Framework version 1.1 application to determine whether to load performance counter data from category-specific shared memory or global memory.

<configuration><configuration>
<runtime><runtime>
<forcePerformanceCounterUniqueSharedMemoryReads ><forcePerformanceCounterUniqueSharedMemoryReads>

SintassiSyntax

<forcePerformanceCounterUniqueSharedMemoryReads   
enabled="true|false"/>  

Attributi ed elementiAttributes and Elements

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.The following sections describe attributes, child elements, and parent elements.

AttributiAttributes

AttributoAttribute DescrizioneDescription
enabled Attributo obbligatorio.Required attribute.

Indica se PerfCounter utilizza l'impostazione del Registro di sistema CategoryOptions per determinare se caricare i dati dei contatori delle prestazioni da specifiche della categoria di memoria condivisa o la memoria globale.Indicates whether PerfCounter.dll uses the CategoryOptions registry setting to determine whether to load performance counter data from category-specific shared memory or global memory.

Attributo enabledenabled Attribute

ValoreValue DescrizioneDescription
false PerfCounter non utilizza il CategoryOptions questa impostazione del registro è il valore predefinito.PerfCounter.dll does not use the CategoryOptions registry setting This is the default.
true PerfCounter utilizzare l'impostazione del Registro di sistema CategoryOptions.PerfCounter.dll does use the CategoryOptions registry setting.

Elementi figlioChild Elements

Nessuno.None.

Elementi padreParent Elements

ElementoElement DescrizioneDescription
configuration Elemento radice in ciascun file di configurazione usato in Common Language Runtime e nelle applicazioni .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
runtime Contiene informazioni sull'associazione degli assembly e sull'operazione di Garbage Collection.Contains information about assembly binding and garbage collection.

NoteRemarks

Nelle versioni di .NET Framework prima di .NET Framework 4.NET Framework 4, la versione di PerfCounter che è stato caricato corrispondeva al runtime che è stato caricato nel processo.In versions of the .NET Framework before the .NET Framework 4.NET Framework 4, the version of PerfCounter.dll that was loaded corresponded to the runtime that was loaded in the process. Se un computer dispone sia a .NET Framework versione 1.1 e .NET Framework 2.0.NET Framework 2.0 installato, un'applicazione .NET Framework 1.1 carica la versione di .NET Framework 1.1 di PerfCounter.If a computer had both the .NET Framework version 1.1 and the .NET Framework 2.0.NET Framework 2.0 installed, a .NET Framework 1.1 application would load the .NET Framework 1.1 version of PerfCounter.dll. A partire dal .NET Framework 4.NET Framework 4, viene caricata la versione installata più recente di PerfCounter.Starting with the .NET Framework 4.NET Framework 4, the newest installed version of PerfCounter.dll is loaded. Ciò significa che un'applicazione .NET Framework 1.1 caricherà il .NET Framework 4.NET Framework 4 versione di PerfCounter. Se il .NET Framework 4.NET Framework 4 è installato nel computer.This means that a .NET Framework 1.1 application will load the .NET Framework 4.NET Framework 4 version of PerfCounter.dll if the .NET Framework 4.NET Framework 4 is installed on the computer.

A partire dal .NET Framework 4.NET Framework 4, quando si utilizzano i contatori delle prestazioni, PerfCounter controlla la voce del Registro di sistema CategoryOptions per ogni provider per determinare se è necessario leggere dalla memoria condivisa specifiche della categoria o la memoria globale condivisa.Starting with the .NET Framework 4.NET Framework 4, when consuming performance counters, PerfCounter.dll checks the CategoryOptions registry entry for each provider to determine whether it should read from category-specific shared memory or global shared memory. Di PerfCounter 1.1 di .NET Framework non legge la voce del Registro di sistema, perché non è compatibile con di memoria condivisa specifiche della categoria. legge sempre dalla memoria condivisa globale.The .NET Framework 1.1 PerfCounter.dll does not read that registry entry, because it is not aware of category-specific shared memory; it always reads from global shared memory.

Per garantire la compatibilità con le versioni precedenti, il .NET Framework 4.NET Framework 4 PerfCounter non controlla la voce del Registro di sistema CategoryOptions durante l'esecuzione in un'applicazione .NET Framework 1.1.For backward compatibility, the .NET Framework 4.NET Framework 4 PerfCounter.dll does not check the CategoryOptions registry entry when running in a .NET Framework 1.1 application. Usa semplicemente la memoria globale condivisa, come il PerfCounter 1.1 di .NET Framework.It simply uses global shared memory, just like the .NET Framework 1.1 PerfCounter.dll. Tuttavia, è possibile indicare il .NET Framework 4.NET Framework 4 PerfCounter per controllare l'impostazione del Registro di sistema, consentendo il <forcePerformanceCounterUniqueSharedMemoryReads> elemento.However, you can instruct the .NET Framework 4.NET Framework 4 PerfCounter.dll to check the registry setting by enabling the <forcePerformanceCounterUniqueSharedMemoryReads> element.

Nota

Abilitazione di <forcePerformanceCounterUniqueSharedMemoryReads> elemento non garantisce che verrà utilizzata la memoria condivisa specifiche della categoria.Enabling the <forcePerformanceCounterUniqueSharedMemoryReads> element does not guarantee that category-specific shared memory will be used. L'impostazione abilitata su true solo provoca PerfCounter fare riferimento l'impostazione del Registro di sistema CategoryOptions.Setting enabled to true only causes PerfCounter.dll to reference the CategoryOptions registry setting. L'impostazione predefinita per CategoryOptions consiste nell'utilizzare la memoria condivisa specifiche della categoria. Tuttavia, è possibile modificare CategoryOptions per indicare che la memoria globale condivisa deve essere utilizzata.The default setting for CategoryOptions is to use category-specific shared memory; however, you can change CategoryOptions to indicate that global shared memory should be used.

La chiave del Registro di sistema che contiene l'impostazione CategoryOptions è HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\< categoryName>\Performance.The registry key that contains the CategoryOptions setting is HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\<categoryName>\Performance. Per impostazione predefinita, CategoryOptions è impostato su 3, che indica di PerfCounter utilizzare memoria condivisa specifiche della categoria.By default, CategoryOptions is set to 3, which instructs PerfCounter.dll to use category-specific shared memory. Se CategoryOptions è impostata su 0, PerfCounter utilizza memoria condivisa globale.If CategoryOptions is set to 0, PerfCounter.dll uses global shared memory. Dati dell'istanza verranno riutilizzati solo se il nome dell'istanza da creare è identico all'istanza venga riutilizzato.Instance data will be reused only if the name of the instance being created is identical to the instance being reused. Tutte le versioni sarà in grado di scrivere in tale categoria.All versions will be able to write to the category. Se CategoryOptions è impostato su 1, viene utilizzata la memoria globale condivisa, ma è possibile riutilizzare i dati di istanza se il nome di categoria è uguale alla lunghezza della categoria riutilizzata.If CategoryOptions is set to 1, global shared memory is used, but instance data can be reused if the category name is the same length as the category being reused.

Le impostazioni di 0 e 1 possono causare perdite di memoria e il riempimento di memoria dei contatori delle prestazioni.The settings 0 and 1 can lead to memory leaks and the filling up of performance counter memory.

EsempioExample

Nell'esempio seguente viene illustrato come specificare che PerfCounter devono fare riferimento la voce del Registro di sistema CategoryOptions per determinare se deve utilizzare memoria condivisa specifiche della categoria.The following example shows how to specify that PerfCounter.dll should reference the CategoryOptions registry entry to determine whether it should use category-specific shared memory.

<configuration>  
  <runtime>  
    <forcePerformanceCounterUniqueSharedMemoryReads enabled="true"/>  
  </runtime>  
</configuration>  

Vedere ancheSee Also

Schema delle impostazioni di runtimeRuntime Settings Schema
Schema dei file di configurazioneConfiguration File Schema