Erweiterung (Typ: CT_ApplicationExtension)

  • Artikel

Deklariert einen Erweiterungspunkt für die App.

Elementhierarchie

<Durchwahl>

Syntax

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

Schlüssel

? optional (null oder eins)

Attribute und Elemente

Attributes

Attribut BESCHREIBUNG Datentyp Erforderlich Standardwert
Kategorie

Der Typ des App-Erweiterbarkeitspunkts.

Dieses Attribut kann einen der folgenden Werte aufweisen:

  • 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
 Ja
EntryPoint

Die aktivierbare Klassen-ID.

 Eine Zeichenfolge zwischen 1 und 256 Zeichen, die die Aufgabe darstellt, die die Erweiterung behandelt. Dies ist normalerweise der vollständig qualifizierte Namespacename eines Windows-Runtime-Typs. Wenn EntryPoint nicht angegeben ist, wird stattdessen der für die App definierte EntryPoint verwendet. Nein
Ausführbare Datei

Die ausführbare Standardstartdatei.

 Eine Zeichenfolge zwischen 1 und 256 Zeichen, die mit ".exe" enden muss und diese Zeichen nicht enthalten darf: <, >, :, ", |, ?oder *. Sie gibt die ausführbare Standarddatei für die Erweiterung an. Wenn keine Angabe erfolgt, wird die für die App definierte ausführbare Datei verwendet. Wenn angegeben, wird auch die EntryPoint-Eigenschaft verwendet. Wenn diese EntryPoint-Eigenschaft nicht angegeben ist, wird der für die App definierte EntryPoint verwendet. Nein
Runtimetype

Der Laufzeitanbieter. Dieses Attribut wird in der Regel verwendet, wenn in einer App gemischte Frameworks vorhanden sind.

 Eine Zeichenfolge zwischen 1 und 255 Zeichen, die nicht mit einem Punkt beginnen oder enden kann oder diese Zeichen enthält: <, >, :, ", /, \, |, ?oder *. Nein
StartPage

Die Webseite, die den Erweiterungspunkt behandelt.

 Eine Zeichenfolge zwischen 1 und 256 Zeichen, die diese Zeichen nicht enthalten kann: <, >, :, ", |, ?, oder *. Nein

 

Untergeordnete Elemente

Untergeordnetes Element BESCHREIBUNG
AutoPlayContent

Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.autoPlayContent. Die App stellt die angegebenen Inhaltsaktionen für die automatische Wiedergabe bereit.
AutoPlayDevice

Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.autoPlayDevice. Die App stellt die angegebenen Geräteaktionen für die automatische Wiedergabe bereit.
BackgroundTasks

Definiert einen App-Erweiterbarkeitspunkt vom Typ windows.backgroundTasks. Hintergrundaufgaben werden auf einem dedizierten Hintergrundhost ausgeführt. das heißt, ohne Benutzeroberfläche.
FileOpenPicker

Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.fileOpenPicker. Mit der App kann der Benutzer die angegebenen Dateitypen auswählen und öffnen.
FileSavePicker

Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.fileSavePicker. Mit der App kann der Benutzer den Dateinamen, die Erweiterung und den Speicherort für die angegebenen Dateitypen auswählen.
FileTypeAssociation

Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.fileTypeAssociation. Eine Dateitypzuordnung gibt an, dass die App registriert ist, um Dateien der angegebenen Typen zu verarbeiten.
Protokoll

Deklariert einen App-Erweiterbarkeitspunkt vom Typ windows.protocol. Eine URI-Zuordnung gibt an, dass die App registriert ist, um URIs mit dem angegebenen Schema zu verarbeiten.
ShareTarget

Deklariert einen App-Erweiterungspunkt vom Typ windows.shareTarget. Die App kann die angegebenen Dateitypen freigeben.

 

Übergeordnete Elemente

Dieses äußerste Element (Dokument) darf nicht in anderen Elementen enthalten sein.

Die folgenden Elemente haben denselben Namen wie dieses Element, aber ihr Inhalt oder ihre Attribute sind anders.

Hinweise

Diese Erweiterbarkeitspunkte können nur einmal pro App deklariert werden:

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

**Hinweis zu semantischen Regeln für Erweiterungen: **Für jedes Extension-Element werden die folgenden semantischen Regeln in der Manifest-API erzwungen:

Wenn /Application/@StartPage angegeben ist, handelt es sich um eine Windows-App, die JavaScript und die App-Erweiterung verwendet:

  • Kann leer bleiben
  • Kann nur die StartPage angeben.
  • Kann sowohl ausführbare Dateien als auch EntryPoint (optionaler RuntimeType zulässig) angeben, es sei denn, es handelt sich um eine BackgroundTask-Erweiterung. In diesem Fall kann die ausführbare Datei weggelassen werden, und standardmäßig wird die BackgroundTaskHost.exe verwendet.

Wenn /Application/@StartPage nicht angegeben ist, handelt es sich um eine UWP-App, die C# oder VB xaml und die App-Erweiterung verwendet:

  • Kann leer bleiben
  • Kann nur die StartPage angeben.
  • Muss EntryPoint angeben, wenn entweder Executable oder RuntimeType angegeben ist.

Siehe auch

KonzepteApp-Verträge und -Erweiterungen

Anforderungen

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