Dela via


uap3:Extension (Windows 10)

Deklarerar en utökningspunkt för appen.

Element-hierarki

<Package>
   └─ <Applications>
      └─ <Application>
         └─ <uap3:Extension>

Syntax

<uap3:Extension
    Category = 'A string that can be one of the following values: "windows.appointmentDataProvider", "windows.emailDataProvider", "windows.contactDataProvider", "windows.appUriHandler", "windows.appExtensionHost", "windows.appExtension", "windows.protocol", "windows.fileTypeAssociation", "windows.appExecutionAlias".' |
    Executable = 'A string with an optional value between 1 and 256 characters in length, that must end with ".exe", and cannot contain the following characters: <, >, :, ", |, ?, or *. Specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If the EntryPoint property is not specified, the EntryPoint defined for the app is used.'
    EntryPoint = 'A string with an optional value between 1 and 256 characters in length. Represents the task handling the extension (normally the fully namespace-qualified name of a Windows Runtime type). If EntryPoint is not specified, the EntryPoint defined for the app is used instead.'
    RuntimeType = 'A string with an optional value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
    StartPage = 'A string with an optional value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
    ResourceGroup = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with a letter.'
    uap10:TrustLevel = 'An optional string value. If specified, it must be either "appContainer" or "mediumIL".'
    uap10:RuntimeBehavior  = 'An optional string value. If specified, it must be one of the following values:  "windowsApp", "packagedClassicApp", or "win32App".'
    uap10:HostId = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with an letter.'
    uap10:Parameters = 'A string with an optional value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' 
    uap11:Id = 'An optional string with a value between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
    uap11:Subsystem = 'An optional string that can have one of the following values: "console" or "windows".'
    uap11:SupportsMultipleInstances = 'An optional boolean value.'
    uap11:ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
    uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *. >'
    uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
    desktop7:CompatMode = 'An optional string the can have one of the following values: "classic" or "modern".'
    desktop7:Scope = 'An optional string that can have one of the following values: "machine" or "user".'>

    <!-- Child elements -->
    uap3:appointmentDataProvider?
    uap3:emailDataProvider?
    uap3:contactDataProvider?
    uap3:appUriHandler?
    uap3:appService?
    uap3:appExecutionAlias?
    uap3:fileTypeAssociation?

</uap3:Extension>

Nyckel

? valfritt (noll eller ett)

Attribut och element

Attributes

Attribute Beskrivning Datatyp Obligatoriskt Standardvärde
Kategori Typ av utökningspunkt för paket. En sträng som kan ha något av följande värden: windows.appointmentDataProvider, windows.emailDataProvider, windows.contactDataProvider, windows.appUriHandler, windows.appExtensionHost, windows.appExtension, windows.protocol, windows.fileTypeAssociation, windows.appExecutionAlias. Ja
EntryPoint Det aktiverbara klass-ID:t. En sträng med ett värde mellan 1 och 256 tecken långt. Representerar uppgiften som hanterar tillägget (normalt det fullständigt namnområdeskvalificerade namnet för en Windows Runtime typ). Om EntryPoint inte har angetts används den EntryPoint som definierats för appen i stället. No
körbar Standardstarten kan köras. En sträng med ett värde på mellan 1 och 256 tecken, som måste sluta med .exe, och får inte innehålla följande tecken: <, >, :, ", |, ?eller *. Anger den körbara standardinställningen för tillägget. Om det inte anges används den körbara fil som definierats för appen. Om det anges används även egenskapen EntryPoint. Om egenskapen EntryPoint inte har angetts används den EntryPoint som definierats för appen. No
RuntimeType Körningsprovidern. Används vanligtvis när det finns blandade ramverk i en app. En sträng med ett värde på mellan 1 och 255 tecken som inte kan startas eller sluta med en . eller som innehåller följande tecken: <, >, :, ", |, ?eller *. No
Startsida Webbsidan som hanterar utökningspunkten. En sträng med ett värde mellan 1 och 256 tecken som inte får innehålla följande tecken: <, >, :, ", |, ?eller *. No
ResourceGroup En valfri tagg som används för att gruppera tilläggsaktiveringar för resurshantering (till exempel CPU och minne). Se avsnittet Kommentarer i Application@ResourceGroup. En alfanumerisk sträng mellan 1 och 255 tecken lång. Måste börja med en bokstav. No
uap10:TrustLevel Anger förtroendenivån för tillägget. Ett valfritt strängvärde. Om det anges kan det vara något av följande värden: appContainer eller mediumIL. No
uap10:RuntimeBehavior Anger körningsbeteendet för ett tillägg. Ett valfritt strängvärde. Om det anges kan det vara något av följande värden: windowsApp, packagedClassicAppeller win32App. No
uap10:HostId Anger ID för värdkörningen för tillägget. En alfanumerisk sträng med ett valfritt värde mellan 1 och 255 tecken långt. Måste börja med en bokstav. No
uap10:Parameters Innehåller kommandoradsparametrar som ska skickas till tillägget. Stöds endast för skrivbordsappar. En sträng med ett värde mellan 1 och 32767 tecken långt med ett icke-blankstegstecken i början och slutet. No
uap11:Id En identifierare för tillägget. ID:t måste vara unikt för alla tillägg i ett paket. En valfri sträng med ett värde mellan 1 och 255 tecken långt med ett icke-blankstegstecken i början och slutet. No
uap11:Subsystem Det undersystem som tillägget riktar in sig på. En valfri sträng som kan ha något av följande värden: -konsolen eller windows. No
uap11:SupportsMultipleInstances Anger om instanser ska köras i olika processer. Standardvärdet är falskt. Ett valfritt booleskt värde. No
uap11:ResourceGroup En tagg som du kan använda för att gruppera tilläggsaktiveringar i resurshanteringssyfte (till exempel CPU och minne). Värdet du kan ange ResourceGroup är kostnadsfritt och flexibelt. Se Application@ResourceGroup. En valfri alfanumerisk sträng med ett värde mellan 1 och 255 tecken långt. Måste börja med en bokstav. No
uap11:CurrentDirectoryPath Anger den första katalogen när programprocessen startas. Det här attributet stöder makron. Mer information finns i Makron i paketmanifestschemat. En valfri sträng som inte får innehålla följande tecken: <, >, |, ?eller *. > No
uap11:Parameters Det undersystem som tillägget riktar in sig på. Det här attributet stöder makron. Mer information finns i Makron i paketmanifestschemat. En valfri sträng med ett värde mellan 1 och 32767 tecken långt med ett icke-blankstegstecken i början och slutet. No
desktop7:CompatMode Anger om det här tilläggets information registreras med Windows på klassiska sätt (t.ex. uppackade appar registrerar typer med COM via registret) eller på nya mer begränsade sätt. Standardvärdet är "modernt". CompatMode="classic" kräver funktionen Microsoft.classicAppCompat_8wekyb3d8bbwe. En valfri sträng kan ha något av följande värden: klassisk eller modern. No
desktop7:Scope Anger om registreringarna endast är synliga för andra program som körs som en användare som har det här paketet registrerat (användare) eller om de är synliga för alla användare och tjänster på datorn (datorn). Standardvärdet är "användare". Scope="machine" kräver funktionen Microsoft.classicAppCompatElevated_8wekyb3d8bbwe. En valfri sträng som kan ha något av följande värden: dator eller användare. No

Barnelement

Underordnat element Beskrivning
uap3:AppointmentDataProvider Deklarerar en apputökningspunkt av typen windows.appointmentDataProvider.
uap3:EmailDataProvider Deklarerar en appextensibilitetspunkt av typen windows.emailDataProvider.
uap3:ContactDataProvider Deklarerar en appextensibilitetspunkt av typen windows.contactDataProvider.
uap3:AppUriHandler Deklarerar en appextensibilitetspunkt av typen windows.appUriHandler.
uap3:AppExtensionHost Deklarerar en apputökningspunkt av typen windows.appExtensionHost.
uap3:AppExtension Deklarerar en apputökningspunkt av typen windows.appExtension.
uap3:AppService Deklarerar en apputökningspunkt av typen windows.appExtension.
uap3:AppExeuctionAlias Deklarerar en apputökningspunkt av typen windows.appExecutionAlias.
uap3:Protocol Deklarerar en appextensibilitetspunkt av typen windows.protocol.
uap3:FileTypeAssociation Deklarerar en appextensibilitetspunkt av typen windows.fileTypeAssociation.

Överordnade element

Överordnat element Beskrivning
Tillägg (typ: CT_ApplicationExtensions) Definierar en eller flera utökningspunkter för appen.

Exempel

<Package
    xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"  
    IgnorableNamespaces="... uap3">
    <Applications>
        <Application>
            <Extensions>
                <uap3:Extension
                    Category="windows.appointmentDataProvider" 
                    EntryPoint="UserDataProvider.AppointmentDataProviderTask">  
                    <uap3:AppointmentDataProvider
                        ServerName="MyDataProvider.PPLE" />  
                </uap3:Extension>  
            </Extensions>
        </Application>
    </Applications>
</Package>

Requirements

Objekt Värde
Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10/3
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
lägsta operativsystemversion Windows 10 version 1607 (version 14393)