Elemento instrumentationManifest

Articolo
06/13/2023

Nodo radice del manifesto.

<xs:element name="instrumentationManifest">
    <xs:complexType>
        <xs:complexContent>
            <xs:extension
                base="InstrumentationManifestType"
            >
                <xs:choice
                    maxOccurs="3"
                >
                    <xs:choice>
                        <xs:element name="metadata"
                            type="MetadataType"
                         />
                        <xs:element name="instrumentation"
                            type="InstrumentationType"
                         />
                    </xs:choice>
                    <xs:element name="localization"
                        type="LocalizationType"
                     />
                    <xs:any
                        processContents="lax"
                        minOccurs="0"
                        maxOccurs="unbounded"
                        namespace="##other"
                     />
                </xs:choice>
            </xs:extension>
        </xs:complexContent>
    </xs:complexType>
</xs:element>

Elementi figlio

Elemento	Tipo	Descrizione
Strumentazione	InstrumentationType	Questa sezione definisce uno o più provider di eventi e gli eventi registrati.
Localizzazione	LocalizationType	Questa sezione definisce le stringhe di messaggio localizzate usate dai consumer per la visualizzazione. Ad esempio, questa sezione contiene la stringa di messaggio localizzata per il nome del provider, gli eventi definiti dall'utente e tutti gli attributi di evento definiti, ad esempio canali, attività e opcode.
Metadati	MetadataType	Questa sezione definisce i tipi di metadati che possono essere usati da altri manifesti. Per un esempio, vedere il file Winmeta.xml incluso nella cartella \Include di Windows SDK.

Commenti

L'elemento instrumentationManifest deve contenere gli spazi dei nomi seguenti:

xmlns="https://schemas.microsoft.com/win/2004/08/events" xmlns:win="https://manifests.microsoft.com/win/2004/08/windows/events" xmlns:xs="https://www.w3.org/2001/XMLSchema"

Un manifesto deve contenere una sezione di strumentazione e una sezione di localizzazione. La sezione strumentazione e i metadati si escludono a vicenda (non è possibile definire entrambi nello stesso manifesto). Anche se è possibile creare un manifesto contenente una sezione di metadati, il servizio non lo userà; gli unici metadati riconosciuti dal servizio sono i metadati trovati nel file Winmeta.xml.

Esempio

Nell'esempio seguente viene illustrato lo scheletro di un manifesto di strumentazione completamente definito.

<instrumentationManifest
    xmlns="http://schemas.microsoft.com/win/2004/08/events" 
    xmlns:win="https://manifests.microsoft.com/win/2004/08/windows/events"
    xmlns:xs="https://www.w3.org/2001/XMLSchema"    
    >

    <instrumentation>
        <events>
            <provider ...>
                <channels>
                    <importChanel .../>
                    <channel .../>
                </channels>
                <levels>
                <level .../>
                </levels>
                <tasks>
                    <task .../>
                </tasks>
                <opcodes>
                    <opcode .../>
                </opcodes>
                <keywords>
                    <keyword .../>
                </keywords>
                <filters>
                    <filter .../>
                </filters>
                <maps>
                    <valueMap ...>
                        <map .../>
                    </valueMap>
                    <bitMap ...>
                        <map .../>
                    </bitMap>
                </maps>
                <namedQueries>
                    <patternMap ...>
                        <map .../>
                    </patternMap>  
                </namedQueries>
                <templates>
                    <template ...>
                        <data .../>
                        <UserData>
                            <!-- valid XML fragment -->
                        </UserData>
                    </template>
                </templates>
                <events>
                    <event .../>
                </events>
            </provider>
        </events>
    </instrumentation>

    <localization>
        <resources ...>
            <stringTable>
                <string .../>
            </stringTable>
        </resources>
    </localization>

</instrumentationManifest>

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]

Condividi tramite