control-Element

  • Artikel

Definiert den Namespace, die Version und die Anzeigeinformationen der Komponente.

Verfügbar für

Modellgesteuerte und Canvas-Apps

Parameter

Name Beschreibung Art Erforderlich Verfügbar für
namespace Definiert den Objektprototyp der Komponente Nur Buchstaben und Zahlen Ja Modellgesteuerte und Canvas-Apps
constructor Eine Möglichkeit für das Initialisieren des Objekts Nur Buchstaben und Zahlen Ja Modellgesteuerte und Canvas-Apps
control-type Ob das Steuerelement ein Standard-Steuerelement oder ein React-Steuerelement ist. Der Wert von virtual zeigt ein React-Steuerelement an, das die React-Bibliothek der Plattform verwendet. Virtuelle Steuerelemente sind eine Funktion in der öffentlichen Vorschau. Weitere Informationen: React-Steuerungen und Plattformbibliotheken (Vorschau) standard|virtual Nein Modellgesteuerte und Canvas-Apps
description-key Definiert die Beschreibung der Komponente, die auf der Benutzeroberfläche angezeigt wird. string Nein Modellgesteuerte und Canvas-Apps
display-name-key Definiert den Namen des Steuerelements, das auf der Benutzeroberfläche angezeigt wird. string Ja Modellgesteuerte und Canvas-Apps
preview-image Bild, das auf Anpassungsbildschirmen verwendet wird, um eine Vorschau der Komponente anzuzeigen. string Nein Modellbasierte Apps
version Definiert die Version der Komponente, die in Semantische Versionsverwaltung definiert wurde string Ja Modellgesteuerte und Canvas-Apps

Übergeordnete Elemente

Element Beschreibung
manifest Manifest ist die Metadatendatei, in der eine Komponente definiert wird. Es handelt sich um eine XML-Datei, die Folgendes beschriebt:
  • Der Namespace der Komponente.
  • Die Art der Daten, die konfiguriert werden können, entweder ein Feld oder ein DataSet.
  • Alle Eigenschaften, die in der Anwendung konfiguriert werden können, wenn die Komponente hinzugefügt wird.
  • Eine Liste der Ressourcenfelder, die die Komponente benötigt.
    • Eine davon muss eine TypeScript-Webressource sein. Dies TypeScript muss eine Funktion enthalten, die ein Objekt instanziiert. Dies implementiert eine Schnittstelle, die Methoden zur Verfügung stellt, die obligatorisch sind, damit die Komponente funktioniert. Dies wird als Komponentenimplementierungsbibliothek bezeichnet.
  • Der Name einer TypeScript-Funktion in der Komponentenimplementierungsbibliothek, die ein Objekt zurückgibt, das die benötigte Komponentenschnittstelle anwendet.
Wenn der Benutzer eine angepasste Komponente in einer Canvas-App oder einer modellgesteuerten App konfiguriert, filtern die Daten im Manifest verfügbare Komponenten aus, damit nur gültige Komponenten für den Kontext für die Konfiguration verfügbar sind. Die im Manifest definierten Eigenschaften für eine Komponente werden als Konfigurationsfelder gerendert, sodass der Benutzer, die die Komponente konfiguriert, Werte angeben kann. Diese Eigenschaftswerte sind dann zur Laufzeit in der Komponentenfunktion verfügbar.

Untergeordnete Elemente

Element Beschreibung Ereignisse
data-set Der DataSet-Knoten im Komponentenmanifest entspricht einer bestimmten konfigurierbaren Darstellung für Tabellendatensätze. 0 oder mehr
Externe Dienstverwendung Gibt an, ob dieses Steuerelement einen externen Dienst verwendet oder nicht. Wenn dies der Fall ist, setzen Sie das Warnzeichen für das aktivierte Attribut auf „wahr“ und fügen Sie die externe Dienstdomäne zur <domain>-Eigenschaft hinzu. Ein Steuerelement, das einen beliebigen externen Dienst verwendet, ist ein Premium-Steuerelement und der Endbenutzer benötigt eine Power Apps Lizenz zum Öffnen einer App mit einem Premium-Steuerelement. Weitere Informationen: Lizenzierung 0 oder 1
property Der property-Knoten definiert ein bestimmtes konfigurierbares Datenelement, das von der Komponente vom Microsoft Dataverse erwartet wird. 0 oder mehr
resources Der resources-Knoten im manifest der Komponente verweist auf die Ressourcendateien, die von der Komponente benötigt werden, um die Visualisierung zu implementieren. 1
type-group Der type-group-Knoten definiert einen Satz von Typen, die mit einem einzelnen Namen identifiziert werden. Diese Informationen können verwendet werden, um die Datentypen zu identifizieren, die von einer bestimmten Eigenschaft unterstützt werden. 0 oder mehr
Eigenschaftsabhängigkeiten Definiert eine Gruppe von Eigenschaftsabhängigkeiten. 0 oder mehr

Beispiel

<control namespace="MyNameSpace"
   constructor="JSHelloWorldControl"
   version="1.0.0"
   display-name-key="JS_HelloWorldControl_Display_Key"
   description-key="JS_HelloWorldControl_Desc_Key"
   control-type="standard"
   preview-image="img/preview.png">
</control>

Power Apps component framework-Manifestschemareferenz
Power Apps component framework-API-Referenz
Power Apps component framework Übersicht

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).