uap:Protocol (Windows 10)

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

Elementhierarchie

<Paket>

    <Anwendungen>

         <Application>

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

</uap:Protocol>

Schlüssel

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

Attribute und Elemente

Attributes

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 in Länge, die Zahlen, Kleinbuchstaben, Punkte (), Pluszeichen () oder Striche- (.+) enthält. Die Zeichenfolge kann nicht mit einem Punkt (.) beginnen. Ja
DesiredView Der gewünschte Bildschirmbereich, der beim Starten des Termins verwendet werden soll. Eine Zeichenfolge, die einen der folgenden Werte aufweisen kann: Standard, useLess, useHalf, useMore oder useMinimum. Nein
ReturnResults Gibt an, ob die App einen Wert zurückgibt, wenn sie über eine URI-Aktivierung aufgerufen wird. Eine optionale Zeichenfolge mit einem der folgenden Werte: "none" (gibt keinen Wert zurück), "always" (URI-Aktivierung gibt immer ein Ergebnis zurück), "optional" (URI-Aktivierung gibt ein Ergebnis zurück), wenn es für Ergebnisse mithilfe von LaunchUriForResultsAndContinueAsync aktiviert wird. Nein

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.

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

Siehe auch

Aufgaben, wie die URI-Aktivierung behandelt wird

KonzepteApp-Verträge und Erweiterungen

Anforderungen

Element Wert
Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10