uap4:Extension

Declareert een uitbreidbaarheidspunt voor de app.

Elementhiërarchie

<Pakket>

     <toepassingen>

          < >

               <extensies>

                    <uap4:Extension>

Syntaxis

<uap4:Extension
  Category = 'A string that can have one of the following values: "windows.sharedFonts", "windows.userDataTaskDataProvider", "windows.mediaCodec", "windows.contactPanel", "windows.loopbackAccessRules", "windows.devicePortalProvider", "windows.printWorkflowBackgroundTask", or "windows.printWorkflowForegroundTask".'
  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 -->
  uap4:SharedFonts
  uap4:UserDataTaskDataProvider
  uap4:MediaCodec 
  uap4:ContactPanel
  uap4:LoopbackAccessRules
  uap4:DevicePortalProvider?

</uap4:Extension>

Sleutel

? optioneel (nul of één)

Kenmerken en elementen

Kenmerken

Attribuut	Beschrijving	Gegevenstype	Vereist	Standaardwaarde
categorie	Het type uitbreidbaarheidspunt van het pakket.	Een tekenreeks met een van de volgende waarden: windows.sharedFonts, windows.userDataTaskDataProvider, windows.mediaCodec, windows.contactPanel, windows.loopbackAccessRules, windows.devicePortalProvider, windows.printWorkflowBackgroundTaskof windows.printWorkflowForegroundTask.	Ja
EntryPoint-	De activeringsbare klasse-id.	Een tekenreeks met een waarde tussen 1 en 256 tekens. Vertegenwoordigt de taak die de extensie verwerkt (normaal gesproken de volledig naamruimte-gekwalificeerde naam van een Windows Runtime-type). Als EntryPoint niet is opgegeven, wordt in plaats daarvan het EntryPoint gebruikt dat voor de app is gedefinieerd.	Nee
uitvoerbare	Het standaard uitvoerbare bestand starten.	Een tekenreeks met een waarde tussen 1 en 256 tekens lang, die moet eindigen op .exeen niet deze tekens mag bevatten: <, >, :, ", |, ?of *. Hiermee geeft u het standaard uitvoerbare bestand voor de extensie. Als dit niet is opgegeven, wordt het uitvoerbare bestand gebruikt dat voor de app is gedefinieerd. Indien opgegeven, wordt ook de eigenschap EntryPoint gebruikt. Als deze Eigenschap van EntryPoint niet is opgegeven, wordt het EntryPoint dat voor de app is gedefinieerd, gebruikt.	Nee
RuntimeType-	De runtime-provider. Wordt meestal gebruikt wanneer er mixed frameworks in een app zijn.	Een tekenreeks met een waarde tussen 1 en 255 tekens die niet kan beginnen of eindigen met een . of die tekens bevat: <, >, :, ", |, |, ?of *.	Nee
StartPage-	De webpagina die het uitbreidbaarheidspunt verwerkt.	Een tekenreeks met een waarde tussen 1 en 256 tekens die deze tekens niet mogen bevatten: <, >, :, ", |, ?of *.	Nee
ResourceGroup-	Een optionele tag die wordt gebruikt om uitbreidingsactiveringen te groeperen voor resourcebeheerdoeleinden (bijvoorbeeld CPU en geheugen). Zie de sectie Opmerkingen in Application@ResourceGroup.	Een alfanumerieke tekenreeks tussen 1 en 255 tekens lang. Moet beginnen met een brief.	Nee
uap10:TrustLevel	Hiermee geeft u het vertrouwensniveau van de extensie.	Een optionele tekenreekswaarde. Indien opgegeven, kan dit een van de volgende waarden zijn: appContainer of mediumIL-.	Nee
uap10:RuntimeBehavior	Hiermee geeft u het runtimegedrag van een extensie.	Een optionele tekenreekswaarde. Indien opgegeven, kan dit een van de volgende waarden zijn: windowsApp, packagedClassicAppof win32App.	Nee
uap10:HostId	Hiermee geeft u de id van de hostruntime voor de extensie.	Een alfanumerieke tekenreeks met een optionele waarde tussen 1 en 255 tekens. Moet beginnen met een brief.	Nee
uap10:Parameters	Bevat opdrachtregelparameters die moeten worden doorgegeven aan de extensie. Alleen ondersteund voor bureaublad-apps.	Een tekenreeks met een waarde tussen 1 en 32767 tekens lang met een niet-witruimteteken aan het begin en einde.	Nee
uap11:Id	Een id voor de extensie. De id moet uniek zijn voor alle extensies in een pakket.	Een optionele tekenreeks met een waarde tussen 1 en 255 tekens lang met een niet-witruimteteken aan het begin en einde.	Nee
uap11:Subsystem	Het subsysteem waarop de extensie betrekking heeft.	Een optionele tekenreeks met een van de volgende waarden: console of windows.	Nee
uap11:SupportsMultipleInstances	Hiermee geeft u op of exemplaren in verschillende processen moeten worden uitgevoerd. De standaardwaarde is onwaar.	Een optionele Booleaanse waarde.	Nee
uap11:ResourceGroup	Een tag die u kunt gebruiken om activeringen van extensies te groeperen voor resourcebeheerdoeleinden (bijvoorbeeld CPU en geheugen). De waarde die u ResourceGroup kunt instellen, is vrij en flexibel. Zie Application@ResourceGroup.	Een optionele alfanumerieke tekenreeks met een waarde tussen 1 en 255 tekens. Moet beginnen met een brief.	Nee
uap11:CurrentDirectoryPath	Hiermee geeft u de eerste map op wanneer het toepassingsproces wordt gestart. Dit kenmerk ondersteunt macro's. Zie Macro's in het pakketmanifestschemavoor meer informatie.	Een optionele tekenreeks die deze tekens niet mag bevatten: <, >, |, ?of *. >	Nee
uap11:Parameters	Het subsysteem waarop de extensie betrekking heeft. Dit kenmerk ondersteunt macro's. Zie Macro's in het pakketmanifestschemavoor meer informatie.	Een optionele tekenreeks met een waarde tussen 1 en 32767 tekens lang met een niet-witruimteteken aan het begin en einde.	Nee
desktop7:CompatMode	Hiermee geeft u op of de informatie van deze extensie op klassieke manieren is geregistreerd bij Windows (bijvoorbeeld uitgepakte apps registreren typen met COM via het register) of op nieuwe meer bereikde manieren. De standaardwaarde is 'modern'. CompatMode="classic" vereist de mogelijkheid Microsoft.classicAppCompat_8wekyb3d8bbwe.	Een optionele tekenreeks kan een van de volgende waarden hebben: klassieke of moderne.	Nee
desktop7:Bereik	Hiermee geeft u op of de registraties alleen zichtbaar zijn voor andere toepassingen die worden uitgevoerd als een gebruiker die dit pakket heeft geregistreerd (gebruiker), of dat ze zichtbaar zijn voor alle gebruikers en services op de computer (machine). De standaardwaarde is 'gebruiker'. Scope="machine" vereist de Microsoft.classicAppCompatElevated_8wekyb3d8bbwe mogelijkheid.	Een optionele tekenreeks die een van de volgende waarden kan hebben: machine of gebruiker.	Nee

Onderliggende elementen

Onderliggend element	Beschrijving
SharedFonts-	Bevat de locaties van gedeelde lettertypen die moeten worden gebruikt met de app.
UserDataTaskDataProvider	Hiermee kan een app een DataProvider voor een taak worden.
MediaCodec-	Hiermee definieert u een extensie waarmee een app mediacodecs kan installeren vanuit de Microsoft Store.
ContactPanel	Hiermee schakelt u het deelvenster contactpersonen in een Windows-app in.
LoopbackAccessRules	Bevat regels voor een loopbackfilter waarmee communicatie tussen een app en een service mogelijk is.
DevicePortalProvider	Hiermee definieert u een Device Portal-provider voor implementatie.

Bovenliggende elementen

Bovenliggend element	Beschrijving
extensies	Definieert een of meer uitbreidbaarheidspunten voor het pakket.

Opmerkingen

windows.printWorkflowBackgroundTask en windows.printWorkflowForegroundTask zijn lege uitbreidingsdeclaraties die ondersteuning bieden voor afdrukscenario's. Het beginpunt van de achtergrondtaak wordt in eerste instantie door het afdruksysteem aangeroepen om afdrukgegevens te verwerken en de voorgrondtaak wordt geactiveerd wanneer de gebruiker meer informatie aanvraagt. Het ingangspunt op de achtergrond moet een klasse zijn die IBackgroundTask-implementeert.

Eisen

Item	Waarde
naamruimte	http://schemas.microsoft.com/appx/manifest/uap/windows10/4
uap10-	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
minimale versie van het besturingssysteem	Windows 10 versie 1703 (build 15063)