Funzioni Blank, Coalesce, IsBlank e IsEmpty in PowerAppsBlank, Coalesce, IsBlank, and IsEmpty functions in PowerApps

Verificano se un valore è blank oppure se una tabella non contiene alcun record e consentono di creare valori blank.Tests whether a value is blank or a table contains no records, and provides a way to create blank values.

PanoramicaOverview

Blank è un segnaposto per "nessun valore" o "valore sconosciuto".Blank is a placeholder for "no value" or "unknown value." Un controllo Input di testo è blank se l'utente non ha digitato alcun carattere.A Text input control is blank if the user hasn't typed any characters in it. Lo stesso controllo non è più blank appena l'utente digita un carattere.The same control is no longer blank as soon as the user types a character in it. Alcune origini dati possono archiviare e restituire valori NULL, che sono rappresentati in PowerApps come blank.Some data sources can store and return NULL values, which are represented in PowerApps as blank.

Nota: in questa fase, l'archiviazione di valori blank è supportata solo per le raccolte locali.Note: At this time, storing blank values is supported only for local collections. È noto che molte origini dati supportano valori blank (NULL) e i team sono al lavoro per rimuovere questo limite.We know that many data sources support blank (NULL) values, and we're working to lift this limitation.

Ogni proprietà o valore calcolato può essere blank.Any property or calculated value can be blank. Ad esempio, un valore booleano in genere ha uno dei due valori true o false.For example, a Boolean value normally has one of two values: true or false. Ma oltre a questi due valori, può essere anche blank.But in addition to these two, it can also be blank. Ciò è simile a Microsoft Excel, dove una cella di un foglio di lavoro parte da uno stato blank, ma può contenere i valori TRUE o FALSE, tra gli altri.This is similar to Microsoft Excel, where a worksheet cell starts out as blank but can hold the values TRUE or FALSE, among others. In qualsiasi momento, è possibile rimuovere il contenuto della cella, la quale ritornerà a uno stato blank.At any time, the contents of the cell can be removed, and it would return to a blank state.

Blank è specifico per le tabelle che non contengono alcun record.Empty is specific to tables that contain no records. La struttura della tabella potrebbe essere intatta, completa di nomi di colonna, ma non contenere alcun dato.The table structure may be intact, complete with column names, but no data is in the table. Una tabella può iniziare vuota, accettare record e non essere più vuota, ma se i record vengono rimossi, la tabella sarà di nuovo vuota.A table may start as empty, take on records and no longer be empty, and then have the records removed and again be empty.

DescrizioneDescription

La funzione Blank restituisce un valore blank.The Blank function returns a blank value. Usarla per archiviare un valore NULL in un'origine dati che supporta questi valori, rimuovendo effettivamente qualsiasi valore dal campo.Use this to store a NULL value in a data source that supports these values, effectively removing any value from the field.

La funzione IsBlank verifica la presenza di un valore blank.The IsBlank function tests for a blank value. I valori blank si possono verificare nelle situazioni seguenti:Blank values are found in situations such as these:

  • Il valore restituito dalla funzione blank.The return value from the Blank function.
  • Una proprietà di controllo non include alcuna formula impostata.A control property has no formula set for it.
  • Nessun valore è stato digitato in un controllo di input di testo oppure nessuna selezione è stata eseguita in una casella di riepilogo.No value is typed into a text-input control, or no selection is made in a listbox. È possibile usare la funzione IsBlank per visualizzare un commento su un campo obbligatorio.You can use IsBlank to provide feedback that a field is required.
  • Una stringa che non contiene caratteri ha Len pari a 0.A string that contains no characters has a Len of 0.
  • Si è verificato un errore in una funzione.An error occurred in a function. Spesso, uno degli argomenti della funzione non era valido.Often, one of the arguments to the function wasn't valid. Molte funzioni restituiscono blank se il valore di un argomento è blank.Many functions return blank if the value of an argument is blank.
  • Le origini dati connesse, ad esempio SQL Server, potrebbero usare valori "Null".Connected data sources, such as SQL Server, may use "null" values. Questi valori vengono visualizzati come blank in PowerApps.These values appear as blank in PowerApps.
  • La parte else di una funzione If non è stata specificata e tutte le condizioni erano false.The else portion of an If function wasn't specified, and all conditions were false.
  • È stata usata la funzione Update senza specificare un valore per tutte le colonne.You used the Update function but didn't specify a value for all columns. Di conseguenza, nessun valore è stato inserito nelle colonne non specificate.As a result, no values were placed in the columns that you didn't specify.

La funzione Coalesce valuta i rispettivi argomenti nell'ordine specificato e restituisce il primo valore non blank.The Coalesce function evaluates its arguments in order and returns the first value that isn't blank. Usare questa funzione per sostituire un valore blank con un valore diverso, senza modificare i valori non blank.Use this function to replace a blank value with a different value but leave non-blank values unchanged. Se tutti gli argomenti sono blank, la funzione restituisce blank.If all of the arguments are blank, then the function returns blank. Tutti gli argomenti per Coalesce devono essere dello stesso tipo. Non è ad esempio possibile combinare numeri con stringhe di testo.All arguments to Coalesce must be of the same type; for example, you can't mix numbers with text strings. Coalesce(value1, value2) è l'equivalente più conciso di If(IsBlank(value1) value1, value2) e non richiede che value1 venga valutato due volte.Coalesce( value1, value2 ) is the more concise equivalent of If( IsBlank( value1 ) value1, value2 ) and doesn't require value1 to be evaluated twice.

La funzione IsEmpty verifica se una tabella contiene record.The IsEmpty function tests whether a table contains any records. È equivalente all'uso della funzione CountRows e del controllo dei valori zero.It's equivalent to using the CountRows function and checking for zero. È possibile trovare eventuali errori dell'origine dati combinando IsEmpty con la funzione Errors.You can check for data-source errors by combining IsEmpty with the Errors function.

Il valore restituito per entrambe le funzioni IsBlank e IsEmpty è un valore booleano true o false.The return value for both IsBlank and IsEmpty is a Boolean true or false.

SintassiSyntax

Blank()Blank()

Coalesce(Value1 [, Value2, ... ])Coalesce( Value1 [, Value2, ... ] )

  • Value(s): obbligatorio.Value(s) – Required. Valori da testare.Values to test. Ogni valore viene valutato nell'ordine specificato, fino a quando non viene trovato un valore non blank.Each value is evaluated in order until a non-blank value is found. I valori successivi al primo valore non blank non vengono valutati.Values after the first non-blank value aren't evaluated.

IsBlank( Valore )IsBlank( Value )

  • Valore: obbligatorio.Value – Required. Valore da verificare.Value to test.

IsEmpty( Tabella )IsEmpty( Table )

  • Table - Obbligatorio.Table - Required. Tabella in cui verificare i record.Table to test for records.

EsempiExamples

BlankBlank

Nota: al momento, l'esempio seguente funziona solo per le raccolte locali.NOTE: At this time, the following example only works for local collections. È noto che molte origini dati supportano valori blank (NULL) e i team sono al lavoro per rimuovere questo limite.We know that many data sources support blank (NULL) values and We are working to lift this limitation.

  1. Creare un'applicazione da zero e aggiungere un controllo Pulsante.Create an app from scratch, and add a Button control.
  2. Impostare la proprietà OnSelect del pulsante su questa formula:Set the button's OnSelect property to this formula:

    ClearCollect( Cities, { Name: "Seattle", Weather: "Rainy" } )ClearCollect( Cities, { Name: "Seattle", Weather: "Rainy" } )

  3. Visualizzare un'anteprima dell'app, scegliere o toccare il pulsante che è stato aggiunto e quindi chiudere l'anteprima.Preview your app, click or tap the button that you added, and then close Preview.
  4. Nel menu File scegliere o toccare Raccolte.On the File menu, click or tap Collections.

    Viene visualizzata la raccolta Cities, che mostra un solo record con "Seattle" e "Rainy" (Piovoso):The Cities collection appears, showing one record with "Seattle" and "Rainy":

    Raccolta che mostra Seattle con tempo piovoso

  5. Scegliere o toccare la freccia Indietro per tornare all'area di lavoro predefinita.Click or tap the back arrow to return to the default workspace.
  6. Aggiungere un controllo Etichetta e impostarne la proprietà Text sulla formula seguente:Add a Label control, and set its Text property to this formula:

    IsBlank( First( Cities ).Weather )IsBlank( First( Cities ).Weather )

    L'etichetta mostra false perché il campo Weather contiene un valore ("Rainy").The label shows false because the Weather field contains a value ("Rainy").

  7. Aggiungere un secondo pulsante e impostarne la proprietà OnSelect su questa formula:Add a second button, and set its OnSelect property to this formula:

    Patch( Cities, First( Cities ), { Weather: Blank() } )Patch( Cities, First( Cities ), { Weather: Blank() } )

  8. Visualizzare un'anteprima dell'app, scegliere o toccare il pulsante che è stato aggiunto e quindi chiudere l'anteprima.Preview your app, click or tap the button that you added, and then close Preview.

    Il campo Weather del primo record in Cities viene sostituito con un valore vuoto, rimuovendo il precedente valore "Rainy".The Weather field of the first record in Cities is replaced with a blank, removing the "Rainy" that was there previously.

    Raccolta che mostra Seattle con campo Weather vuoto

    L'etichetta mostra true perché il campo Weather non contiene più un valore.The label shows true because the Weather field no longer contains a value.

CoalesceCoalesce

FormulaFormula DescrizioneDescription RisultatoResult
Coalesce(Blank(), 1)Coalesce( Blank(), 1 ) Verifica il valore restituito dalla funzione Blank, che restituisce sempre un valore vuoto.Tests the return value from the Blank function, which always returns a blank value. Poiché il primo argomento è blank, la valutazione continua con l'argomento successivo, fino a quando non viene trovato un valore non blank.Because the first argument is blank, evaluation continues with the next argument until a non-blank value is found. 11
Coalesce( Blank(), Blank(), Blank(), Blank(), 2, 3)Coalesce( Blank(), Blank(), Blank(), Blank(), 2, 3 ) Coalesce parte dall'inizio dell'elenco di argomenti e valuta ogni argomento successivamente fino a quando non viene trovato un valore non blank.Coalesce starts at the beginning of the argument list and evaluates each argument in turn until a non-blank value is found. In questo caso i primi quattro argomenti restituiscono tutti blank, quindi la valutazione continua fino al quinto argomento.In this case, the first four arguments all return blank, so evaluation continues to the fifth argument. Il quinto argomento è di tipo non blank, quindi la valutazione si interrompe.The fifth argument is non-blank, so evaluation stops here. Viene restituito il valore del quinto argomento e il sesto argomento non viene valutato.The value of the fifth argument is returned, and the sixth argument isn't evaluated. 22

IsBlankIsBlank

  1. Creare un'app da zero, aggiungere un controllo di input di testo e denominarlo FirstName.Create an app from scratch, add a text-input control, and name it FirstName.
  2. Aggiungere un'etichetta e impostarne la proprietà Text sulla formula seguente:Add a label, and set its Text property to this formula:

    If( IsBlank( FirstName.Text ), "Il nome è un campo obbligatorio." )If( IsBlank( FirstName.Text ), "First Name is a required field." )

    Per impostazione predefinita, la proprietà Text di un controllo di input di testo è impostata su "Text input".By default, the Text property of a text-input control is set to "Text input". Dato che la proprietà contiene un valore, non è blank e l'etichetta non visualizza alcun messaggio.Because the property contains a value, it isn't blank, and the label doesn't display any message.

  3. Rimuovere tutti i caratteri dal controllo di input di testo, inclusi gli spazi.Remove all the characters from the text-input control, including any spaces.

    Dato che non contiene più caratteri, la proprietà Text è blank e IsBlank( FirstName.Text ) è true.Because the Text property no longer contains any characters, it's blank, and IsBlank( FirstName.Text ) will be true. In questo caso, verrà visualizzato il messaggio del campo obbligatorio.The required field message is displayed.

Per informazioni su come eseguire la convalida usando altri strumenti, vedere la funzione Validate e come usare le origini dati.For information about how to perform validation by using other tools, see the Validate function and working with data sources.

Altri esempi:Other examples:

FormulaFormula DescrizioneDescription RisultatoResult
IsBlank( Blank() )IsBlank( Blank() ) Verifica il valore restituito dalla funzione Blank, che restituisce sempre un valore vuoto.Tests the return value from the Blank function, which always returns a blank value. truetrue
IsBlank( "" )IsBlank( "" ) Una stringa che non contiene caratteri.A string that contains no characters. truetrue
IsBlank( "Hello" )IsBlank( "Hello" ) Una stringa che contiene uno o più caratteri.A string that contains one or more characters. falsefalse
IsBlank( QualsiasiRaccolta )IsBlank( AnyCollection ) Poiché la raccolta esiste, non è blank, anche se non contiene alcun record.Because the collection exists, it isn't blank, even if it doesn't contain any records. Per controllare se una raccolta è vuota, usare invece IsEmpty.To check for an empty collection, use IsEmpty instead. falsefalse
IsBlank( Mid( "Hello", 17, 2 ) )IsBlank( Mid( "Hello", 17, 2 ) ) Il carattere iniziale per Mid si trova oltre la fine della stringa.The starting character for Mid is beyond the end of the string. Il risultato è una stringa vuota.The result is an empty string. truetrue
IsBlank( If( false, false ) )IsBlank( If( false, false ) ) Una funzione If senza AltroRisultato.An If function with no ElseResult. Poiché la condizione è sempre false, la funzione If restituisce sempre blank.Because the condition is always false, this If always returns blank. truetrue

IsEmptyIsEmpty

  1. Creare un'applicazione da zero e aggiungere un controllo Pulsante.Create an app from scratch, and add a Button control.
  2. Impostare la proprietà OnSelect del pulsante su questa formula:Set the button's OnSelect property to this formula:

    Collect( IceCream, { Flavor: "Strawberry", Quantity: 300 }, { Flavor: "Chocolate", Quantity: 100 } )Collect( IceCream, { Flavor: "Strawberry", Quantity: 300 }, { Flavor: "Chocolate", Quantity: 100 } )

  3. Visualizzare un'anteprima dell'app, scegliere o toccare il pulsante che è stato aggiunto e quindi chiudere l'anteprima.Preview your app, click or tap the button that you added, and then close Preview.

    Viene creata una raccolta denominata IceCream contenente i seguenti dati:A collection named IceCream is created and contains this data:

    Questa raccolta ha due record e non è vuota.This collection has two records and isn't empty. IsEmpty( IceCream ) restituisce false e CountRows( IceCream ) restituisce 2.IsEmpty( IceCream ) returns false, and CountRows( IceCream ) returns 2.

  4. Aggiungere un secondo pulsante e impostarne la proprietà OnSelect su questa formula:Add a second button, and set its OnSelect property to this formula:

    Clear( IceCream )Clear( IceCream )

  5. Visualizzare un'anteprima dell'app, scegliere o toccare il secondo pulsante e quindi chiudere l'anteprima.Preview your app, click or tap the second button, and then close Preview.

    La raccolta è ora vuota:The collection is now empty:

    La funzione Clear rimuove tutti i record da una raccolta e restituisce una raccolta vuota.The Clear function removes all the records from a collection, resulting in an empty collection. IsEmpty( IceCream ) restituisce true e CountRows( IceCream ) restituisce 0.IsEmpty( IceCream ) returns true, and CountRows( IceCream ) returns 0.

È anche possibile usare la funzione IsEmpty per verificare se una tabella calcolata è vuota, come illustrato negli esempi seguenti:You can also use IsEmpty to test whether a calculated table is empty, as these examples show:

FormulaFormula DescrizioneDescription RisultatoResult
IsEmpty( [ 1, 2, 3 ] )IsEmpty( [ 1, 2, 3 ] ) La tabella a colonna singola contiene tre record, quindi non è vuota.The single-column table contains three records and, therefore, isn't empty. falsefalse
IsEmpty( [ ] )IsEmpty( [ ] ) La tabella a colonna singola non contiene alcun record, quindi è vuota.The single-column table contains no records and is empty. truetrue
IsEmpty( Filter( [ 1, 2, 3 ], Value > 5 ) )IsEmpty( Filter( [ 1, 2, 3 ], Value > 5 ) ) La tabella a colonna singola non contiene valori maggiori di 5.The single-column table contains no values that are greater than 5. Il risultato del filtro non contiene alcun record, quindi è vuoto.The result from the filter doesn't contain any records and is empty. truetrue