uap3:Extension (Windows 10)

Deklariert einen Erweiterbarkeitspunkt für die App.

<Paket>

      <Anwendungen>

            <Anwendung>

                 <\uap3:Erweiterung>

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".' |
    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>

Schlüssel

? optional (null oder 1)

Attribute und Elemente

Attribute

attribute	Beschreibung	Datentyp	Erforderlich	Standardwert
Kategorie	Der Typ des Paketerweiterbarkeitspunkts.	Eine Zeichenfolge, die einen der folgenden Werte aufweisen kann: windows.appointmentDataProvider, windows.emailDataProvider, windows.contactDataProvider, windows.appUriHandler, windows.appExtensionHost, windows.appExtension, windows.appExtension, windows.protocol, windows.fileTypeAssociation.	Yes
EntryPoint	Die aktivierungsfähige Klassen-ID.	Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen Länge. Stellt die Aufgabe dar, die die Erweiterung behandelt (normalerweise der vollständig namespacequalifizierte Name eines Windows-Runtime-Typs). Wenn EntryPoint nicht angegeben ist, wird stattdessen der für die App definierte EntryPoint verwendet.	No
Ausführbare Datei	Die standardmäßige ausführbare Startdatei.	Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen Länge, die mit enden .exemuss und nicht die folgenden Zeichen enthalten darf: <, , >, :, ", , |, ?, oder *. Gibt die ausführbare Standarddatei für die Erweiterung an. Falls nicht angegeben, wird die ausführbare Datei verwendet, die für die App definiert ist. Falls angegeben, wird auch die EntryPoint-Eigenschaft verwendet. Wenn diese EntryPoint-Eigenschaft nicht angegeben wird, wird der für die App definierte EntryPoint verwendet.	No
Runtimetype	Der Laufzeitanbieter. Wird in der Regel verwendet, wenn in einer App gemischte Frameworks vorhanden sind.	Eine Zeichenfolge mit einem Wert zwischen 1 und 255 Zeichen Länge, die nicht mit einem . beginnen oder enden kann oder darin Zeichen enthält: <, , :>, , ", |, , ?oder *.	No
StartPage	Die Webseite, die den Erweiterungspunkt behandelt.	Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen Länge, die die folgenden Zeichen nicht enthalten kann: <, >, :, ", |, , ?oder *.	No
ResourceGroup	Ein optionales Tag zum Gruppieren von Erweiterungsaktivierungen für Ressourcenverwaltungszwecke (z. B. CPU und Arbeitsspeicher). Weitere Informationen finden Sie im Abschnitt Hinweise in Application@ResourceGroup.	Eine alphanumerische Zeichenfolge zwischen 1 und 255 Zeichen. Muss mit einem Buchstaben beginnen.	No
uap10:TrustLevel	Gibt die Vertrauensstufe der Erweiterung an.	Ein optionaler Zeichenfolgenwert. Wenn angegeben, kann es sich um einen der folgenden Werte handeln: appContainer oder mediumIL.	No
uap10:RuntimeBehavior	Gibt das Laufzeitverhalten einer Erweiterung an.	Ein optionaler Zeichenfolgenwert. Wenn angegeben, kann es sich um einen der folgenden Werte handeln: windowsApp, packagedClassicApp oder win32App.	No
uap10:HostId	Gibt die ID der Hostlaufzeit für die Erweiterung an.	Eine alphanumerische Zeichenfolge mit einem optionalen Wert zwischen 1 und 255 Zeichen Länge. Muss mit einem Buchstaben beginnen.	No
uap10:Parameter	Enthält Befehlszeilenparameter, die an die Erweiterung übergeben werden sollen. Nur für Desktop-Apps unterstützt.	Eine Zeichenfolge mit einem Wert zwischen 1 und 32767 Zeichen Länge mit einem Zeichen ohne Leerzeichen am Anfang und Ende.	No
uap11:ID	Ein Bezeichner für die Erweiterung. Die ID muss für alle Erweiterungen in einem Paket eindeutig sein.	Eine optionale Zeichenfolge mit einem Wert zwischen 1 und 255 Zeichen Länge mit einem Zeichen ohne Leerzeichen am Anfang und Ende.	No
uap11:Subsystem	Dieses Attribut wird von der Syntax der Basiserweiterung geerbt und gilt nicht für die com4-Erweiterung. Abgesehen von der syntaktischen Validierung wird dieser Wert ignoriert.	Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: Konsole oder Fenster.	No
uap11:SupportsMultipleInstances	Gibt an, ob Instanzen in unterschiedlichen Prozessen ausgeführt werden sollen. Der Standardwert ist „FALSE“.	Ein optionaler boolescher Wert.	No
uap11:ResourceGroup	Ein Tag, mit dem Sie Erweiterungsaktivierungen für Ressourcenverwaltungszwecke gruppieren können (z. B. CPU und Arbeitsspeicher). Der Wert, den Sie ResourceGroup festlegen können, ist freiform und flexibel. Siehe Application@ResourceGroup.	Eine optionale alphanumerische Zeichenfolge mit einem Wert zwischen 1 und 255 Zeichen Länge. Muss mit einem Buchstaben beginnen.	No
uap11:CurrentDirectoryPath	Gibt das Anfangsverzeichnis an, wenn der Anwendungsprozess gestartet wird. Dieses Attribut unterstützt Makros. Weitere Informationen finden Sie unter Makros im Paketmanifestschema.	Eine optionale Zeichenfolge, die die folgenden Zeichen nicht enthalten kann: <, >, |, ?oder *. >	No
uap11:Parameter	Dieses Attribut wird von der Syntax der Basiserweiterung geerbt und gilt nicht für die com4-Erweiterung. Abgesehen von der syntaktischen Validierung wird dieser Wert ignoriert. Dieses Attribut unterstützt Makros. Weitere Informationen finden Sie unter Makros im Paketmanifestschema.	Eine optionale Zeichenfolge mit einem Wert zwischen 1 und 32767 Zeichen Länge mit einem Zeichen ohne Leerzeichen am Anfang und Ende.	No
desktop7:CompatMode	Gibt an, ob die Informationen dieser Erweiterung bei Windows auf klassische Weise (z. B. unpacking apps register types with COM über the registry) oder auf neue, umfassendere Weise bei Windows registriert werden. Der Standardwert ist "modern". CompatMode="classic" erfordert die Microsoft.classicAppCompat_8wekyb3d8bbwe-Funktion .	Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: klassisch oder modern.	No
desktop7:Bereich	Gibt an, ob die Registrierungen nur für andere Anwendungen sichtbar sind, die als Benutzer ausgeführt werden, für den dieses Paket registriert ist (Benutzer), oder ob sie für alle Benutzer und Dienste auf dem Computer (Computer) sichtbar sind. Der Standardwert ist "user". Scope="machine" erfordert die Microsoft.classicAppCompatElevated_8wekyb3d8bbwe-Funktion .	Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: Computer oder Benutzer.	No

Untergeordnete Elemente

Untergeordnetes Element	Beschreibung
uap3:AppointmentDataProvider	Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.appointmentDataProvider.
uap3:EmailDataProvider	Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.emailDataProvider.
uap3:ContactDataProvider	Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.contactDataProvider.
uap3:AppUriHandler	Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.appUriHandler.
uap3:AppExtensionHost	Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.appExtensionHost.
uap3:AppExtension	Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.appExtension.
uap3:AppService	Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.appExtension.
uap3:AppExeuctionAlias	Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.appExecutionAlias.
uap3:Protokoll	Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.protocol.
uap3:FileTypeAssociation	Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.fileTypeAssociation.

Übergeordnete Elemente

Übergeordnetes Element	BESCHREIBUNG
Erweiterungen (Typ: CT_ApplicationExtensions)	Definiert einen oder mehrere Erweiterbarkeitspunkte für die App.

Beispiele

<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>

Anforderungen

Element	Wert
Namespace	http://schemas.microsoft.com/appx/manifest/uap/windows10/3
uap10	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Minimum OS Version	Windows 10 Version 1607 (Build 14393)