Funzioni Remove e RemoveIf in Power AppsRemove and RemoveIf functions in Power Apps

Rimuove i record da un'origine dati.Removes records from a data source.

DescrizioneDescription

Funzione RemoveRemove function

Usare la funzione Remove per rimuovere uno o più record specifici da un'origine dati.Use the Remove function to remove a specific record or records from a data source.

Per le raccolte deve corrispondere l'intero record.For collections, the entire record must match. È possibile usare l'argomento All per rimuovere tutte le copie di un record; in caso contrario verrà rimossa solo una copia del record.You can use the All argument to remove all copies of a record; otherwise, only one copy of the record is removed.

Funzione RemoveIfRemoveIf function

Usare la funzione RemoveIf per rimuovere uno o più record in base a una condizione o un set di condizioni.Use the RemoveIf function to remove a record or records based on a condition or a set of conditions. Ogni condizione può essere qualsiasi formula che restituisce un valore true o false e può fare riferimento a colonne dell'origine dati in base al nome.Each condition can be any formula that results in a true or false and can reference columns of the data source by name. Ogni condizione viene valutata singolarmente per ogni record e il record viene rimosso se tutte le condizioni restituiscono true.Each condition is evaluated individually for each record, and the record is removed if all conditions evaluate to true.

Remove e RemoveIf restituiscono l'origine dati modificata come tabella.Remove and RemoveIf return the modified data source as a table. È possibile usare entrambe le funzioni solo in una formula di comportamento.You can use both functions only in behavior formulas.

È anche possibile usare la funzione Clear per rimuovere tutti i record presenti in un'origine dati.You can also use the Clear function to remove all of the records in a data source.

DelegaDelegation

Quando viene utilizzata con un'origine dati, queste funzioni non possono essere delegate.When used with a data source, these functions can't be delegated. Solo la prima parte dell'origine dati verrà recuperata e la funzione applicata.Only the first portion of the data source will be retrieved and then the function applied. Il risultato potrebbe non rappresentare la storia completa.The result may not represent the complete story. Un avviso potrebbe apparire al momento della creazione per ricordarti questo limite e per suggerire di passare ad alternative delegabili quando possibile.A warning may appear at authoring time to remind you of this limitation and to suggest switching to delegable alternatives where possible. Per ulteriori informazioni, consultare panoramica delega.For more information, see the delegation overview.

SintassiSyntax

Remove( DataSource; Record1 [; Record2; ... ] [; All ] )Remove( DataSource; Record1 [; Record2; ... ] [; All ] )

  • DataSource: obbligatorio.DataSource – Required. L'origine dati che contiene i record da rimuovere.The data source that contains the record or records that you want to remove.
  • Record: obbligatorio.Record(s) – Required. I record da rimuovere.The record or records to remove.
  • All: facoltativo.All – Optional. In una raccolta, lo stesso record può essere presente più volte.In a collection, the same record may appear more than once. È possibile aggiungere l'argomento All per rimuovere tutte le copie del record.You can add the All argument to remove all copies of the record.

Remove( DataSource; Table [; All ] )Remove( DataSource; Table [; All ] )

  • DataSource: obbligatorio.DataSource – Required. L'origine dati che contiene i record da rimuovere.The data source that contains the records that you want to remove.
  • Table: obbligatorio.Table – Required. Tabella di record da rimuovere.A table of records to remove.
  • All: facoltativo.All – Optional. In una raccolta, lo stesso record può essere presente più volte.In a collection, the same record may appear more than once. È possibile aggiungere l'argomento All per rimuovere tutte le copie del record.You can add the All argument to remove all copies of the record.

RemoveIf( DataSource; Condition [; ... ] )RemoveIf( DataSource; Condition [; ... ] )

  • DataSource: obbligatorio.DataSource – Required. L'origine dati che contiene i record da rimuovere.The data source that contains the record or records that you want to remove.
  • Condition: obbligatorio.Condition(s) – Required. Formula che restituisce true per i record da rimuovere.A formula that evaluates to true for the record or records to remove. È possibile usare i nomi di colonna di DataSource nella formula.You can use column names from the DataSource in the formula. Se si specificano più condizioni, devono tutte restituire true per i record da rimuovere.If you specify multiple Conditions, all must evaluate to true for the record or records to be removed.

Esempi-formule singoleExamples - single formulas

In questi esempi verranno rimossi record in un'origine dati denominata IceCream che inizia con i dati della tabella seguente:In these examples, you'll remove a record or records in a data source that's named IceCream and that starts with the data in this table:

Creare una raccolta con record di esempioCreate a collection with sample records

Per creare una raccolta con questi dati:To create a collection with this data:

  1. Inserire un controllo Button .Insert a Button control.

  2. Impostare la proprietà onselect del controllo Button sulla formula seguente:Set button control's OnSelect property to the below formula:

    ClearCollect( IceCream;
                  { ID: 1; Flavor: "Chocolate";  Quantity: 100 };
                  { ID: 2; Flavor: "Vanilla";    Quantity: 200 };
                  { ID: 3; Flavor: "Strawberry"; Quantity: 300 }
    )
    
  3. Selezionare il pulsante tenendo premuto il tasto Alt:Select the button while holding down the Alt key:

Rimuovere i record di esempio dalla raccolta usando una formulaRemove sample records from collection using a formula

FormulaFormula DescrizioneDescription RisultatoResult
Remove( IceCream;
First( Filter( IceCream; Flavor="Chocolate" ) ) )
Remove( IceCream;
First( Filter( IceCream; Flavor="Chocolate" ) ) )
Rimuove il record Chocolate dall'origine dati.Removes the Chocolate record from the data source.

L'origine dati IceCream è stata modificata.The IceCream data source has been modified.
Remove( IceCream;
First( Filter( IceCream; Flavor="Chocolate" ) ) First( Filter( IceCream; Flavor="Strawberry" ) ) )
Remove( IceCream;
First( Filter( IceCream; Flavor="Chocolate" ) ) First( Filter( IceCream; Flavor="Strawberry" ) ) )
Rimuove due record dall'origine dati.Removes two records from the data source.

L'origine dati IceCream è stata modificata.The IceCream data source has been modified.
RemoveIf( IceCream; Quantity > 150 )RemoveIf( IceCream; Quantity > 150 ) Rimuove i record che hanno un valore Quantity maggiore di 150.Removes records that have a Quantity that's greater than 150.

L'origine dati IceCream è stata modificata.The IceCream data source has been modified.
RemoveIf( IceCream; Quantity > 150; Left( Flavor; 1 ) = "S" )RemoveIf( IceCream; Quantity > 150; Left( Flavor; 1 ) = "S" ) Rimuove i record che hanno un valore Quantity maggiore di 150 e un valore Flavor che inizia con S.Removes records that have a Quantity that's greater than 150 and Flavor starts with an S.


L'origine dati IceCream è stata modificata.The IceCream data source has been modified.
RemoveIf( IceCream; true )RemoveIf( IceCream; true ) Rimuove tutti i record dall'origine dati.Removes all records from the data source.

L'origine dati IceCream è stata modificata.The IceCream data source has been modified.

In questo esempio si utilizzerà un controllo raccolta per elencare i record in una tabella.In this example, you'll use a Gallery control to list the records in a table. Quindi, usare la funzione Remove per rimuovere selettivamente un elemento.And then use the Remove function to selectively remove an item.

Preparare i dati di esempioPrepare for sample data

Questo esempio usa l'entità Contacts in Common Data Service disponibile con le app e i dati di esempio.This example uses the Contacts entity in Common Data Service available with the sample apps and data. È possibile distribuire le app e i dati di esempio quando si Crea un ambiente.You can deploy sample apps and data when you create an environment. È anche possibile usare qualsiasi altra origine dati.You can also use any other data source instead.

In questo esempio verrà rimosso un elemento usando un pulsante esterno alla raccolta.In this example, you'll remove an item by using a button that is outside the gallery.

  1. Creare una nuova app Canvas vuota usando un layout telefonico.Create a new blank canvas app using a Phone layout.

    App Canvas vuota che usa il layout del telefono

  2. Selezionare l' inserimento dal riquadro sinistro.Select the Insert from the left pane.

  3. Selezionare raccolta verticale.Select Vertical gallery.
    Viene aggiunto un controllo raccolta allo schermo.A Gallery control is be added to your screen.

    Uso del riquadro degli strumenti Inserisci per aggiungere un controllo raccolta verticale

  4. Viene richiesto di selezionare un'origine dati in cui è possibile selezionare un'origine dati dalle origini dati disponibili.You're prompted to select a data source where you can select a data source from the available data sources.
    Ad esempio, selezionare l'entità Contacts per usare i dati di esempio:For example, select the Contacts entity to use sample data:

    Selezione dell'entità Contacts da visualizzare nella raccolta

    La raccolta Mostra gli elementi di questa entità:The gallery shows items from this entity:

    Raccolta aggiunta che mostra l'entità Contacts

  5. Inserire un controllo Button dal riquadro sinistro:Insert a Button control from left pane:

    Uso del riquadro degli strumenti Inserisci per aggiungere un controllo Button

  6. Spostare il pulsante aggiunto sotto gli elementi della raccolta:Move the added button below the gallery items:

    Pulsante Sposta

  7. Aggiornare la proprietà testo del pulsante per rimuovere il record.Update button text property to Remove record. È anche possibile usare un testo di propria scelta:You can also use text of your choice:

    Pulsante Rinomina

  8. Impostare la proprietà onselect per questo controllo Button sulla formula seguente:Set the OnSelect property for this button control to the following formula:

    Remove( Contacts; Gallery1.Selected )
    

    Impostazione della proprietà OnSelect del controllo Button

    Il controllo raccolta rende disponibile il record attualmente selezionato utilizzando la proprietà selezionata .The gallery control makes the currently selected record available using Selected property. Remove Function fa riferimento a questo record selezionato per rimuoverlo.Remove function refers to this selected record to remove it.

  9. Visualizzare in anteprima l'app usando il pulsante Riproduci in alto a destra oppure premere F5 sulla tastiera:Preview the app using the Play button on the top right, or press F5 on keyboard:

    Anteprima app

  10. Selezionare un record da rimuovere, ad esempio il record di Nancyin questo esempio:Select a record to remove, such as Nancy's record in this example:

    Selezionare un record

  11. Selezionare Rimuovi record:Select Remove record:

    Raccolta di contatti, ora senza il record Nancy che è stato rimosso

    Selezionando il pulsante verrà rimosso il record selezionato (in questo esempio, il record di Nancy).Selecting the button removes the selected record (in this example, Nancy's record).

  12. Chiudere l'anteprima dell'app.Close the app preview.

    Suggerimento

    È anche possibile usare il comportamento alternativo con il tasto Alt invece di usare l'anteprima dell'app con il pulsante Play o F5.You can also use alternate behavior with Alt key instead of using the app preview with Play button or F5.

In questo esempio verrà rimosso un elemento usando un' icona posizionata all'interno della raccolta.In this example, you'll remove an item by using an icon placed inside the gallery.

Creare una raccolta con dati di esempioCreate a collection with sample data

Se sono già stati preparati dati di esempio, ignorare questo passaggio e passare a Cestino icona all'interno di una raccolta.If you already have prepared sample data, skip this step and move to Trash can icon inside a gallery.

  1. Aggiungere un controllo Button allo schermo.Add a Button control to your screen.

  2. Impostare la proprietà OnSelect sulla formula seguente:Set the OnSelect property to the following formula:

    ClearCollect( SampleContacts; 
          { 'Full Name': "Yvonne McKay (sample)";      'Primary Email': "someone_a@example.com" };
          { 'Full Name': "Susanna Stubberod (sample)"; 'Primary Email': "someone_b@example.com" };
          { 'Full Name': "Nancy Anderson (sample)";    'Primary Email': "someone_c@example.com" };
          { 'Full Name': "Maria Campbell (sample)";    'Primary Email': "someone_d@example.com" };
          { 'Full Name': "Robert Lyon (sample)";       'Primary Email': "someone_e@example.com" };
          { 'Full Name': "Paul Cannon (sample)";       'Primary Email': "someone_f@example.com" };
          { 'Full Name': "Rene Valdes (sample)";       'Primary Email': "someone_g@example.com" } 
    )
    
  3. Selezionare il pulsante tenendo premuto il tasto Alt.Select the button while holding down the Alt key.

Viene creata una raccolta di esempi che è possibile usare nell'esempio seguente.Sample collection is created that you can use in the following example.

  1. Creare una nuova app Canvas vuota usando un layout telefonico.Create a new blank canvas app using a Phone layout.

    App Canvas vuota che usa il layout del telefono

  2. Selezionare l' inserimento dal riquadro sinistro.Select the Insert from the left pane.

  3. Selezionare raccolta verticale.Select Vertical gallery.
    Viene aggiunto un controllo raccolta allo schermo.A Gallery control is be added to your screen.

    Uso del riquadro degli strumenti Inserisci per aggiungere un controllo raccolta verticale

  4. Viene richiesto di selezionare un'origine dati in cui è possibile selezionare un'origine dati dalle origini dati disponibili.You're prompted to select a data source where you can select a data source from the available data sources.
    Ad esempio, selezionare l'entità Contacts per usare i dati di esempio:For example, select the Contacts entity to use sample data:

    Selezione dell'entità Contacts da visualizzare nella raccolta

    Se è stata creata una raccolta, selezionare invece la raccolta:If you created a collection, select your collection instead:

    Raccolta di contatti di esempio

  5. Selezionare un controllo all'interno dell'elemento superiore della raccolta.Select a control within the top item in the gallery.

    Per assicurarsi che il passaggio successivo inserisca l'elemento nel modello della raccolta e non all'esterno della raccolta, assicurarsi di seguire questo passaggio prima di passare al passaggio successivo.To ensure next step inserts item into gallery's template and not outside the gallery, ensure you follow this step before moving to the next step.

    Selezionare il record top in una raccolta

  6. Selezionare Aggiungi icona dal riquadro sinistro.Select Add icon from left pane.

    Uso del riquadro degli strumenti Inserisci per aggiungere un controllo Icon

    Nota

    Aggiungi icona inserisce un'icona + sul lato sinistro della raccolta, replicata per ogni elemento nella raccolta.Add icon inserts a + icon on the left side of the gallery, replicated for each item in the gallery.

  7. Nell'elemento superiore spostare l'icona sul lato destro dello schermo.In the top item, move the icon to the right side of the screen.

    Icona Sposta

  8. Selezionare la proprietà icona per icona e impostarla sulla formula seguente per aggiornare l'immagine icona come icona Cestino:Select the Icon property for icon and set it to the following formula to update the icon image as trash icon:

    Icon.Trash
    

    Nota

    Icona.The Icon. il prefisso viene visualizzato solo quando si sta modificando attivamente la formula.prefix is only shown when you're actively editing the formula.

    Modifica dell'icona sull'icona del cestino

  9. Impostare la proprietà OnSelect sulla formula seguente:Set the OnSelect property to the following formula:

    Remove( [@Contacts]; ThisItem )
    

    Nota

    È necessario utilizzare l'operatore di risoluzione dell' ambiguità globale [@ ... ] in questo esempio con dati di esempio che usano l'entità Contacts per evitare conflitti con una relazione uno-a-molti .You must use global disambiguation operator [@...] in this example with sample data that uses the Contacts entity to avoid conflict with a One-to-Many relationship. Se si utilizzano origini dati quali un elenco di SharePoint o una tabella SQL Server, non è necessario utilizzare l' operatore disambgulation globale .If you use data sources such as a SharePoint list or a SQL Server table, using global disambgulation operator is not required.

    Onselect per icona Cestino

  10. Visualizzare in anteprima l'app usando il pulsante Riproduci in alto a destra oppure premere F5 sulla tastiera.Preview the app using the Play button on the top right, or press F5 on keyboard.

  11. Selezionare l'icona del cestino accanto a un record, ad esempio Maria:Select the trash icon next to a record, for example Maria's:

    Raccolta con uno dei contatti rimossi

    Il record viene eliminato:The record is deleted:

    Record eliminato

  12. Chiudere l'anteprima dell'app.Close the app preview.