Funkcie Blank, Coalesce, IsBlank a IsEmpty v službe PowerAppsBlank, Coalesce, IsBlank, and IsEmpty functions in PowerApps

Testuje, či je hodnota prázdna alebo či tabuľka neobsahuje žiadne záznamy a umožňuje vytvárať prázdne hodnoty.Tests whether a value is blank or a table contains no records, and provides a way to create blank values.

PrehľadOverview

Pojem Prázdna hodnota je zástupným symbolom pre „žiadnu hodnotu“ alebo „neznámu hodnotu“.Blank is a placeholder for "no value" or "unknown value." Vybratá vlastnosť ovládacieho prvku rozbaľovacie pole je napríklad prázdna , ak používateľ nevykonal výber.For example, a Combo box control's Selected property is blank if the user hasn't made a selection. Mnohé zdroje údajov môžu ukladať a vracať hodnoty NULL, ktoré sú zastúpené v PowerApps ako prázdne.Many data sources can store and return NULL values, which are represented in PowerApps as blank.

Ľubovoľná vlastnosť alebo vypočítaná hodnota v PowerApps môže byť prázdna.Any property or calculated value in PowerApps can be blank. Napríklad logická hodnota obsahuje za normálnych okolností jednu z dvoch hodnôt: true alebo false.For example, a Boolean value normally has one of two values: true or false. Okrem týchto dvoch hodnôt však môže byť aj prázdne , čo naznačuje, že stav nie je známy.But in addition to these two, it can also be blank indicating that the state is not known. Je to podobné ako v programe Microsoft Excel, pričom bunka pracovného hárka začína ako prázdna bez obsahu, ale môže obsahovať hodnoty true alebo False (okrem iného).This is similar to Microsoft Excel, where a worksheet cell starts out as blank with no contents but can hold the values TRUE or FALSE (among others). Obsah bunky sa dá kedykoľvek znova vymazať a vrátiť ho do prázdneho stavu.At any time, the contents of the cell can again be cleared, returning it to a blank state.

Prázdny reťazec odkazuje na reťazec, ktorý neobsahuje žiadne znaky.Empty string refers to a string that contains no characters. Funkcia len vráti nulu pre takýto reťazec a môže byť zapísaná vo vzorcoch ako dve dvojité úvodzovky s ničím medzi nimi "".The Len function returns zero for such a string and it can be written in a formulas as two double quotes with nothing in between "". Niektoré ovládacie prvky a zdroje údajov používajú prázdny reťazec na označenie podmienky bez hodnoty.Some controls and data sources use an empty string to indicate a "no value" condition. Ak chcete zjednodušiť vytváranie aplikácií, test funkcie IsBlank a zjednotenia pre prázdne hodnoty alebo prázdne reťazce.To simplify app creation, the IsBlank and Coalesce functions test for both blank values or empty strings.

V kontexte funkcie isEmpty je prázdny špecifický pre tabuľky, ktoré neobsahujú žiadne záznamy.In the context of the IsEmpty function, empty is specific to tables that contain no records. Štruktúra tabuľky môže byť neporušená, môže obsahovať názvy stĺpcov, ale nebudú v nej žiadne údaje.The table structure may be intact, complete with column names, but no data is in the table. Tabuľka môže byť na začiatku prázdna, po vložení záznamov už prázdna nebude a keď sa z nej záznamy odoberú, stane sa opäť prázdnou.A table may start as empty, take on records and no longer be empty, and then have the records removed and again be empty.

Poznámka

Sme v období prechodu.We are in a period of transition. Doteraz sa tiež použila prázdna zostava chýb, čo znemožňuje rozlišovať platnú hodnotu "No value" z chyby.Until now, blank has also been used to report errors, making it impossible to differentiate a valid "no value" from an error. Z tohto dôvodu sa v súčasnosti ukladanie prázdnych hodnôt podporuje iba v prípade lokálnych kolekcií.For this reason, at this time, storing blank values is supported only for local collections. Prázdne hodnoty môžete ukladať v iných zdrojoch údajov, ak zapnete experimentálnu funkciu "Správa chýb na úrovni vzorca" v ponuke súbor, nastavenia aplikácie, rozšírené nastavenia, experimentálne funkcie.You can store blank values in other data sources if you turn on the "Formula-level error management" experimental feature under the File menu, App settings, Advanced settings, Experimental features. Aktívne pracujeme na dokončení tejto funkcie a dokončíme správne oddelenie prázdnych hodnôt z chýb.We are actively working to finish this feature and complete the proper separation of blank values from errors.

PopisDescription

Funkcia Blank vráti prázdnu hodnotu.The Blank function returns a blank value. Používa sa na ukladanie hodnoty NULL do zdroja údajov podporujúceho tieto hodnoty, čím sa z daného poľa všetky hodnoty odstránia.Use this to store a NULL value in a data source that supports these values, effectively removing any value from the field.

Testy funkcie IsBlank pre prázdnu hodnotu alebo prázdny reťazec.The IsBlank function tests for a blank value or an empty string. Test obsahuje prázdne reťazce na zjednodušenie vytvárania aplikácií, pretože niektoré zdroje údajov a ovládacie prvky používajú prázdny reťazec, keď nie je prítomná žiadna hodnota.The test includes empty strings to ease app creation since some data sources and controls use an empty string when there is no value present. Ak chcete testovať špeciálne použitie if( Value = Blank(); ... prázdnej hodnoty namiesto IsBlank.To test specifically for a blank value use if( Value = Blank(); ... instead of IsBlank.

Funkcia zjednotenie vyhodnotí argumenty v objednávke a vráti prvú hodnotu, ktorá nie je prázdna , alebo prázdny reťazec.The Coalesce function evaluates its arguments in order and returns the first value that isn't blank or an empty string. Táto funkcia sa používa na nahradenie prázdnej hodnoty alebo prázdneho reťazca inou hodnotou, ale nezmenené hodnoty neprázdneho a neprázdneho reťazca.Use this function to replace a blank value or empty string with a different value but leave non-blank and non-empty string values unchanged. Ak sú všetky argumenty prázdne alebo prázdne reťazce, funkcia vráti prázdnu, čím sa zaplní dobrý spôsob konverzie prázdnych reťazcov na prázdne hodnoty.If all of the arguments are blank or empty strings then the function returns blank, making Coalesce a good way to convert empty strings to blank values. Všetky argumenty funkcie Coalesce musia byť rovnakého typu, nie je napríklad možné kombinovať čísla s textovými reťazcami.All arguments to Coalesce must be of the same type; for example, you can't mix numbers with text strings.

Coalesce( value1; value2 )je stručnejší ekvivalent If( Not IsBlank( value1 ); value1; Not IsBlank( value2 ); value2 ) a nevyžaduje hodnota1 a hodnota2 , ktoré sa majú vyhodnotiť dvakrát.Coalesce( value1; value2 ) is the more concise equivalent of If( Not IsBlank( value1 ); value1; Not IsBlank( value2 ); value2 ) and doesn't require value1 and value2 to be evaluated twice. Funkcia if vráti prázdnu hodnotu, ak neexistuje žiadny vzorec "else", ako je tomu v tomto prípade.The If function returns blank if there is no "else" formula as is the case here.

Funkcia IsEmpty testuje, či tabuľka obsahuje nejaké záznamy.The IsEmpty function tests whether a table contains any records. Je ekvivalentom používania funkcie CountRows a kontroly nuly.It's equivalent to using the CountRows function and checking for zero. Kombináciou funkcie IsEmpty s funkciou Errors môžete kontrolovať chyby v zdroji údajov.You can check for data-source errors by combining IsEmpty with the Errors function.

Vrátená hodnota funkcií IsBlank a IsEmpty je logická hodnota true alebo false.The return value for both IsBlank and IsEmpty is a Boolean true or false.

SyntaxSyntax

Blank()Blank()

Coalesce( Hodnota1 [; Hodnota2; ... ] )Coalesce( Value1 [; Value2; ... ] )

  • Value(s) – povinné.Value(s) – Required. Hodnoty, ktoré sa majú testovať.Values to test. Každá hodnota sa vyhodnocuje v takom prípade, kým sa nenájde hodnota, ktorá nie je prázdna , a nie je prázdny reťazec.Each value is evaluated in order until a value that is not blank and not an empty string is found. Hodnoty po tomto bode sa nehodnotia.Values after this point are not evaluated.

IsBlank( Hodnota )IsBlank( Value )

  • Value – povinné.Value – Required. Hodnota, ktorá sa má testovať na prázdnu hodnotu alebo prázdny reťazec.Value to test for a blank value or empty string.

IsEmpty( Table )IsEmpty( Table )

  • Table – povinné.Table - Required. Tabuľka, v ktorej sa majú testovať záznamy.Table to test for records.

PríkladyExamples

BlankBlank

Poznámka

V súčasnosti platí nasledujúci príklad iba pre lokálne kolekcie.At this time, the following example only works for local collections. Prázdne hodnoty môžete ukladať v iných zdrojoch údajov, ak zapnete experimentálnu funkciu "Správa chýb na úrovni vzorca" v ponuke súbor, nastavenia aplikácie, rozšírené nastavenia, experimentálne funkcie.You can store blank values in other data sources if you turn on the "Formula-level error management" experimental feature under the File menu, App settings, Advanced settings, Experimental features. Aktívne pracujeme na dokončení tejto funkcie a dokončíme separáciu prázdnych hodnôt z chýb.We are actively working to finish this feature and complete the separation of blank values from errors.

  1. Vytvorte úplne novú aplikáciu a pridajte ovládací prvok Tlačidlo.Create an app from scratch, and add a Button control.

  2. Vlastnosť tlačidla OnSelect nastavte na tento vzorec:Set the button's OnSelect property to this formula:

    ClearCollect( Cities; { Name: "Seattle"; Weather: "Rainy" } )
    
  3. Zobrazte ukážku aplikácie, kliknite alebo ťuknite na pridané tlačidlo a potom ukážku zatvorte.Preview your app, click or tap the button that you added, and then close Preview.

  4. V ponuke Súbor kliknite alebo ťuknite na položku Kolekcie.On the File menu, click or tap Collections.

    Zobrazí sa kolekcia Cities (Mestá), a bude zobrazovať jeden záznam s hodnotami „Seattle“ a „Rainy“ (Daždivo):The Cities collection appears, showing one record with "Seattle" and "Rainy":

    Kolekcia zobrazujúca Seattle a daždivé počasie

  5. Kliknutím alebo ťuknutím na šípku späť sa vráťte do predvoleného pracovného priestoru.Click or tap the back arrow to return to the default workspace.

  6. Pridajte ovládací prvok Označenie a jeho vlastnosť Text nastavte na tento vzorec:Add a Label control, and set its Text property to this formula:

    IsBlank( First( Cities ).Weather )
    

    Označenie má hodnotu false, pretože pole Weather (Počasie) obsahuje hodnotu („Rainy“ (Daždivo)).The label shows false because the Weather field contains a value ("Rainy").

  7. Pridajte druhé tlačidlo a jeho vlastnosť OnSelect nastavte na tento vzorec:Add a second button, and set its OnSelect property to this formula:

    Patch( Cities; First( Cities ); { Weather: Blank() } )
    
  8. Zobrazte ukážku aplikácie, kliknite alebo ťuknite na pridané tlačidlo a potom ukážku zatvorte.Preview your app, click or tap the button that you added, and then close Preview.

    Pole Weather prvého záznamu v kolekcii Cities je nahradené prázdnou hodnotou a hodnota „Rainy“, ktorá tam bola predtým, je odstránená.The Weather field of the first record in Cities is replaced with a blank, removing the "Rainy" that was there previously.

    Kolekcia zobrazujúca Seattle s prázdnym poľom Weather

    Označenie zobrazuje true, pretože pole Weather už neobsahuje hodnotu.The label shows true because the Weather field no longer contains a value.

CoalesceCoalesce

VzorecFormula PopisDescription VýsledokResult
Zjednotenie (prázdne () , 1)Coalesce( Blank(); 1 ) Testuje hodnotu vrátenú funkciou Blank, ktorá vždy vracia prázdnu hodnotu.Tests the return value from the Blank function, which always returns a blank value. Keďže prvý argument je prázdny, hodnotenie pokračuje s ďalším argumentom, kým sa nenájde hodnota, ktorá nie je prázdna, a neprázdny reťazec.Because the first argument is blank, evaluation continues with the next argument until a non-blank value and non-empty string is found. 11
Zjednotenie ("", 2)Coalesce( ""; 2 ) Otestuje prvý argument, ktorý je prázdnym reťazcom.Tests the first argument which is an empty string. Keďže prvý argument je prázdny reťazec, hodnotenie pokračuje s ďalším argumentom, kým sa nenájde hodnota , ktorá nie je prázdna, a neprázdny reťazec.Because the first argument is an empty string, evaluation continues with the next argument until a non-blank value and non-empty string is found. 22
Zjednotenie (prázdne (), "", prázdne (), "", 3, 4)Coalesce( Blank(); ""; Blank(); ""; 3; 4 ) Zjednotenie začína na začiatku zoznamu argumentov a vyhodnotí každý argument, až kým sa nenájdeNeprázdna hodnota a neprázdny reťazec.Coalesce starts at the beginning of the argument list and evaluates each argument in turn until a non-blank value and non-empty string is found. V tomto prípade sa prvé štyri argumenty vrátia prázdne alebo prázdny reťazec, takže hodnotenie pokračuje piatym argumentom.In this case, the first four arguments all return blank or an empty string, so evaluation continues to the fifth argument. Piaty argument nie jeprázdny a neprázdny reťazec, takže hodnotenie sa tu zastaví.The fifth argument is non-blank and non-empty string, so evaluation stops here. Hodnota piateho argumentu sa vráti a šiesty argument sa nevyhodnocuje.The value of the fifth argument is returned, and the sixth argument isn't evaluated. 33
Zjednotenie ("")Coalesce( "" ) Otestuje prvý argument, ktorý je prázdnym reťazcom.Tests the first argument which is an empty string. Pretože prvý argument je prázdny reťazec a nie sú k dispozícii žiadne ďalšie argumenty, funkcia vráti prázdnuhodnotu.Because the first argument is an empty string, and there are no more arguments, the function returns blank. prázdna hodnotablank

IsBlankIsBlank

  1. Vytvorte úplne novú aplikáciu, pridajte ovládací prvok zadávanie textu a pomenujte ho FirstName.Create an app from scratch, add a text-input control, and name it FirstName.

  2. Pridajte označenie a jeho vlastnosť Text nastavte na tento vzorec:Add a label, and set its Text property to this formula:

    If( IsBlank( FirstName.Text ); "First Name is a required field." )
    

    Podľa predvoleného nastavenia je vlastnosť Text ovládacieho prvku zadávanie textu nastavená na hodnotu "Text input" .By default, the Text property of a text-input control is set to "Text input". Keďže vlastnosť obsahuje hodnotu, nie je prázdna. Označenie nezobrazí žiadnu správu.Because the property contains a value, it isn't blank, and the label doesn't display any message.

  3. Odstráňte z ovládacieho prvku zadávanie textu všetky znaky vrátane medzier.Remove all the characters from the text-input control, including any spaces.

    Pretože vlastnosť text už neobsahuje žiadne znaky, je to prázdny reťazec a IsBlank (FirstName. text) bude mať hodnotu True.Because the Text property no longer contains any characters, it's an empty string, and IsBlank( FirstName.Text ) will be true. Zobrazí sa správa, že pole je povinné.The required field message is displayed.

Informácie o tom, ako vykonať overenie pomocou iných nástrojov nájdete článkoch o funkcii Validate a o práci so zdrojmi údajov.For information about how to perform validation by using other tools, see the Validate function and working with data sources.

Ďalšie príklady:Other examples:

VzorecFormula PopisDescription VýsledokResult
IsBlank ( prázdny () )IsBlank( Blank() ) Testuje hodnotu vrátenú funkciou Blank, ktorá vždy vracia prázdnu hodnotu.Tests the return value from the Blank function, which always returns a blank value. truetrue
IsBlank( "" )IsBlank( "" ) Reťazec, ktorý neobsahuje žiadne znaky.A string that contains no characters. truetrue
IsBlank( "Hello" )IsBlank( "Hello" ) Reťazec, ktorý obsahuje jeden alebo viac znakov.A string that contains one or more characters. falsefalse
IsBlank( AnyCollection )IsBlank( AnyCollection ) Keďže kolekcia existuje, nie je prázdna, dokonca ani v prípade, že neobsahuje žiadne záznamy.Because the collection exists, it isn't blank, even if it doesn't contain any records. Ak chcete skontrolovať, či je kolekcia prázdna, použite namiesto toho funkciu IsEmpty.To check for an empty collection, use IsEmpty instead. falsefalse
IsBlank( Mid( "Hello"; 17; 2 ) )IsBlank( Mid( "Hello"; 17; 2 ) ) Počiatočný znak pre funkciu Mid je za koncom reťazca.The starting character for Mid is beyond the end of the string. Výsledkom je prázdny reťazec.The result is an empty string. truetrue
IsBlank( If( false; false ) )IsBlank( If( false; false ) ) Funkcia If bez hodnoty ElseResult.An If function with no ElseResult. Keďže podmienka má vždy hodnotu false, funkcia If vráti vždy prázdnu hodnotu.Because the condition is always false, this If always returns blank. truetrue

IsEmptyIsEmpty

  1. Vytvorte úplne novú aplikáciu a pridajte ovládací prvok Tlačidlo.Create an app from scratch, and add a Button control.

  2. Vlastnosť tlačidla OnSelect nastavte na tento vzorec:Set the button's OnSelect property to this formula:

    Collect (zmrzlina; {Flavor: "Jahoda"; množstvo: 300}; {Flavor: "Čokoláda"; množstvo: 100})Collect( IceCream; { Flavor: "Strawberry"; Quantity: 300 }; { Flavor: "Chocolate"; Quantity: 100 } )

  3. Zobrazte ukážku aplikácie, kliknite alebo ťuknite na pridané tlačidlo a potom ukážku zatvorte.Preview your app, click or tap the button that you added, and then close Preview.

    Vytvorí sa kolekcia s názvom IceCream (Zmrzlina) obsahujúca tieto údaje:A collection named IceCream is created and contains this data:

    Táto kolekcia obsahuje dva záznamy a nie je prázdna.This collection has two records and isn't empty. Funkcia IsEmpty( IceCream ) vracia hodnotu false a funkcia CountRows( IceCream ) vracia hodnotu 2.IsEmpty( IceCream ) returns false, and CountRows( IceCream ) returns 2.

  4. Pridajte druhé tlačidlo a jeho vlastnosť OnSelect nastavte na tento vzorec:Add a second button, and set its OnSelect property to this formula:

    Clear( IceCream )Clear( IceCream )

  5. Zobrazte ukážku aplikácie, kliknite alebo ťuknite na druhé tlačidlo a potom ukážku zatvorte.Preview your app, click or tap the second button, and then close Preview.

    Kolekcia je teraz prázdna:The collection is now empty:

    Funkcia Clear odstráni z kolekcie všetky záznamy, takže výsledkom je prázdna kolekcia.The Clear function removes all the records from a collection, resulting in an empty collection. Funkcia IsEmpty( IceCream ) vracia hodnotu true a funkcia CountRows( IceCream ) vracia hodnotu 0.IsEmpty( IceCream ) returns true, and CountRows( IceCream ) returns 0.

Pomocou funkcie IsEmpty môžete otestovať, či je vypočítaná tabuľka prázdna, tak ako to uvádzajú nasledujúce príklady:You can also use IsEmpty to test whether a calculated table is empty, as these examples show:

VzorecFormula PopisDescription VýsledokResult
IsEmpty( [ 1; 2; 3 ] )IsEmpty( [ 1; 2; 3 ] ) Tabuľka s jedným stĺpcom obsahuje tri záznamy, takže nie je prázdna.The single-column table contains three records and, therefore, isn't empty. falsefalse
IsEmpty( [ ] )IsEmpty( [ ] ) Tabuľka s jedným stĺpcom neobsahuje žiadne záznamy, takže je prázdna.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 ) ) Tabuľka s jedným stĺpcom neobsahuje žiadne hodnoty väčšie ako 5.The single-column table contains no values that are greater than 5. Výsledok z funkcie filter neobsahuje žiadne záznamy a je prázdny.The result from the filter doesn't contain any records and is empty. truetrue