área de trabalho:Extensão

Declara um ponto de extensibilidade para o aplicativo.

Hierarquia de elementos

<Pacote>

     <Aplicações>

          <\Application>

               <\Extensões>

                    <\Desktop:Extensão>

Sintaxe

<desktop:Extension
  Category = 'A string value that can be one of the following values: "windows.fullTrustProcess", "windows.startupTask", "windows.toastNotificationActivation", or "windows.searchProtocolHandler".'
  Executable = 'An optional string with a value between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *. It 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 that EntryPoint property isnt specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'An optional string with a value between 1 and 256 characters in length, representing the  task handling the extension. This is 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 = 'An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  ResourceGroup =  'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with an alphabetic character.'
  uap10:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  previewappcompat:CompatMode = 'An optional string that can have one of the following values: "classic" or "modern".'
  previewappcompat:Scope = 'An optional string that can be one of the following values: "user" or "machine".'
  uap11:Id = 'An optional string with a value between 1 and 256 characters in length.'
  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 with a value between 1 and 256 characters in length 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 = 'A string that can have one of the following values: "classic" or "modern".'
  desktop7:Scope = 'A string that can have one of the following values: "machine" or "user".' >

  <!-- Child elements -->
  desktop:FullTrustProcess?
  desktop:StartupTask?
  desktop:ToastNotificationActivation?
  desktop:SearchProtocolHandler?

</desktop:Extension>

Chave

? opcional (zero ou um)

Atributos e elementos

Atributos

Atributo	Descrição	Tipo de dados	Necessário	Valor padrão
Categoria	A categoria da extensão.	Um valor de cadeia de caracteres que pode ser um dos seguintes valores: windows.fullTrustProcess, windows.startupTask, windows.toastNotificationActivationou windows.searchProtocolHandler.	Sim
executáveis	O executável de inicialização padrão.	Uma cadeia de caracteres opcional com um valor entre 1 e 256 caracteres de comprimento que deve terminar com .exe e não pode conter estes caracteres: <, >, :, ", |, ?ou *. Ele especifica o executável padrão para a extensão. Se não for especificado, o executável definido para o aplicativo será usado. Se especificado, a propriedade EntryPoint também é usada. Se essa propriedade EntryPoint não for especificada, o EntryPoint definido para o aplicativo será usado.	Não
EntryPoint	O ID de classe ativável.	Uma cadeia de caracteres opcional com um valor entre 1 e 256 caracteres de comprimento, representando a tarefa que manipula a extensão. Normalmente, esse é o nome totalmente qualificado para namespace de um tipo do Tempo de Execução do Windows. Se EntryPoint não for especificado, o EntryPoint definido para o aplicativo será usado.	Não
RuntimeType	O provedor de tempo de execução. Esse atributo é usado normalmente quando há estruturas mistas em um aplicativo.	Uma cadeia de caracteres opcional com um valor entre 1 e 255 caracteres de comprimento que não pode começar ou terminar com um ponto ou conter estes caracteres: <, >, :, ", /, \, |, ?ou *.	Não
StartPage	A página da Web que manipula o ponto de extensibilidade.	Uma cadeia de caracteres opcional com um valor entre 1 e 256 caracteres de comprimento que não pode conter estes caracteres: <, >, :, ", |, ?ou *.	Não
uap10:TrustLevel	Especifica o nível de confiança da extensão.	Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: appContainer ou mediumIL.	Não
uap10:RuntimeBehavior	Especifica o comportamento de tempo de execução da extensão.	Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: windowsApp, packagedClassicAppou win32App.	Não
uap10:HostId	Especifica a ID do tempo de execução do host para a extensão.	Uma cadeia alfanumérica opcional com um valor entre 1 e 255 caracteres de comprimento. Deve começar com um caractere alfabético.	Não
uap10:Parâmetros	Contém parâmetros de linha de comando para passar para a extensão. Suportado apenas para aplicações de ambiente de trabalho com identidade de pacote.	Uma cadeia de caracteres opcional com um valor entre 1 e 32767 caracteres de comprimento com um caractere sem espaço em branco no início e no fim.	Não
uap11:Id	Um identificador para a extensão. O ID deve ser exclusivo para todas as extensões em um pacote.	Uma cadeia de caracteres opcional com um valor entre 1 e 255 caracteres de comprimento com um caractere sem espaço em branco no início e no fim.	Não
uap11:Subsistema	Este atributo é herdado da sintaxe da extensão base e não é aplicável à extensão com4. Além da validação sintática, esse valor é ignorado.	Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: console ou windows.	Não
uap11:SupportsMultipleInstances	Especifica se as instâncias devem ser executadas em processos diferentes. O valor padrão é false.	Um valor booleano opcional.	Não
uap11:ResourceGroup	Uma tag que você pode usar para agrupar ativações de extensão para fins de gerenciamento de recursos (por exemplo, CPU e memória). O valor que você pode definir ResourceGroup é de forma livre e flexível. Ver Application@ResourceGroup.	Uma cadeia alfanumérica opcional com um valor entre 1 e 255 caracteres de comprimento. Deve começar com uma letra.	Não
uap11:CurrentDirectoryPath	Especifica o diretório inicial quando o processo do aplicativo é iniciado. Este atributo suporta macros. Para obter mais informações, consulte Macros no esquema de manifesto do pacote.	Uma cadeia de caracteres opcional que não pode conter estes caracteres: <, >, |, ?ou *. >	Não
uap11:Parâmetros	Este atributo é herdado da sintaxe da extensão base e não é aplicável à extensão com4. Além da validação sintática, esse valor é ignorado. Este atributo suporta macros. Para obter mais informações, consulte Macros no esquema de manifesto do pacote.	Uma cadeia de caracteres opcional com um valor entre 1 e 32767 caracteres de comprimento com um caractere sem espaço em branco no início e no fim.	Não
desktop7:CompatMode	Especifica se as informações dessa extensão são registradas no Windows de maneiras clássicas (por exemplo, aplicativos não empacotados, tipos de registro com COM por meio do Registro) ou de maneiras novas e com mais escopo. O valor padrão é "moderno". CompatMode="classic" requer a capacidade de Microsoft.classicAppCompat_8wekyb3d8bbwe.	Uma cadeia de caracteres opcional pode ter um dos seguintes valores: clássico ou moderno.	Não
desktop7:Escopo	Especifica se os registros são visíveis apenas para outros aplicativos em execução como um usuário que tem esse pacote registrado (usuário) ou se eles são visíveis para todos os usuários e serviços na máquina (máquina). O valor padrão é "user". Scope="machine" requer a capacidade Microsoft.classicAppCompatElevated_8wekyb3d8bbwe.	Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: máquina ou usuário.	Não

Elementos filho

Elemento filho	Descrição
FullTrustProcess	Representa um processo de área de trabalho que é executado em confiança total.
StartupTask	Representa um processo da área de trabalho que é executado durante a inicialização do aplicativo.
ToastNotificationActivation	Permite que a notificação do sistema seja recebida dentro do aplicativo.
SearchProtocolHandler	Representa um processo da área de trabalho que lida com o protocolo de pesquisa para o aplicativo.

Elementos pai

Elemento pai	Descrição
Extensões	Declara um ponto de extensibilidade para o pacote.

Comentários

Requerimentos

Número	Valor
Espaço de nomes	http://schemas.microsoft.com/appx/manifest/foundation/windows10
uap10	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Versão mínima do SO	Windows 10 versão 1607 (compilação 14393)