uap:Protocol (Windows 10)

Artikel
10/30/2023

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>

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

Freigeben über