uap:Protocol (Windows 10)

  • Artikel

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.

Elementhierarchie

<Paket>

    <Anwendungen>

         <Anwendung>

              <Erweiterungen>

                   <uap:Extension>

                        <uap:Protocol>

Syntax

<uap:Protocol
  Name = 'A string with a value between 2 and 39 characters in length that contains numbers, lowercase letters, periods ("."), plus signs ("+"), or dashes ("-"). The string cannot start with a period (".").'
  DesiredView = 'A string that can have one of the following values: "default", "useLess", "useHalf", "useMore", or "useMinimum".'
  ReturnResults = 'An optional string that can have one of the following values: "none", "always", "optional".' >

  <!-- Child elements -->
  uap:Logo?
  & uap:DisplayName?
  & desktop7:ProgId
</uap:Protocol>

Schlüssel

? optionaler (null oder eins) & interleave Connector (kann in beliebiger Reihenfolge auftreten)

Attribute und Elemente

Attribute

attribute BESCHREIBUNG Datentyp Erforderlich Standardwert
Name Der Name des URI-Schemas (z mailto. B. ). Dieser Name muss für das Paket eindeutig sein. Eine Zeichenfolge mit einem Wert zwischen 2 und 39 Zeichen, die Zahlen, Kleinbuchstaben, Punkte (.), Pluszeichen (+) oder Bindestriche (-) enthält. Die Zeichenfolge kann nicht mit einem Punkt (.) beginnen. Yes
DesiredView Der gewünschte Bildschirmraum, der beim Starten des Termins verwendet werden soll. Eine Zeichenfolge, die einen der folgenden Werte aufweisen kann: default, useLess, useHalf, useMore oder useMinimum. No
ReturnResults Gibt an, ob die App einen Wert zurückgibt, wenn sie über eine URI-Aktivierung aufgerufen wird. Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: "none" (gibt keinen Wert zurück), "always" (URI-Aktivierung gibt immer ein Ergebnis zurück), "optional" (URI-Aktivierung gibt ein Ergebnis zurück, wenn sie für Ergebnisse mit LaunchUriForResultsAndContinueAsync aktiviert wird). No

Untergeordnete Elemente

Untergeordnetes Element Beschreibung
uap:DisplayName Ein Anzeigename, der Benutzern angezeigt werden kann.
uap:Logo Ein Pfad zu einer Datei, die ein Bild enthält.
desktop7:ProgId Ein programmgesteuerter Bezeichner (ProgID), der einer CLSID zugeordnet werden kann.

Übergeordnete Elemente

Übergeordnetes Element BESCHREIBUNG
uap:Extension Deklariert einen Erweiterbarkeitspunkt für die App.

Beispiele

Das folgende Beispiel stammt aus dem Paketmanifest eines der SDK-Beispiele.

<Applications>
  <Application
    Id="App"
    StartPage="default.html">
    <Extensions>
      <uap:Extension
        Category="windows.protocol">
        <uap:Protocol
          Name="alsdk" />
      </uap:Extension>
    </Extensions>
  </Application>
</Applications>

Weitere Informationen

AufgabenBehandeln der URI-Aktivierung

KonzepteApp-Verträge und -Erweiterungen

Anforderungen

Element Wert
Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10
Minimum OS Version Windows 10 Version 1511 (Build 10586)