Delen via


besturingselement

Definieert de naamruimte, versie en weergave-informatie van het onderdeel.

Beschikbaar voor

Modelgestuurde en canvas-apps

Parameterwaarden

Naam Description Typologie Verplicht Beschikbaar voor
namespace Definieert het objectprototype van het onderdeel Alleen letters of cijfers Yes Modelgestuurde en canvas-apps
constructor Een methode voor het initialiseren van het object Alleen letters of cijfers Yes Modelgestuurde en canvas-apps
control-type Of het besturingselement een standaard besturingselement of een React-besturingselement is. De waarde van virtual geeft een React-besturingselement aan met behulp van de Platform React-bibliotheek. Virtuele besturingselementen zijn een functie in openbare preview. Meer informatie: React-besturingselementen en platformbibliotheken standard|virtual Nee. Modelgestuurde en canvas-apps
description-key Definieert de beschrijving van het onderdeel dat zichtbaar is in de gebruikersinterface. string Nee. Modelgestuurde en canvas-apps
display-name-key Hiermee definieert u de naam van het besturingselement dat zichtbaar is in de gebruikersinterface. string Yes Modelgestuurde en canvas-apps
preview-image Afbeelding die wordt gebruikt op de aanpassingsschermen om een voorbeeld van het onderdeel weer te geven. string Nee. Modelgestuurde apps
version Definieert de versie van het onderdeel dat is gedefinieerd in Semantic Versioning string Yes Modelgestuurde en canvas-apps

Bovenliggende elementen

Onderdeel Description
manifesteren Manifest is het metagegevensbestand dat een onderdeel definieert. Het is een XML bestand dat het volgende beschrijft:
  • De naamruimte van het onderdeel.
  • Het soort gegevens dat kan worden geconfigureerd, ofwel een veld of een gegevensset.
  • Eigenschappen die kunnen worden geconfigureerd in de toepassing wanneer het onderdeel wordt toegevoegd.
  • Een lijst met resourcebestanden die het onderdeel nodig heeft.
    • Een van deze moet een TypeScript-webresource zijn. Dit TypeScript moet een functie bevatten waarmee een object wordt geïnstitueert. Hiermee wordt een interface geïmplementeerd die methoden beschikbaar maakt die vereist zijn om het onderdeel te laten werken. Dit wordt de implementatiebibliotheek voor onderdelen genoemd.
  • De naam van een TypeScript-functie in de implementatiebibliotheek voor onderdelen die een object retourneert dat de vereiste onderdeelinterface toepast.
Wanneer de gebruiker een aangepast onderdeel in een canvas-app of een modelgestuurde app configureert, worden de beschikbare onderdelen door de gegevens in het manifest gefilterd, zodat alleen de geldige onderdelen voor de context beschikbaar zijn voor configuratie. De eigenschappen die in het manifest voor een onderdeel zijn gedefinieerd, worden weergegeven als configuratievelden, zodat de gebruiker die het onderdeel configureert waarden kan opgeven. Deze eigenschapswaarden zijn vervolgens tijdens runtime beschikbaar voor de onderdeelfunctie.

Kind-elementen

Onderdeel Description Voorvallen
gegevensset Het gegevenssetknooppunt in het onderdeelmanifest vertegenwoordigt een specifieke, configureerbare weergave van een set tabelrecords. 0 of meer
gebruik van externe services Geeft aan of dit besturingselement gebruikmaakt van een externe service of niet. Als dit het geval is, stelt u de vlag ingeschakeld kenmerk in op true en voegt u het externe servicedomein toe aan de <domain> eigenschap. Een besturingselement dat gebruikmaakt van een externe service is een Premium-besturingselement en de eindgebruiker heeft een Power Apps-licentie nodig om een app te openen met een Premium-besturingselement. Meer informatie: Licenties 0 of 1
eigenschap Het eigenschappenknooppunt definieert een specifiek, configureerbaar stukje gegevens dat het onderdeel verwacht van Microsoft Dataverse. 0 of meer
middelen Het resourceknooppunt in het onderdeelmanifest verwijst naar de resourcebestanden die het onderdeel nodig heeft om deze visualisatie te implementeren. 1
type-groep Het knooppunt typegroep definieert een set typen die worden geïdentificeerd door één naam. Deze informatie kan worden gebruikt om de gegevenstypen te identificeren die worden ondersteund door een specifieke eigenschap. 0 of meer
eigenschap-afhankelijkheden Hiermee definieert u een groep eigenschapsafhankelijkheden. 0 of meer
platformactie Wordt gebruikt om op te geven dat afhankelijkheden afhankelijkheden op aanvraag laden in plaats van wanneer het besturingselement wordt geladen. 0 of 1

Example

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

Naslaginformatie over het manifestschema van het Power Apps-onderdeelframework
Api-naslaginformatie over het Power Apps-onderdeelframework
Overzicht van power Apps-onderdelenframework