Estensione (nel tipo: CT_ApplicationExtensions)

  • Articolo

Dichiara un punto di estendibilità per l'app.

Gerarchia degli elementi

<Pacchetto>
<Applicazioni>
<Applicazione>
<Estensioni>
<Estensione>

Sintassi

<Extension Category     = "windows.fileTypeAssociation" | "windows.protocol" | "windows.autoPlayContent" | "windows.autoPlayDevice" | "windows.shareTarget" | ...
           Executable?  = A string 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 isn't specified, the EntryPoint defined for the app is used.
           EntryPoint?  = A string 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? = A string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, %, ", /, \, |, ?, or *.
           StartPage?   = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, %, ", |, ?, or *. >

  <!-- Child elements -->
  ( FileTypeAssociation
  | Protocol
  | AutoPlayContent
  | AutoPlayDevice
  | ShareTarget
  | FileOpenPicker
  | FileSavePicker
  | BackgroundTasks
  )?

</Extension>

Chiave

? facoltativo (zero o uno)

Attributi ed elementi

Attributi

Attributo Descrizione Tipo di dati Obbligatoria Valore predefinito
Categoria

Tipo di punto di estendibilità dell'app.

Questo attributo può avere uno dei valori seguenti:

  • windows.fileTypeAssociation
  • windows.protocol
  • windows.autoPlayContent
  • windows.autoPlayDevice
  • windows.shareTarget
  • windows.search
  • windows.fileOpenPicker
  • windows.fileSavePicker
  • windows.cachedFileUpdater
  • windows.contactPicker
  • windows.backgroundTasks
  • windows.cameraSettings
  • windows.accountPictureProvider
  • windows.printTaskSettings
 Sì
EntryPoint

ID di classe attivabile.

 Stringa di lunghezza compresa tra 1 e 256 caratteri, che rappresenta l'attività che gestisce l'estensione. Si tratta in genere il nome completo dello spazio dei nomi di tipo Windows Runtime. Se EntryPoint non viene specificato, viene usato l'oggetto EntryPoint definito per l'app. No
File eseguibile

Eseguibile di avvio predefinito.

 Stringa di lunghezza compresa tra 1 e 256 caratteri che deve terminare con ".exe" e non può contenere questi caratteri: <, >, :, %, ", |, ?o *. Specifica l'eseguibile predefinito per l'estensione. Se non viene specificato, viene usato l'eseguibile definito per l'app. Se specificato, viene usata anche la proprietà EntryPoint. Se tale proprietà EntryPoint non viene specificata, viene usato il entrypoint definito per l'app. No
RuntimeType

Provider di runtime. Questo attributo viene usato in genere quando in un'app sono presenti framework misti.

 Stringa di lunghezza compresa tra 1 e 255 caratteri che non può iniziare o terminare con un punto o contenere questi caratteri: <, >, :, %, ", /, \, |, ?o *. No
StartPage

Pagina Web che gestisce il punto di estendibilità.

 Stringa di lunghezza compresa tra 1 e 256 caratteri che non può contenere questi caratteri: <, >, :, %, ", |, ?o *. No

 

Elementi figlio

Elemento figlio Descrizione
AutoPlayContent

Dichiara un punto di estendibilità dell'app di tipo windows.autoPlayContent. L'app fornisce le azioni del contenuto AutoPlay specificate.
AutoPlayDevice

Dichiara un punto di estendibilità dell'app di tipo windows.autoPlayDevice. L'app fornisce le azioni del dispositivo AutoPlay specificate.
BackgroundTasks

Definisce un punto di estendibilità dell'app di tipo windows.backgroundTasks. Le attività in background vengono eseguite in un host in background dedicato. cio, senza un'interfaccia utente.
FileOpenPicker

Dichiara un punto di estendibilità dell'app di tipo windows.fileOpenPicker. L'app consente all'utente di scegliere e aprire i tipi di file specificati.
FileSavePicker

Dichiara un punto di estendibilità dell'app di tipo windows.fileSavePicker. L'app consente all'utente di scegliere il nome file, l'estensione e il percorso di archiviazione per i tipi di file specificati.
FileTypeAssociation

Dichiara un punto di estendibilità dell'app di tipo windows.fileTypeAssociation. Un'associazione di tipo file indica che l'app è registrata per gestire i file dei tipi specificati.
Protocollo

Dichiara un punto di estendibilità dell'app di tipo windows.protocol. Un'associazione URI indica che l'app è registrata per gestire gli URI con lo schema specificato.
ShareTarget

Dichiara un punto di estensione dell'app di tipo windows.shareTarget. L'app può condividere i tipi di file specificati.

 

Elementi padre

Elemento padre Descrizione
Estensioni (tipo: CT_ApplicationExtensions)

Definisce uno o più punti di estendibilità per l'app.

 

Gli elementi seguenti hanno lo stesso nome di questo elemento, ma il contenuto o gli attributi sono diversi:

Commenti

Questi punti di estendibilità possono essere dichiarati una sola volta per ogni app:

  • windows.accountPictureProvider
  • windows.cachedFileUpdater
  • windows.cameraSettings
  • windows.contactPicker
  • windows.fileOpenPicker
  • windows.fileSavePicker
  • windows.printTaskSettings
  • windows.search
  • Windows.shareTarget

**Nota sulle regole semantiche per le estensioni: **Per qualsiasi elemento Extension, nell'API manifesto vengono applicate le regole semantiche seguenti:

Se /Application/@StartPage specificato, si tratta di un'app Windows usando JavaScript e l'estensione dell'app :

  • Può essere vuoto
  • Può specificare solo StartPage
  • Può specificare sia Executable che EntryPoint (runtimeType facoltativo consentito), a meno che non si tratta di un'estensione BackgroundTask, nel qual caso è possibile omettere executable e impostare per impostazione predefinita l'eseguibile BackgroundTaskHost.exe.

Se /Application/@StartPage non è specificato, si tratta di un'app UWP che usa C# o VB e XAML e l'estensione dell'app :

  • Può essere vuoto
  • Può specificare solo StartPage
  • Deve specificare EntryPoint se si specifica Executable o RuntimeType.

Esempio

L'esempio seguente è tratto dal manifesto del pacchetto di uno degli esempi sdk.

<Applications>
  <Application Id="App" StartPage="default.html">
    <VisualElements DisplayName="Assocation launching sample" 
         Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png" 
         Description="SDK sample" 
         ForegroundText="dark" BackgroundColor="#FFFFFF" ToastCapable="false">
      <DefaultTile ShowName="allLogos" />
      <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png" />
    </VisualElements>
    <Extensions>
      <Extension Category="windows.fileTypeAssociation">
        <FileTypeAssociation Name=".alsdkjs">
          <SupportedFileTypes>
            <FileType>.alsdkjs</FileType>
          </SupportedFileTypes>
        </FileTypeAssociation>
      </Extension>
      <Extension Category="windows.protocol">
        <Protocol Name="alsdkjs" />
      </Extension>
    </Extensions>
  </Application>
</Applications>

Vedi anche

ConcettiAppcontracts and extensions (Concetti: contratti ed estensioni dell'app)

Requisiti

Valore
Namespace http://schemas.microsoft.com/appx/2010/manifest