Partilhar via


desktop2:Extension (em Pacote/Extensões)

Declara um ponto de extensibilidade para o aplicativo.

Hierarquia de elementos

<Pacote>

    <Extensões>

         <desktop2:Extension>

Syntax

<Extension
  Category = 'A string that can have one of the following values: "windows.firewallRules" or "windows.desktopEventLogging".' 
  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 *.'
  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 a letter.'
  uap10:Parameters = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' >

  <!-- Child elements -->
  desktop2:FirewallRules
  desktop2:DesktopEventLogging?

</uap:Extension>

Chave

? opcional (zero ou um)

Atributos e elementos

Atributos

Atributo Descrição Tipo de dados Obrigatório Valor padrão
Categoria A categoria da extensão. Uma cadeia de caracteres que pode ter um dos seguintes valores: windows.firewallRules ou windows.desktopEventLogging. Yes
Executável 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 esses 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 especificada, a propriedade EntryPoint também será usada. Se essa propriedade EntryPoint não for especificada, o EntryPoint definido para o aplicativo será usado. No
EntryPoint A ID da classe ativada. Uma cadeia de caracteres opcional com um valor entre 1 e 256 caracteres de comprimento, representando a tarefa que manipula a extensão. Normalmente é o nome totalmente qualificado do namespace de um tipo do Windows Runtime. Se EntryPoint não for especificado, o EntryPoint definido para o aplicativo será usado. No
Runtimetype O provedor de runtime. 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 iniciar ou terminar com um período ou conter esses caracteres: <, >, , :, ", \/, |, ?ou *. No
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 esses caracteres: <, >, , :, ", |?ou *. No
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. No
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, packagedClassicApp ou win32App. No
uap10:HostId Especifica a ID do runtime do host para a extensão. Uma cadeia de caracteres alfanumérica opcional com um valor entre 1 e 255 caracteres de comprimento. Deve começar com uma letra. No
uap10:Parameters Contém parâmetros de linha de comando para passar para a extensão. Há suporte apenas para aplicativos da área de trabalho que têm identidade de pacote. Uma cadeia de caracteres com um valor entre 1 e 32767 caracteres de comprimento com um caractere não whitespace no início e no final. No

Elementos filho

Elemento filho Descrição
AppPrinter Permite a capacidade de instalar impressoras de arquivos de software em aplicativos do Windows Ponte de Desktop.
SearchFilterHandler Permite que aplicativos do Windows Ponte de Desktop registrem IFilters para extrair propriedades de arquivo para pesquisa.
SearchPropertyHandler Permite que os aplicativos do Windows Ponte de Desktop instalem manipuladores de propriedades em seu sistema.
DesktopEventLogging Permite que aplicativos do Windows Ponte de Desktop se registrem no log de eventos do Windows.
FirewallRules Especifica as regras de exceção de firewall usadas pelos aplicativos do Windows Ponte de Desktop.

Elementos pai

Elemento pai Descrição
desktop2:Extension Declara um ponto de extensibilidade para o aplicativo.

Requisitos

Item Valor
Namespace http://schemas.microsoft.com/appx/manifest/desktop/windows10/2
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Minimum OS Version Windows 10 versão 1703 (Build 15063)