Funktionerne EditForm, NewForm, SubmitForm, ResetForm og ViewForm i PowerAppsEditForm, NewForm, SubmitForm, ResetForm, and ViewForm functions in PowerApps

Få vist, rediger, eller opret et element, gem indholdet, og nulstil kontrolelementerne i et kontrolelement af typen Rediger formular .View, edit, or create an item, save the contents, and reset the controls in an Edit form control.

OversigtOverview

Disse funktioner ændrer tilstanden for kontrolelementet Rediger formular.These functions change the state of the Edit form control. Kontrolelementet kan være i en af følgende tilstande:The form control can be in one of these modes:

TilstandMode BeskrivelseDescription
FormMode.EditFormMode.Edit Formularen udfyldes med en eksisterende post, og brugeren kan ændre værdierne i felterne.The form is populated with an existing record and the user can modify the values of the fields. Når formularen er udfyldt, kan brugeren gemme ændringerne til posten.Once complete, the user can save the changes to the record.
FormMode.NewFormMode.New Denne formular udfyldes med en standardværdi, og brugeren kan ændre værdierne i felterne.The form is populates with default values and the user can modify the values of the fields. Når formularen er udfyldt, kan brugeren føje posten til datakilden.Once complete, the user can add the record to the data source.
FormMode.ViewFormMode.View Formularen udfyldes med en eksisterende post, men brugeren kan ikke ændre værdierne i felterne.The form is populated with an existing record but the user cannot modify the values of the fields.

BeskrivelseDescription

Disse funktioner bliver ofte kaldt fra formlen OnSelect for et kontrolelement af typen Button eller Image, så brugeren kan gemme eller annullere ændringer eller oprette en post.These functions are often invoked from the OnSelect formula of a Button or Image control so that the user can save edits, abandon edits, or create a record. Du kan bruge kontrolelementerne og funktionerne sammen for at oprette en komplet løsning.You can use controls and these functions together to create a complete solution.

Disse funktioner returnerer ingen værdier.These functions return no values.

SubmitFormSubmitForm

Brug funktionen SubmitForm i egenskaben OnSelect for et knapkontrolelement for at gemme ændringerne i et formularkontrolelement til datakilden.Use the SubmitForm function in the OnSelect property of a Button control to save any changes in a Form control to the data source.

Inden eventuelle ændringer sendes, vil funktionen validere feltinput i de obligatoriske felter.Before submitting any changes, this function checks for validation issues with any field that's marked as required or that has one or more constraints on its value. Denne funktionsmåde svarer til funktionen Validate .This behavior matches that of the Validate function.

SubmitForm kontrollerer også egenskaben Valid i formularen, som er en samling af alle egenskaberne af typen Valid for alle de kontrolelementer af typen Card, som formularen indeholder.SubmitForm also checks the Valid property of the Form, which is an aggregation of all the Valid properties of the Card controls that the Form control contains. Hvis der opstår et problem, sendes dataene ikke, og egenskaberne Error og ErrorKind for formularen tildeles de relevante værdier.If a problem occurs, the data isn't submitted, and the Error and ErrorKind properties of the Form control are set accordingly.

Hvis der ikke findes fejl under valideringen, vil SubmitForm sende ændringerne til datakilden.If validation passes, SubmitForm submits the change to the data source.

  • Hvis der ikke opstår fejl, køres funktionsmåden OnSuccess for formularen, og egenskaberne Error og ErrorKind ryddes.If successful, the Form's OnSuccess behavior runs, and the Error and ErrorKind properties are cleared. Hvis formularen var i tilstanden FormMode.New, sættes den tilbage til tilstanden FormMode.Edit.If the form was in FormMode.New mode, it is returned to FormMode.Edit mode.
  • Hvis der findes fejl, køres funktionsmåden OnFailure, og egenskaberne Error og ErrorKind tildeles de relevante værdier.If unsuccessful, the Form's OnFailure behavior runs, and the Error and ErrorKind properties are set accordingly. Formularens tilstand er uændret.The mode of the form is unchanged.

EditFormEditForm

Funktionen EditForm ændrer tilstanden for formularen til FormMode.Edit.The EditForm function changes the Form control's mode to FormMode.Edit. I denne tilstand bruges indholdet af egenskaben Item for formularen til at udfylde formularen.In this mode, the contents of the Form control's Item property are used to populate the form. Funktionen SubmitForm køres, når formularen er i denne tilstand, eller når en post ændres. Funktionen køres ikke, når formularen oprettes.If the SubmitForm function runs when the form is in this mode, a record is changed, not created. FormMode.Edit er standardtilstanden for formularkontrolelementet.FormMode.Edit is the default for the Form control.

NewFormNewForm

Funktionen NewForm ændrer formularens tilstand til FormMode.New.The NewForm function changes the Form control's mode to FormMode.New. I denne tilstand ignoreres egenskaben Item for formularen, og standardværdierne i egenskaben DataSource bruges til at udfylde formularen.In this mode, the contents of the Form control's Item property are ignored, and the default values of the Form's DataSource property populate the form. Hvis funktionen SubmitForm køres, når formularen er i denne tilstand, oprettes der en post. Funktionen køres ikke, når en post ændres.If the SubmitForm function runs when the form is in this mode, a record is created, not changed.

ResetFormResetForm

Funktionen ResetForm nulstiller indholdet af formularen til de oprindelige værdier (fra før brugeren ændrede nogen værdier).The ResetForm function resets the contents of a form to their initial values, before the user made any changes. Hvis formularen er i tilstanden FormMode.New, nulstilles formularen til tilstanden FormMode.Edit.If the form is in FormMode.New mode, the form is reset to FormMode.Edit mode. Funktionsmåden OnReset køres også for formularen.The OnReset behavior of the form control also runs. Du kan også nulstille individuelle kontrolelementer med funktionen Reset, men det kan kun gøres fra formularen.You can also reset individual controls with the Reset function but only from within the form.

ViewFormViewForm

Funktionen ViewForm ændrer formularens tilstand til FormMode.View.The ViewForm function changes the Form control's mode to FormMode.View. I denne tilstand bruges indholdet af egenskaben Item for formularen til at udfylde formularen.In this mode, the contents of the Form control's Item property are used to populate the form. Funktionerne SubmitForm og ResetForm har ingen effekt i denne tilstand.The SubmitForm and RestForm functions have no effect when in this mode.

Egenskaben DisplayModeDisplayMode Poperty

Den aktuelle tilstand kan læses via egenskaben Mode.The current mode can be read through the Mode property. Tilstanden bestemmer også værdien af egenskaben DisplayMode, som kan bruges af datakort og kontrolelementer på formularen.The mode also determines the value of the DisplayMode property which can be used by data cards and controls within the form control. Ofte vil egenskaben DisplayMode for datakortet være indstillet til Parent.DisplayMode (med en reference til formularen), og det samme gælder egenskaben DisplayMode (med en reference til datakortet):Often, the data card's DisplayMode property will be set to Parent.DisplayMode (refernceing the form) as will the control's DisplayMode property (referncing the data card):

TilstandMode DisplayModeDisplayMode BeskrivelseDescription
FormMode.EditFormMode.Edit DisplayMode.EditDisplayMode.Edit Datakort og kontrolelementer kan redigeres, klar til at acceptere ændringer af en post.Data cards and controls are editable, ready to accept changes to a record.
FormMode.NewFormMode.New DisplayMode.EditDisplayMode.Edit Datakort og kontrolelementer kan redigeres, klar til at acceptere en ny post.Data cards and controls are editable, ready to accept a new record.
FormMode.ViewFormMode.View DisplayMode.ViewDisplayMode.View Datakort og kontrolelementer kan ikke redigeres og er ikke optimeret til visning.Data cards and controls are not editable and optimized for viewing.

SyntaksSyntax

SubmitForm(formularnavn)SubmitForm( FormName )

  • Formularnavn – påkrævet.FormName - Required. Formularkontrolelementet kan sende til datakilden.Form control to submit to the data source.

EditForm(formularnavn)EditForm( FormName )

  • Formularnavn – påkrævet.FormName - Required. Formularkontrolelementet skifter til tilstanden FormMode.Edit.Form control to switch to FormMode.Edit mode.

NewForm(formularnavn)NewForm( FormName )

  • Formularnavn – påkrævet.FormName - Required. Formularkontrolelementet skifter til tilstanden FormMode.New.Form control to switch to FormMode.New mode.

ResetForm(formularnavn)ResetForm( FormName )

  • Formularnavn – påkrævet.FormName - Required. Formularkontrolelementet nulstilles til de oprindelige værdier.Form control to reset to initial values. Ændrer også formularens tilstand fra FormMode.New til FormMode.Edit.Also switches the form from FormMode.New mode to FormMode.Edit mode.

ViewForm(formularnavn)ViewForm( FormName )

  • Formularnavn – påkrævet.FormName - Required. Formularkontrolelementet ændres til tilstanden FormMode.View.Form control to switch to FormMode.View mode.

EksemplerExamples

Se Forstå dataformularer for komplette eksempler.See Understand data forms for complete examples.

  1. Tilføj et knapkontrolelement, angiv egenskaben Text for knappen til Save, og angiv egenskaben OnSelect til denne formel:Add a Button control, set its Text property to show Save, and set its OnSelect property to this formula:

    SubmitForm( EditForm )SubmitForm( EditForm )

  2. Angiv egenskaben OnFailure for et formularkontrolelement til en tom værdi og egenskaben OnSuccess til denne formel:Set the OnFailure property of a Form control to blank and its OnSuccess property to this formula:

    Back()Back()

  3. Navngiv et kontrolelement af typen Label til ErrorText, og angiv egenskaben Text til denne formel:Name a Label control ErrorText, and set its Text property to this formula:

    EditForm.ErrorEditForm.Error

    Når brugeren vælger knappen Gem, vil ændringer i formularkontrolelementet blive sendt til den underliggende datakilde.When the user selects the Save button, any changes in the Form control are submitted to the underlying data source.

    • Hvis det ikke kan sendes, bliver eventuelle ændringer gemt, eller hvis formularkontrolelementet er i tilstanden New, oprettes der en post.If the submission succeeds, any changes are saved or, if the Form control is in New mode, a record is created. ErrorText er tom, og det foregående skærmbillede vises igen.ErrorText is blank and the previous screen reappears.
    • Hvis der ikke kan sendes, vises der en fejlmeddelelse i ErrorText, og det aktuelle skærmbillede forbliver synligt, så brugeren kan rette problemet og prøve igen.If the submission fails, ErrorText shows a user-friendly error message, and the current screen remains visible so that the user can correct the problem and try again.
  4. Tilføj et knapkontrolelement, og angiv egenskaben Text til Cancel og egenskaben OnSelect til denne formel:Add a Button control, set its Text property to show Cancel, and set its OnSelect property to this formula:

    ResetForm( EditForm ); Back()ResetForm( EditForm ); Back()

    Når brugeren vælger knappen Cancel, bliver værdierne i formularkontrolelementet nulstillet til værdierne fra før brugeren begyndte at redigere formularen, det foregående skærmbillede vises igen, og formularkontrolelementet ændres til tilstanden Edit, hvis den var i tilstanden New.When the user selects the Cancel button, the values in the Form control are reset to what they were before the user started to edit it, the previous screen reappears, and the Form control is returned to Edit mode if it was in New mode.

  5. Tilføj et knapkontrolelement, angiv egenskaben Text til New, og angiv egenskaben OnSelect til denne formular:Add a Button control, set its Text property to show New, and set its OnSelect property to this formula:

    NewForm( EditForm ); Navigate( EditScreen, None )NewForm( EditForm ); Navigate( EditScreen, None )

    Når brugeren vælger knappen New, eller hvis formularkontrolelementets tilstand ændres til New, vil kontrolelementet blive udfyldt med standardværdierne fra den datakilde, der er angivet for formularen, og det skærmbillede, som indeholder formularkontrolementet, vises.When the user selects the New button, the Form control switches to New mode, the default values for the Form control's data source populate that control, and the screen that contains the Form control appears. Når funktionen SubmitForm køres, oprettes der en post i stedet for at opdatere den.When the SubmitForm function runs, a record is created instead of updated.