Extension (nel tipo: CT_ApplicationExtensions)Extension (in type: CT_ApplicationExtensions)

Dichiara un punto di estendibilità per l'app.Declares an extensibility point for the app.

Gerarchia degli elementiElement hierarchy

<Pacchetto>
<Package>
<Applicazioni>
<Applications>
<Applicazione>
<Application>
<Estensioni>
<Extensions>
<Estensione><Extension>

SintassiSyntax

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

ChiaveKey

?   facoltativo (zero o uno)?   optional (zero or one)

Attributi ed elementiAttributes and Elements

AttributiAttributes

AttributoAttribute DescrizioneDescription Tipo di datiData type ObbligatoriaRequired Valore predefinitoDefault value
CategoriaCategory

Tipo di punto di estendibilità dell'app.The type of app extensibility point.

Questo attributo può avere uno dei valori seguenti:This attribute can have one of the following values:

  • Windows. fileTypeAssociationwindows.fileTypeAssociation
  • Windows. Protocolwindows.protocol
  • Windows. autoPlayContentwindows.autoPlayContent
  • Windows. autoPlayDevicewindows.autoPlayDevice
  • Windows. shareTargetwindows.shareTarget
  • Windows. searchwindows.search
  • Windows. fileOpenPickerwindows.fileOpenPicker
  • Windows. fileSavePickerwindows.fileSavePicker
  • Windows. cachedFileUpdaterwindows.cachedFileUpdater
  • Windows. contactPickerwindows.contactPicker
  • Windows. backgroundTaskswindows.backgroundTasks
  • Windows. cameraSettingswindows.cameraSettings
  • Windows. accountPictureProviderwindows.accountPictureProvider
  • Windows. printTaskSettingswindows.printTaskSettings
Yes
EntryPointEntryPoint

ID della classe attivabile.The activatable class ID.

Stringa di lunghezza compresa tra 1 e 256 caratteri, che rappresenta l'attività che gestisce l'estensione.A string between 1 and 256 characters in length, representing the task handling the extension. Si tratta in genere il nome completo dello spazio dei nomi di tipo Windows Runtime.This is normally the fully namespace-qualified name of a Windows Runtime type. Se EntryPoint non è specificato, viene usato il EntryPoint definito per l'app.If EntryPoint is not specified, the EntryPoint defined for the app is used instead. NoNo
File eseguibileExecutable

Eseguibile di avvio predefinito.The default launch executable.

Una stringa di lunghezza compresa tra 1 e 256 caratteri che deve terminare con " . exe " e non può contenere i caratteri seguenti: < , > ,:,%, " , |,? o \*.A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, %, ", |, ?, or \*. Specifica il file eseguibile predefinito per l'estensione.It specifies the default executable for the extension. Se non specificato, viene usato il file eseguibile definito per l'app.If not specified, the executable defined for the app is used. Se specificato, viene utilizzata anche la proprietà EntryPoint.If specified, the EntryPoint property is also used. Se tale proprietà EntryPoint non è specificata, viene usato il EntryPoint definito per l'app.If that EntryPoint property isn't specified, the EntryPoint defined for the app is used. NoNo
RuntimeTypeRuntimeType

Provider di Runtime.The runtime provider. Questo attributo viene usato in genere in presenza di Framework misti in un'app.This attribute is used typically when there are mixed frameworks in an app.

Una stringa di lunghezza compresa tra 1 e 255 caratteri non può iniziare o terminare con un punto o contenere i caratteri seguenti: < , > ,:,%, " ,/, \, |,? o \*.A string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, %, ", /, \, |, ?, or \*. NoNo
StartPageStartPage

Pagina Web che gestisce il punto di estendibilità.The web page that handles the extensibility point.

Una stringa di lunghezza compresa tra 1 e 256 caratteri che non può contenere i caratteri seguenti: < , > ,:,%, " , |,? o \*.A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, %, ", |, ?, or \*. NoNo

 

Elementi figlioChild Elements

Elemento figlioChild Element DescrizioneDescription
AutoPlayContent AutoPlayContent

Dichiara un punto di estendibilità dell'app di tipo Windows. autoPlayContent.Declares an app extensibility point of type windows.autoPlayContent. L'app fornisce le azioni di contenuto AutoPlay specificate.The app provides the specified AutoPlay content actions.

AutoPlayDevice AutoPlayDevice

Dichiara un punto di estendibilità dell'app di tipo Windows. autoPlayDevice.Declares an app extensibility point of type windows.autoPlayDevice. L'app fornisce le azioni del dispositivo AutoPlay specificate.The app provides the specified AutoPlay device actions.

BackgroundTasks BackgroundTasks

Definisce un punto di estendibilità dell'app di tipo Windows. backgroundTasks.Defines an app extensibility point of type windows.backgroundTasks. Le attività in background vengono eseguite in un host in background dedicato; ovvero senza un'interfaccia utente.Background tasks run in a dedicated background host; that is, without a UI.

FileOpenPicker FileOpenPicker

Dichiara un punto di estendibilità dell'app di tipo Windows. FileOpenPicker.Declares an app extensibility point of type windows.fileOpenPicker. L'app consente all'utente di scegliere e aprire i tipi di file specificati.The app lets the user choose and open the specified types of files.

FileSavePicker FileSavePicker

Dichiara un punto di estendibilità dell'app di tipo Windows. FileSavePicker.Declares an app extensibility point of type windows.fileSavePicker. L'app consente all'utente di scegliere il nome del file, l'estensione e il percorso di archiviazione per i tipi di file specificati.The app lets the user choose the file name, extension, and storage location for the specified types of files.

FileTypeAssociation FileTypeAssociation

Dichiara un punto di estendibilità dell'app di tipo Windows. fileTypeAssociation.Declares an app extensibility point of type windows.fileTypeAssociation. Un'associazione del tipo di file indica che l'app è registrata per gestire i file dei tipi specificati.A file type association indicates that the app is registered to handle files of the specified types.

Protocollo Protocol

Dichiara un punto di estendibilità dell'app di tipo Windows. Protocol.Declares an app extensibility point of type windows.protocol. Un'associazione URI indica che l'app è registrata per gestire gli URI con lo schema specificato.A URI association indicates that the app is registered to handle URIs with the specified scheme.

ShareTarget ShareTarget

Dichiara un punto di estensione dell'app di tipo Windows. ShareTarget.Declares an app extension point of type windows.shareTarget. L'app può condividere i tipi di file specificati.The app can share the specified types of files.

 

Elementi padreParent Elements

Elemento padreParent Element DescrizioneDescription
Estensioni (tipo: CT_ApplicationExtensions) Extensions (type: CT_ApplicationExtensions)

Definisce uno o più punti di estensibilità per l'app.Defines one or more extensibility points for the app.

 

Gli elementi seguenti hanno lo stesso nome di questo elemento, ma il contenuto o gli attributi sono diversi:The following elements have the same name as this one, but different content or attributes:

OsservazioniRemarks

Questi punti di estendibilità possono essere dichiarati una sola volta per ogni app:These extensibility points can be declared only once per app:

  • Windows. accountPictureProviderwindows.accountPictureProvider
  • Windows. cachedFileUpdaterwindows.cachedFileUpdater
  • Windows. cameraSettingswindows.cameraSettings
  • Windows. contactPickerwindows.contactPicker
  • Windows. fileOpenPickerwindows.fileOpenPicker
  • Windows. fileSavePickerwindows.fileSavePicker
  • Windows. printTaskSettingswindows.printTaskSettings
  • Windows. searchwindows.search
  • Windows. shareTargetwindows.shareTarget

**Nota sulle regole semantiche per le estensioni:  ** Per qualsiasi elemento di estensione, vengono applicate le regole semantiche seguenti nell'API del manifesto:**Note about semantic rules for extensions:  **For any Extension element the following semantic rules are enforced in the manifest API:

Se /Application/@StartPage specificato, si tratta di un'app di Windows che usa JavaScript e l'estensione dell'app:If /Application/@StartPage specified, it is a Windows app using JavaScript and the App Extension :

  • Può essere vuotoCan be empty
  • Può specificare solo l'oggetto StartPageCan specify just the StartPage
  • Può specificare sia Executable che EntryPoint (facoltativo RuntimeType consentito), a meno che non si tratti di un'estensione BackgroundTask, nel qual caso può omettere il file eseguibile e il valore predefinito per il BackgroundTaskHost.exe eseguibile.Can specify both Executable and EntryPoint (optional RuntimeType allowed), unless it is a BackgroundTask extension, in which case it can omit the Executable and default to the BackgroundTaskHost.exe executable.

Se /Application/@StartPage non è specificato, si tratta di un'app UWP che usa C#, VB e XAML e l'estensione dell'app:If /Application/@StartPage is not specified, it is a UWP app using C# or VB and XAML and the App Extension :

  • Può essere vuotoCan be empty
  • Può specificare solo l'oggetto StartPageCan specify just the StartPage
  • È necessario specificare EntryPoint se è specificato un file eseguibile o RuntimeType.Must specify EntryPoint if either Executable or RuntimeType is specified.

EsempiExamples

L'esempio seguente è tratto dal manifesto del pacchetto di uno degli esempi di SDK.The following example is taken from the package manifest of one of the SDK samples.

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

Vedere ancheSee also

Concetti di Contratti ed estensioni per le appConcepts App contracts and extensions

RequisitiRequirements

Spazio dei nomiNamespace http://schemas.microsoft.com/appx/2010/manifest