IsMatch, zhodu a MatchAll funkcie v službe PowerAppsIsMatch, Match, and MatchAll functions in PowerApps

Testuje zhodu alebo výpisov časti textového reťazca na základe vzorom.Tests for a match or extracts portions of a text string based on a pattern.

PopisDescription

Funkcia IsMatch testuje, či sa textový reťazec zhoduje so vzorom, ktorý sa môže skladať z obyčajných znakov, preddefinovaného vzoru alebo regulárneho výrazu.The IsMatch function tests whether a text string matches a pattern that can comprise ordinary characters, predefined patterns, or a regular expression. Zhoda a MatchAll funkcie vracajú, čo sa zhodovala, vrátane čiastkové zhody.The Match and MatchAll functions return what was matched, including sub-matches.

Pomocou funkcie IsMatch môžete overiť, či používateľ zadal správny text do ovládacieho prvku Vstup textu.Use IsMatch to validate what a user has typed in a Text input control. Môžete napríklad overiť, či používateľ zadal platnú e-mailovú adresu predtým, než sa výsledok uloží do vášho zdroja údajov.For example, you can confirm whether the user has entered a valid email address before the result is saved to your data source. Ak zadaný text nespĺňa vaše kritériá, pridajte ďalšie prvky, ktorý používateľa vyzvú, aby zadaný text opravil.If the entry doesn't match your criteria, add other controls that prompt the user to correct the entry.

Použitie zhodovať s extrahovať prvý textový reťazec, ktorý sa zhoduje so vzorom a MatchAll na extrakciu všetky textové reťazce, ktoré sa zhodujú.Use Match to extract the first text string that matches a pattern and MatchAll to extract all text strings that match. Môžete tiež extrahovať čiastkové zhody sa nám analyzovať zložité reťazce.You can also extract sub-matches to parse complex strings.

Zhodovať s vráti záznam informácií o prvý zhoda nájde, a MatchAll vráti záznamy pre každú nenašla sa zhoda.Match returns a record of information for the first match found, and MatchAll returns a table of records for every match found. Záznam alebo záznamy obsahujú:The record or records contain:

StĺpecColumn TypType PopisDescription
s názvom vedľajšia‑sa nezhoduje s alebo vedľajšej‑zodpovedánamed sub‑match or sub‑matches TextText Každá pomenovaná čiastkové zhoda bude mať svoj vlastný stĺpec.Each named sub-match will have its own column. Vytvoriť pomenovaný čiastkové zhodu s použitím (?< názov>... ) v regulárnom výraze.Create a named sub-match by using (?<name>...) in the regular expression. Ak pomenované čiastkové zhodu má rovnaký názov ako niektorý z preddefinovaných stĺpcov (pozri nižšie), čiastkové zhoda má prednosť pred a vygeneruje upozornenie.If a named sub-match has the same name as one of the predefined columns (below), the sub-match takes precedence, and a warning is generated. Aby ste zabránili Toto upozornenie, premenujte čiastkové zhoda.To avoid this warning, rename the sub-match.
FullMatchFullMatch TextText Všetky textový reťazec, ktorý sa priradila.All of the text string that was matched.
StartMatchStartMatch ČísloNumber Počiatočná pozícia zhodu v rámci vstupného textového reťazca.The starting position of the match within the input text string. Prvý znak reťazca vráti hodnotu 1.The first character of the string returns 1.
SubMatchesSubMatches Tabuľka s jedným stĺpcom textu (stĺpec hodnotu)Single-column table of Text (column Value) Tabuľka s názvom a nepomenované čiastkové zhody v poradí, v ktorom sa zobrazujú v regulárnom výraze.The table of named and unnamed sub-matches in the order in which they appear in the regular expression. Všeobecne platí, pomenované čiastkové zhody sú ľahšie pracovalo a povzbudiť.Generally, named sub-matches are easier to work with and are encouraged. Použitie ForAll funkcia alebo posledný( FirstN() ... )) na prácu s individuálne čiastkové zhoda.Use the ForAll function or Last( FirstN( ... ) ) functions to work with an individual sub-match. Ak sú definované žiadne čiastkové zhody v regulárnom výraze, táto tabuľka je prítomný, ale prázdne.If no sub-matches are defined in the regular expression, this table will be present but empty.

Tieto funkcie podporujú možností zhody.These functions support MatchOptions. V predvolenom nastavení:By default:

  • Tieto funkcie vykonať s rozlišovaním.These functions perform a case-sensitive match. Použitie IgnoreCase na vykonávanie nerozlišuje zhody.Use IgnoreCase to perform case-insensitive matches.
  • IsMatch zodpovedá celého textového reťazca (Complete MatchOption), zatiaľ čo zhodovať s a MatchAll vyhľadať zhodu kdekoľvek v textovom reťazci ( Obsahuje MatchOption).IsMatch matches the entire text string (Complete MatchOption), while Match and MatchAll search for a match anywhere in the text string (Contains MatchOption). Použitie Complete, Contains, BeginsWith, alebo EndsWith podľa potreby vášho scenára.Use Complete, Contains, BeginsWith, or EndsWith as appropriate for your scenario.

AK sa textový reťazec so vzorom zhoduje, funkcia IsMatch vráti hodnotu true (pravda), v opačnom prípade vráti hodnotu false (nepravda).IsMatch returns true if the text string matches the pattern or false if it doesn't. Zhodovať s vráti prázdne Ak sa nenájde žiadny, ktoré môžu byť testované s IsBlank funkcie.Match returns blank if no match is found that can be tested with the IsBlank function. MatchAll vráti prázdna tabuľka, ak sa nenájde zhoda, ktoré môžu byť testované s IsEmpty funkcie.MatchAll returns an empty table if no match is found that can be tested with the IsEmpty function.

Ak používate MatchAll rozdelí textový reťazec, zvážte použitie rozdelenie funkciu, ktorá je rýchlejšie a jednoduchšie na použitie.If you're using MatchAll to split a text string, consider using the Split function, which is simpler to use and faster.

VzoryPatterns

Kľúč na používanie týchto funkcií je popísanie vzoru tak, aby zodpovedali.The key to using these functions is in describing the pattern to match. Vzor v textovom reťazci sa popisuje ako kombinácia:You describe the pattern in a text string as a combination of:

  • obyčajných znakov, napríklad "abc" alebo "123";Ordinary characters, such as "abc" or "123".
  • preddefinovaných vzorov, napríklad Letter (písmeno), MultipleDigits (viacero číslic) alebo EmailPredefined patterns, such as Letter, MultipleDigits, or Email. (tieto vzory sú definované v zozname zhôd);(The Match enum defines these patterns.)
  • Bežného výrazu kódov, ako napríklad "\d+\s+\d+" alebo "[a-z] +".Regular-expression codes, such as "\d+\s+\d+" or "[a-z]+".

Tieto prvky môžete kombinovať pomocou reťazec Zlučovací operátor & .Combine these elements by using the string-concatenation operator &. Napríklad "abc" & Digit & "\s+" je platný vzor, ktorý sa zhoduje so znakmi "a", "b" a "c", za ktorými nasleduje číslica od 0 do 9, za ktorou nasleduje aspoň jeden prázdny znak.For example, "abc" & Digit & "\s+" is a valid pattern that matches the characters "a", "b", and "c", followed by a digit from 0 to 9, followed by at least one whitespace character.

Bežné znakyOrdinary characters

Najjednoduchším vzorom je postupnosť bežných znakov, ktoré sa majú presne zhodovať.The simplest pattern is a sequence of ordinary characters to be matched exactly.

Napríklad pri použití s IsMatch funkciu, reťazec "Ahoj" zhoduje so vzorom "Hello" presne.For example, when used with the IsMatch function, the string "Hello" matches the pattern "Hello" exactly. O nič viac a o nič menej.No more and no less. Reťazec "ahoj!"The string "hello!" nezhoduje so vzorom z dôvodu výkričníka na konci a pretože je na písmeno "h".doesn't match the pattern because of the exclamation point on the end and because the case is wrong for the letter "h". (Spôsoby, ako toto správanie upraviť, nájdete v časti Možnosti zhody.)(See MatchOptions for ways to modify this behavior.)

V jazyku vzoru sú niektoré znaky vyhradené pre zvláštne účely.In the pattern language, certain characters are reserved for special purposes. Ak chcete použiť tieto znaky, buď pred znak \ (opačná lomka) na znamenie, že znak brať doslova, prípadne použite niektorý z preddefinovaných vzorov uvedených nižšie v tejto téme.To use these characters, either prefix the character with a \ (backslash) to indicate that the character should be taken literally, or use one of the predefined patterns described later in this topic. Špeciálne znaky sú uvedené v tejto tabuľke:This table lists the special characters:

Špeciálny znakSpecial character PopisDescription
.. bodka alebo čiarkadot or period
?? otáznikquestion mark
** hviezdičkaasterisk
+ plusplus
( )( ) Zátvorkyparentheses
[ ][ ] hranaté zátvorkysquare brackets
{ }{ } zložené zátvorkycurly braces
^ strieškacaret
$ znak doláradollar sign
| zvislá čiaravertical bar or pipe
\ spätná lomkabackslash

Napríklad môžete použiť zhodu reťazca "Dobrý deň?"For example, you can match "Hello?" pomocou vzoru "Dobrý deň\?"by using the pattern "Hello\?" so spätnou lomkou pred otáznikom.with a backslash before the question mark.

Preddefinované vzoryPredefined patterns

Preddefinované vzory poskytujú jednoduchý spôsob, ako tak, aby zodpovedali buď jeden zo skupiny znakov alebo s postupnosťou viacerých znakov.Predefined patterns provide a simple way to match either one of a set of characters or a sequence of multiple characters. Použitie reťazec Zlučovací operátor & na svoje vlastné textové reťazce skombinovať s členmi zhody enumerácie:Use the string-concatenation operator & to combine your own text strings with members of the Match enum:

Zhoda enumerácieMatch enum PopisDescription Regulárny výrazRegular expression
AnyAny Skontroluje zhodu s ľubovoľným znakom.Matches any character. .
CommaComma Skontroluje zhodu s čiarkou.Matches a comma. ;
DigitDigit Skontroluje zhodu s jednou číslicou (0 až 9).Matches a single digit ("0" through "9"). \d
EmailEmail Skontroluje zhodu s e-mailovú adresou, ktorá obsahuje symbol „zavináča“ (@) a názov domény obsahujúci bodku (.)Matches an email address that contains an "at" symbol ("@") and a domain name that contains a dot (".") .+\@.+\\.[^\\.]{2;}
SpojovníkHyphen Skontroluje zhodu so spojovníkom.Matches a hyphen. \-
LeftParenLeftParen Skontroluje zhodu s ľavou zátvorkou (.Matches a left parenthesis "(". \(
LetterLetter Skontroluje zhodu s písmenom.Matches a letter. \p{L}
MultipleDigitsMultipleDigits Skontroluje zhodu s jeden alebo viac číslic.Matches one or more digits. \d+
MultipleLettersMultipleLetters Skontroluje zhodu s viacerými písmenami.Matches one or more letters. \p{L}+
MultipleNonSpacesMultipleNonSpaces Skontroluje zhodu s jedným alebo viacerými znakmi, ktoré nepridávajú prázdny znak (nie kartu miesto alebo tabulátor, nový riadok).Matches one or more characters that don't add whitespace (not space, tab, or newline). \S+
MultipleSpacesMultipleSpaces Skontroluje zhodu s jedným alebo viacerými znakmi, ktoré pridávajú prázdny znak (medzera, karta alebo tabulátor, nový riadok).Matches one or more characters that add whitespace (space, tab, or newline). \s+
NonSpaceNonSpace Skontroluje zhodu s jedným znakom, ktorý nepridáva prázdny znak.Matches a single character that doesn't add whitespace. \S
OptionalDigitsOptionalDigits Skontroluje zhodu s žiadnou, jednou alebo viacerými číslicami.Matches zero, one, or more digits. \d*
OptionalLettersOptionalLetters Skontroluje zhodu s žiadnym, jedným alebo viacerými písmenami.Matches zero, one, or more letters. \p{L}*
OptionalNonSpacesOptionalNonSpaces Skontroluje zhodu s žiadnym, jedným alebo viacerými znakmi, ktoré nepridávajú prázdny znak.Matches zero, one, or more characters that don't add whitespace. \S*
OptionalSpacesOptionalSpaces Skontroluje zhodu s žiadnym, jedným alebo viacerými znakmi, ktoré pridávajú prázdny znak.Matches zero, one, or more characters that add whitespace. \s*
PeriodPeriod Skontroluje zhodu s bodkou (.).Matches a period or dot ("."). \.
RightParenRightParen Skontroluje zhodu s pravou zátvorkou (.Matches a right parenthesis ")". \)
SpaceSpace Skontroluje zhodu so znakom, ktorý pridáva prázdny znak.Matches a character that adds whitespace. \s

Napríklad vzor "A" & MultipleDigits skontroluje zhodu s písmenom „A“, za ktorým nasleduje jedna alebo viacero číslic.For example, the pattern "A" & MultipleDigits will match the letter "A" followed by one or more digits.

Regulárne výrazyRegular expressions

Tieto funkcie používať ktorými je regulárny výraz.The pattern that these functions use is a regular expression. Obyčajné znaky a preddefinované vzory, ktoré sú popísané vyššie v tejto téme Pomocníka na vytváranie regulárnych výrazov.The ordinary characters and predefined patterns that are described earlier in this topic help build regular expressions.

Regulárne výrazy sú veľmi účinné, dostupné v rôznych programovacích jazykoch a používajú sa na najrôznejšie účely.Regular expressions are very powerful, available in many programming languages, and used for a wide variety of purposes. Môžu tiež často vyzerať náhodné poradie interpunkčných znamienok.They can also often look like a random sequence of punctuation marks. Tento článok neopisuje všetky aspekty regulárnych výrazov, ale obrovské množstvo informácií, kurzy, a nástroje sú k dispozícii na webe.This article doesn't describe all aspects of regular expressions, but a wealth of information, tutorials, and tools are available on the web.

Regulárne výrazy prichádzajú rôzne dialekty a služba PowerApps používa variant dialektu JavaScriptu.Regular expressions come in different dialects, and PowerApps uses a variant of the JavaScript dialect. Pozrite si syntaxi bežného výrazu Úvod do syntax.See regular-expression syntax for an introduction to the syntax. Podporované sú pomenované čiastkové zhody (niekedy nazývané skupiny s názvom snímanie):Named sub-matches (sometimes called named capture groups) are supported:

  • S názvom čiastkové zhody: (?< názov > ...)Named sub-matches: (?<name> ...)
  • S názvom backreferences: \k<názov>Named backreferences: \k<name>

V zhody enumerácie tabuľky vyššie v tejto téme sa každá položka zoznamu dá sa zobrazí v rovnakom riadku ako zodpovedajúceho regulárneho výrazu.In the Match enum table earlier in this topic, each enum appears in the same row as its corresponding regular expression.

Možnosti zhodyMatch options

Správanie týchto funkcií môžete upraviť zadaním jednej alebo viacerých možností, ktoré môžete kombinovať pomocou operátora zreťazenia reťazca (&).You can modify the behavior of these functions by specifying one or more options, which you can combine by using the string- concatenation operator (&).

Zoznam možností zhodyMatchOptions enum PopisDescription Vplyv na regulárny výrazImpact on a regular expression
BeginsWithBeginsWith Vzor sa musí zhodovať od začiatku textu.The pattern must match from the beginning of the text. Pridá ^ na začiatok regulárneho výrazu.Adds a ^ to the start of the regular expression.
CompleteComplete Predvolená hodnota pre IsMatch.Default for IsMatch. Vzor sa musí zhodovať celý reťazec textu, od začiatku do konca.The pattern must match the entire string of text, from beginning to end. Pridá ^ na začiatku a $ na koniec regulárneho výrazu.Adds a ^ to the start and a $ to the end of the regular expression.
ContainsContains Predvolená hodnota pre zhoda a MatchAll.Default for Match and MatchAll. Vzor sa musí nachádzať niekde v texte, ale nemusí byť na začiatku ani na konci.The pattern must appear somewhere in the text but doesn't need to begin or end it. Nezmení regulárny výraz.Doesn't modify the regular expression.
EndsWithEndsWith Vzor sa musí zhodovať s konca textového reťazca.The pattern must match the end of the string of text. Pridá $ na koniec regulárneho výrazu.Adds a $ to the end of the regular expression.
IgnoreCaseIgnoreCase Zaobchádza veľké a malé písmená ako identické.Treats uppercase and lowercase letters as identical. V predvolenom nastavení sa veľkosť písmen rozlišuje.By default, matching is case sensitive. Nezmení regulárny výraz.Doesn't modify the regular expression. Táto možnosť je ekvivalentom štandardných "i" modifikátor pre regulárne výrazy.This option is the equivalent of the standard "i" modifier for regular expressions.
MultilineMultiline Kontroluje zhodu na viacerých riadkoch.Matches across multiple lines. Nezmení regulárny výraz.Doesn't modify the regular expression. Táto možnosť je ekvivalentom standard "m" modifikátor pre regulárne výrazy.This option is the equivalent of the standard "m" modifier for regular expressions.

Pomocou MatchAll je ekvivalentom používania štandardné "g" modifikátor pre regulárne výrazy.Using MatchAll is equivalent to using the standard "g" modifier for regular expressions.

SyntaxSyntax

IsMatch( Text; Vzor [; Možnostii ] )IsMatch( Text; Pattern [; Options ] )

  • Text – povinné.Text – Required. Textový reťazec, ktorý sa má otestovať.The text string to test.
  • Pattern – povinné.Pattern – Required. Vzor na otestovanie ako textový reťazec.The pattern to test as a text string. Zreťazte preddefinované vzory, ktoré zhody enumerácie definuje, alebo zadajte regulárny výraz.Concatenate predefined patterns that the Match enum defines, or provide a regular expression. Vzor musí byť konštantná vzorca bez toho, aby všetky premenné, zdroje údajov alebo iné dynamic odkazy na túto zmenu je aplikácia spustená.Pattern must be a constant formula without any variables, data sources, or other dynamic references that change as the app runs.
  • Možnosti – voliteľné.Options – Optional. Textový reťazec kombináciu možností zhody hodnôt zo zoznamu.A text-string combination of MatchOptions enum values. V predvolenom nastavení sa používa MatchOptions.Complete.By default, MatchOptions.Complete is used.

Zhoda( Text; vzor [; možnosti ])Match( Text; Pattern [; Options ] )

  • Text – povinné.Text – Required. Textový reťazec tak, aby zodpovedali.The text string to match.
  • Pattern – povinné.Pattern – Required. Vzor tak, aby zodpovedali ako textový reťazec.The pattern to match as a text string. Zreťazte preddefinované vzory, ktoré zhody enumerácie definuje, alebo zadajte regulárny výraz.Concatenate predefined patterns that the Match enum defines, or provide a regular expression. Vzor musí byť konštantná vzorca bez toho, aby všetky premenné, zdroje údajov alebo iné dynamic odkazy na túto zmenu je aplikácia spustená.Pattern must be a constant formula without any variables, data sources, or other dynamic references that change as the app runs.
  • Možnosti – voliteľné.Options – Optional. Textový reťazec kombináciu možností zhody hodnôt zo zoznamu.A text-string combination of MatchOptions enum values. V predvolenom nastavení MatchOptions.Contains sa používa.By default, MatchOptions.Contains is used.

MatchAll( Text; vzor [; možnosti ])MatchAll( Text; Pattern [; Options ] )

  • Text – povinné.Text – Required. Textový reťazec tak, aby zodpovedali.The text string to match.
  • Pattern – povinné.Pattern – Required. Vzor tak, aby zodpovedali ako textový reťazec.The pattern to match as a text string. Zreťazte preddefinované vzory, ktoré zhody enumerácie definuje, alebo zadajte regulárny výraz.Concatenate predefined patterns that the Match enum defines, or provide a regular expression. Vzor musí byť konštantná vzorca bez toho, aby všetky premenné, zdroje údajov alebo iné dynamic odkazy na túto zmenu je aplikácia spustená.Pattern must be a constant formula without any variables, data sources, or other dynamic references that change as the app runs.
  • Možnosti – voliteľné.Options – Optional. Textový reťazec kombináciu možností zhody hodnôt zo zoznamu.A text-string combination of MatchOptions enum values. V predvolenom nastavení MatchOptions.Contains sa používa.By default, MatchOptions.Contains is used.

IsMatch príkladovIsMatch examples

Bežné znakyOrdinary characters

Predstavte si, že vaša aplikácia obsahuje ovládací prvok Vstup textu s názvom VstupTextu1.Imagine that your app contains a Text input control named TextInput1. Používateľ zadá do tohto ovládacieho prvku hodnoty, ktoré sa majú uložiť do databázy.The user enters values into this control to be stored in a database.

Používateľ do prvku VstupTextu1 napíše Hello world.The user types Hello world into TextInput1.

VzorecFormula PopisDescription VýsledokResult
IsMatch( TextInput1.Text; "Hello world" ) Testy určuje, či sa zadanie používateľa presne zhoduje s, reťazec "Hello world".Tests whether the user's input matches, exactly, the string "Hello world". truetrue
IsMatch( TextInput1.Text; "Good bye" ) Testy určuje, či sa zadanie používateľa presne zhoduje s, reťazec "Good bye".Tests whether the user's input matches, exactly, the string "Good bye". falsefalse
IsMatch( TextInput1.Text; "hello"; Contains ) Testuje, či zadanie používateľa obsahuje slovo "hello" (malé a veľké písmená).Tests whether the user's input contains the word "hello" (case sensitive). falsefalse
IsMatch( TextInput1.Text; "hello"; Contains & IgnoreCase ) Skontroluje, či zadanie používateľa obsahuje slovo „hello“ (bez rozlíšenia veľkosti písmen).Tests whether the user's input contains the word "hello" (case insensitive). truetrue

Preddefinované vzoryPredefined patterns

VzorecFormula PopisDescription VýsledokResult
IsMatch( "123-45-7890"; Digit & Digit & Digit & Hyphen & Digit & Digit & Hyphen & Digit & Digit & Digit & Digit ) Zodpovedá číslu sociálneho poistenia v USA.Matches a United States Social Security Number truetrue
IsMatch( "joan@contoso.com"; Email ) Zodpovedá e-mailovej adrese.Matches an email address truetrue
IsMatch( "123.456"; MultipleDigits & Period & OptionalDigits ) Zodpovedá postupnosti číslic nasledovanej bodkou a potom žiadnou alebo viacerými číslicami.Matches a sequence of digits, a period, and then zero or more digits. truetrue
IsMatch( "123"; MultipleDigits & Period & OptionalDigits ) Zodpovedá postupnosti číslic nasledovanej bodkou a potom žiadnou alebo viacerými číslicami.Matches a sequence of digits, a period, and then zero or more digits. Bodka sa v texte tak, aby zodpovedali, takže nie je tento vzor nezhoduje.A period doesn't appear in the text to match, so this pattern isn't matched. falsefalse

Regulárne výrazyRegular expressions

VzorecFormula PopisDescription VýsledokResult
IsMatch( "986"; "\d+" ) Zodpovedá celému číslu väčšiemu než nula.Matches an integer greater than zero. truetrue
IsMatch( "1.02"; "\d+(\.\d\d)?" ) Zodpovedá kladnej peňažnej čiastke.Matches a positive currency amount. Ak zadanie obsahuje desatinnú, bodku musí obsahovať tiež dva číselné znaky za desatinnou bodkou.If the input contains a decimal point, the input must also contain two numeric characters after the decimal point. Napríklad 3.00 je platné, ale 3.1 nie je.For example, 3.00 is valid, but 3.1 isn't. truetrue
IsMatch( "-4.95"; "(-)?\d+(\.\d\d)?" ) Zodpovedá kladnej alebo zápornej peňažnej čiastke.Matches a positive or negative currency amount. Ak zadanie obsahuje desatinnú, bodku musí obsahovať tiež dva číselné znaky za desatinnou bodkou.If the input contains a decimal point, the input must also contain two numeric characters after the decimal point. truetrue
IsMatch( "111-11-1111"; "\d{3}-\d{2}-\d{4}" ) Zodpovedá číslu sociálneho poistenia v USA.Matches a United States Social Security number. Overí formát, typ a dĺžku zadaného poľa.Validates the format, type, and length of the supplied input field. Reťazec tak, aby zodpovedali musí pozostávať z troch číselné znaky nasleduje spojovník a potom dva číselné znaky nasleduje spojovník a potom štyri číselné znaky.The string to match must consist of three numeric characters followed by a dash, then two numeric characters followed by a dash, and then four numeric characters. truetrue
IsMatch( "111-111-111"; "\d{3}-\d{2}-\d{4}" ) Rovnaké ako predchádzajúci príklad, ale jeden zo spojovníkov nie je v zadaní na správnom mieste.Same as the previous example, but one of the hyphens is out of place in the input. falsefalse
IsMatch( "AStrongPasswordNot"; "(?!^[0-9]\*$)(?!^[a-zA-Z]\*$)([a-zA-Z0-9]{8,10})" ) Overí silné heslo, ktoré musí obsahovať 8, 9 alebo 10 znakov a okrem toho aspoň jednu číslicu a aspoň jeden znak abecedy.Validates a strong password, which must contain eight, nine, or 10 characters, in addition to at least one digit and at least one alphabetic character. Reťazec nesmie obsahovať špeciálne znaky.The string must not contain special characters. falsefalse
IsMatch( "<http://microsoft.com>"; "(ht&#124;f)tp(s?)\:\/\/\[0-9a-zA-Z\]([-.\w]\*[0-9a-zA-Z])\*(:(0-9)\*)\*(\/?)([a-zA-Z0-9\-\.\?\,\'\/\\\+&%\$#_]\*)?" ) Overí URL adresu s protokolom http, https alebo ftp.Validates an http, https, or ftp URL. truetrue

Zhoda a MatchAll príkladyMatch and MatchAll examples

VzorecFormula PopisDescription VýsledokResult
Match( "Bob Jones <bob.jones@contoso.com>"; "<(?<email>" & Match.Email & ")>" Extrahuje iba časť e-mailové kontaktné informácie.Extracts only the email portion of the contact information. {{
e-mailu: "bob.jones@contoso.com",email: "bob.jones@contoso.com",
FullMatch: "<bob.jones@contoso.com>",FullMatch: "<bob.jones@contoso.com>",
SubMatches: [ "bob.jones@contoso.com" ],SubMatches: [ "bob.jones@contoso.com" ],
StartMatch: 11StartMatch: 11
}}
Match( "Bob Jones <InvalidEmailAddress>"; "<(?<email>" & Match.Email & ")>" Extrahuje iba časť e-mailové kontaktné informácie.Extracts only the email portion of the contact information. Žiadne zákonné adresa sa nachádza (nie je už znakom @), takže táto funkcia vráti prázdne.No legal address is found (there is no @ sign), so the function returns blank. prázdna hodnotablank
Match( Language(); "(<language>\w{2})(?:-(?<script>\w{4}))?(?:-(?<region>\w{2}))?" ) Výpisy jazyk, skript a oblasť jej časti jazyka označiť, ktoré jazyk funkcia vráti.Extracts the language, script, and region portions of the language tag that the Language function returns. Tieto výsledky odrážajú v Spojených štátoch; Pozrite si jazyk funkcia dokumentáciu ďalšie príklady.These results reflect the United States; see the Language function documentation for more examples. (?: Operátor skupín znakov bez vytvárania iného čiastkové zhoda.The (?: operator groups characters without creating another sub-match. {{
Language: "en",language: "en",
skript: prázdne,script: blank,
oblasť: "US",region: "US",
FullMatch: "en-US",FullMatch: "en-US",
SubMatches: ["en", "", "US"],SubMatches: [ "en", "", "US" ],
StartMatch: 1StartMatch: 1
}}
Match( "PT2H1M39S"; "PT(?:(<hours>\d+)H)?(?:(?<minutes>\d+)M)?(?:(?<seconds>\d+)S)?" ) Extrahuje hodiny, minúty a sekundy z hodnoty trvania ISO 8601.Extracts the hours, minutes, and seconds from an ISO 8601 duration value. Extrahovaný čísla sú stále v textovom reťazci; použite hodnota môžete konvertovať na číslo, skôr ako matematických operácií na ňu.The extracted numbers are still in a text string; use the Value function to convert it to a number before mathematical operations are performed on it. {{
hours: "2",hours: "2",
Počet minút: "1",minutes: "1",
počet sekúnd: "39",seconds: "39",
FullMatch: "PT2H1M39S",FullMatch: "PT2H1M39S",
SubMatches: [ "2", "1", "39" ],SubMatches: [ "2", "1", "39" ],
StartMatch: 1StartMatch: 1
}}

Poďme prejsť do danej posledný príklad.Let's drill into that last example. Ak ste chceli tento reťazec konvertovať na hodnotu dátumu a času pomocou čas funkciu, musíte prejsť v pomenované čiastkové zodpovedá jednotlivo.If you wanted to convert this string to a date/time value using the Time function, you must pass in the named sub-matches individually. Na tento účel môžete použiť ForAll funkcia pôsobiacich na prvý záznam, ktorý MatchAll vráti:To do this, you can use the ForAll function operating on the first record that MatchAll returns:

First( 
    ForAll( 
        MatchAll( "PT2H1M39S"; "PT(?:(?<hours>\d+)H)?(?:(?<minutes>\d+)M)?(?:(?<seconds>\d+)S)?" ); 
        Time( Value( hours ); Value( minutes ); Value( seconds ) )
    )
).Value

Tieto príklady, pridajte tlačidlo ovládací prvok, nastavte jeho OnSelect nastavte na tento vzorec, a potom vyberte tlačidlo:For these examples, add a Button control, set its OnSelect property to this formula, and then select the button:

Set( pangram; "The quick brown fox jumps over the lazy dog." )
VzorecFormula PopisDescription VýsledokResult
Match( pangram; "THE"; IgnoreCase ) Vyhľadať všetky zhody "" v texte v reťazci, ktoré pangram premenná obsahuje.Find all matches of "THE" in the text string that the pangram variable contains. Reťazec ktorý obsahuje dva zhody, ale preto, že používate, vráti sa iba prvá zhoda a nie MatchAll.The string contains two matches, but only the first is returned because you're using Match and not MatchAll. V stĺpci SubMatches je prázdny, pretože neboli definované žiadne čiastkové zhody.The SubMatches column is empty because no sub-matches were defined. {{
FullMatch: ""FullMatch: "The",
SubMatches: [ ],SubMatches: [ ],
StartMatch: 32StartMatch: 32
}}
MatchAll( pangram; "the" ) Nájdite všetky zhody textu "" v textový reťazec, ktorý pangram premenná obsahuje.Find all matches of "the" in the text string that the pangram variable contains. V teste sa rozlišujú veľké a malé písmená, takže zostane zobrazený iba druhý výskyt "" sa nachádza.The test is case sensitive, so only the second instance of "the" is found. V stĺpci SubMatches je prázdny, pretože neboli definované žiadne čiastkové zhody.The SubMatches column is empty because no sub-matches were defined.
MatchAll( pangram; "the"; IgnoreCase ) Nájdite všetky zhody textu "" v textový reťazec, ktorý pangram premenná obsahuje.Find all matches of "the" in the text string that the pangram variable contains. V tomto prípade teste sa nerozlišujú, takže obe inštancie položky slovo sa nachádzajú.In this case, the test is case insensitive, so both instances of the word are found. V stĺpci SubMatches je prázdny, pretože neboli definované žiadne čiastkové zhody.The SubMatches column is empty because no sub-matches were defined.
MatchAll( pangram; "\b\wo\w\b" ) Vyhľadá všetky skratkám slová s "o" v strede.Finds all three-letter words with an "o" in the middle. Všimnite si, že "brown" je vylúčená, pretože nie je slovo skratkám a preto zlyhá tak, aby zodpovedali "\b" (slovo hranicu).Note that "brown" is excluded because it's not a three-letter word and, therefore, fails to match "\b" (word boundary).
Match( pangram; "\b\wo\w\b\s\*(?<between>\w.+\w)\s\*\b\wo\w\b" ) Skontroluje zhodu s všetky znaky medzi "fox" a "pes".Matches all the characters between "fox" and "dog". {{
medzi: "v oblasti nad  pomalé",between: "jumps over the lazy",
FullMatch: "fox v oblasti nad  pomalé pes",FullMatch: "fox jumps over the lazy dog",
SubMatches: ["skoky cez pomalé"],SubMatches: [ "jumps over the lazy" ],
StartMatch: 17StartMatch: 17
}}

Chcete zobraziť výsledky MatchAll v galérii:To see the results of MatchAll in a gallery:

  1. Prázdna obrazovka, vložte prázdna zvislá galérie ovládacieho prvku.In an empty screen, insert a blank vertical Gallery control.

  2. Vlastnosť galérie položky na hodnotu MatchAll (pangram, "\w+") alebo MatchAll (pangram, MultipleLetters).Set the gallery's Items property to MatchAll( pangram; "\w+" ) or MatchAll( pangram; MultipleLetters ).

  3. Vyberte možnosť "Pridať položku z karty vložiť" v strede ovládací prvok galérie a vyberte šablónu galérie.Select "Add an item from the Insert tab" in the middle of the gallery control to select the template of the gallery.

  4. Pridanie označenie ovládací prvok do šablóny galérie.Add a Label control to the gallery's template.

  5. Nastavte Text na hodnotu ThisItem.FullMatch.Set the label's Text property to ThisItem.FullMatch.

    Galéria je vyplnená každého slova v našom príklade textu.The gallery is filled with each word in our example text. Ak chcete zobraziť všetky slová na jednej obrazovke zmeňte veľkosť šablóny galérie a ovládací prvok označenia.Resize the gallery's template and the label control in order to see all the words on one screen.