Fonctions StartsWith et EndsWith dans PowerAppsEndsWith and StartsWith functions in PowerApps

Permet de tester si une chaîne de texte commence ou se termine par une autre chaîne de texte.Tests whether a text string begins or ends another text string.

DescriptionDescription

La fonction EndsWith teste si une chaîne de texte se termine par une autre.The EndsWith function tests whether one text string ends with another.

La fonction StartsWith teste si une chaîne de texte commence par une autre.The StartsWith function tests whether one text string begins with another.

Pour les deux fonctions, les tests sont insensibles à la casse.For both functions, the tests are case insensitive. Leur valeur de retour est une valeur booléenne true ou false.The return value of both is a Boolean true or false.

Utilisez EndsWith et StartsWith avec la fonction Filter pour rechercher des données au sein de votre application.Use EndsWith and StartsWith with the Filter function to search the data within your app. Vous pouvez également utiliser l’opérateur in ou la fonction Search pour rechercher dans l’intégralité d’une chaîne de texte, et pas uniquement au début ou à la fin.You can also use the in operator or the Search function to look anywhere within text strings, not just at the beginning or end. Votre choix dépend des besoins de votre application et des fonctions pouvant être déléguées pour votre source de données particulière.Your choice of functions will depend on the needs of your app and which function can be delegated for your particular data source. Si l’une de ces fonctions ne peut pas être déléguée, un point bleu apparaît au moment de l’autorisation pour vous informer de cette limitation.If one of these functions can't be delegated, a blue dot will appear at authoring time to warn you of this limitation.

SyntaxeSyntax

EndsWith( Text, EndText )EndsWith( Text, EndText )

  • Text – Requis.Text – Required. Texte à tester.The text to test.
  • EndText – Requis.EndText – Required. Texte à rechercher à la fin de Text.The text to search for at the end of Text. Si EndText est une chaîne vide, EndsWith retourne la valeur true.If EndText is an empty string, EndsWith returns true.

StartsWith( Texte, Texte_début )StartsWith( Text, StartText )

  • Texte – Obligatoire.Text – Required. Texte à tester.The text to test.
  • Texte_début – Obligatoire.StartText – Required. Texte à rechercher au début de Texte.The text to search for at the beginning of Text. Si Texte_début est une chaîne vide, StartsWith renvoie la valeur true.If StartText is an empty string, StartsWith returns true.

ExemplesExamples

FormuleFormula DescriptionDescription RésultatResult
EndsWith( "Hello World", "world" )EndsWith( "Hello World", "world" ) Vérifie si "Hello, World" se termine par "world".Tests whether "Hello World" ends with "world". Le test n’est pas sensible à la casse.The test is case insensitive. truetrue
EndsWith( "Good bye", "good" )EndsWith( "Good bye", "good" ) Vérifie si "Good bye" se termine par "good".Tests whether "Good bye" ends with "good". L’argument EndText ("good") apparaît dans le texte, mais pas à la fin.The EndText argument ("good") appears in the text but not at the end. falsefalse
EndsWith( "Always say hello", "hello" )EndsWith( "Always say hello", "hello" ) Teste si "Always say hello" se termine par "hello".Tests whether "Always say hello" ends with "hello". truetrue
Endswith( "Bye bye", "" )Endswith( "Bye bye", "" ) Teste si "Bye bye" se termine par une chaîne de texte vide (Len retourne la valeur 0).Tests whether "Bye bye" ends with an empty text string (Len returns 0). Pour faciliter son utilisation dans les expressions Filter, EndsWith est défini de façon à retourner true dans ce cas.Easing its use in Filter expressions, EndsWith is defined to return true in this case. truetrue
FormuleFormula DescriptionDescription RésultatResult
StartsWith( "Hello World", "hello" )StartsWith( "Hello World", "hello" ) Teste si "Hello World" commence par "hello".Tests whether "Hello World" begins with "hello". Le test n’est pas sensible à la casse.The test is case insensitive. truetrue
StartsWith( "Good bye", "hello" )StartsWith( "Good bye", "hello" ) Teste si "Good bye" commence par "hello".Tests whether "Good bye" begins with "hello". falsefalse
StartsWith( "Always say hello", "hello" )StartsWith( "Always say hello", "hello" ) Teste si "Always say hello" commence par "hello".Tests whether "Always say hello" begins with "hello". "hello" apparaît bien dans le texte, mais pas au début.Although "hello" appears in the text, it doesn't appear at the beginning. falsefalse
StartsWith( "Bye bye", "" )StartsWith( "Bye bye", "" ) Teste si "Bye bye" commence par une chaîne de texte vide (Len retourne la valeur 0).Tests whether "Bye bye" starts with an empty text string (Len returns 0). Pour faciliter son utilisation dans les expressions Filter, StartsWith est défini de façon à retourner true dans ce cas.Easing its use in Filter expressions, StartsWith is defined to return true in this case. truetrue

Expérience de recherche de l’utilisateurSearch user experience

Dans de nombreuses applications, vous pouvez entrer un ou plusieurs caractères dans une zone de recherche pour filtrer une liste d’enregistrements dans un jeu de données volumineux.In many apps, you can type one or more characters into a search box to filter a list of records in a large data set. Pendant que vous tapez, la liste présente uniquement les enregistrements qui correspondent aux critères de recherche.As you type, the list shows only those records that match the search criteria.

Les autres exemples de cette rubrique présentent les résultats de la recherche d’une liste Clients contenant les données suivantes :The examples in the rest of this topic show the results of searching a Customers list that contains this data:

Pour créer cette source de données en tant que collection, créez un contrôle Bouton et définissez sa propriété OnSelect sur cette formule :To create this data source as a collection, create a Button control and set its OnSelect property to this formula:

ClearCollect( Customers, Table( { Name: "Fred Garcia", Company: "Northwind Traders" }, { Name: "Cole Miller", Company: "Contoso" }, { Name: "Glenda Johnson", Company: "Contoso" }, { Name: "Mike Collins", Company: "Adventure Works" }, { Name: "Colleen Jones", Company: "Adventure Works" } ) )ClearCollect( Customers, Table( { Name: "Fred Garcia", Company: "Northwind Traders" }, { Name: "Cole Miller", Company: "Contoso" }, { Name: "Glenda Johnson", Company: "Contoso" }, { Name: "Mike Collins", Company: "Adventure Works" }, { Name: "Colleen Jones", Company: "Adventure Works" } ) )

Comme dans cet exemple, vous pouvez afficher une liste d’enregistrements dans un contrôle Galerie au bas d’un écran.As in this example, you can show a list of records in a Gallery control at the bottom of a screen. En haut de l’écran, vous pouvez ajouter un contrôle Entrée de texte appelé SearchInput, pour permettre aux utilisateurs d’indiquer les enregistrements qui les intéressent.Near the top of the screen, you can add a Text input control, named SearchInput, so that users can specify which records interest them.

Quand l’utilisateur entre des caractères dans SearchInput, les résultats de la galerie sont automatiquement filtrés.As the user types characters in SearchInput, the results in the gallery are automatically filtered. Dans cet exemple, la galerie est configurée de manière à afficher les enregistrements pour lesquels le nom du client (pas celui de l’entreprise) commence par la séquence de caractères dans SearchInput. Si l’utilisateur tape co dans la zone de recherche, la galerie présente ces résultats :In this case, the gallery is configured to show records for which the name of the customer (not the name of the company) starts with the sequence of characters in SearchInput.If the user types co in the search box, the gallery shows these results:

Pour filtrer en fonction de la colonne Name, définissez la propriété Items du contrôle de galerie sur l’une de ces formules :To filter based on the Name column, set the Items property of the gallery control to one of these formulas:

FormuleFormula DescriptionDescription RésultatResult
Filter( Customers, StartsWith( Name, SearchInput.Text ) )Filter( Customers, StartsWith( Name, SearchInput.Text ) ) Permet de filtrer la source de données Customers pour afficher les enregistrements dans lesquels la chaîne de recherche apparaît au début de la colonne Name.Filters the Customers data source for records in which the search string appears at the start of the Name column. Le test n’est pas sensible à la casse.The test is case insensitive. Si l’utilisateur tape co dans la zone de recherche, la galerie affiche Colleen Jones et Cole Miller.If the user types co in the search box, the gallery shows Colleen Jones and Cole Miller. La galerie n’affiche pas Mike Collins, car la colonne Name de cet enregistrement ne commence pas par la chaîne de recherche.The gallery doesn't show Mike Collins because the Name column for that record doesn't start with the search string.
Filter( Customers, SearchInput.Text in Name )Filter( Customers, SearchInput.Text in Name ) Permet de filtrer la source de données Customers pour afficher les enregistrements dans lesquels la chaîne de recherche apparaît n’importe où dans la colonne Name.Filters the Customers data source for records in which the search string appears anywhere in the Name column. Le test n’est pas sensible à la casse.The test is case insensitive. Si l’utilisateur tape co dans la zone de recherche, la galerie affiche Colleen Jones, Cole Miller et Mike Collins, car la chaîne de recherche apparaît quelque part dans la colonne Name de tous ces enregistrements.If the user types co in the search box, the gallery shows Colleen Jones, Cole Miller, and Mike Collins because the search string appears somewhere in the Name column of all of those records.
Search( Customers, SearchInput.Text, "Name" )Search( Customers, SearchInput.Text, "Name" ) À l’image de l’opérateur in, la fonction Search permet de rechercher une correspondance n’importe où dans la colonne Name de chaque enregistrement.Similar to using the in operator, the Search function searches for a match anywhere within the Name column of each record. Notez que le nom de colonne doit être placé entre guillemets doubles.Note that you must enclose the column name in double quotation marks.

Vous pouvez étendre votre recherche de manière à inclure la colonne Company ainsi que la colonne Name :You can expand your search to include the Company column as well as the Name column:

FormuleFormula DescriptionDescription RésultatResult
Filter( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Company, SearchInput.Text ) )Filter( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Company, SearchInput.Text ) ) Permet de filtrer la source de données Customers pour afficher les enregistrements dans lesquels la colonne Name ou la colonne Company commence par la chaîne de recherche (par exemple, co).Filters the Customers data source for records in which either the Name column or the Company column starts with the search string (for example, co). L’opérateur || a pour valeur true si l’une des fonctions StartsWith a pour valeur true.The || operator is true if either StartsWith function is true.
Filter( Customers, SearchInput.Text in Name || SearchInput.Text in Company )Filter( Customers, SearchInput.Text in Name || SearchInput.Text in Company ) Permet de filtrer la source de données Customers pour afficher les enregistrements dans lesquels la colonne Name ou la colonne Company contient la chaîne de recherche (par exemple, co).Filters the Customers data source for records in which either the Name column or the Company column contains the search string (for example, co) anywhere within it.
Search( Customers, SearchInput.Text, "Name", "Company" )Search( Customers, SearchInput.Text, "Name", "Company" ) À l’image de l’opérateur in, la fonction Search permet de rechercher dans la source de données Customers les enregistrements dans lesquels la colonne Name ou la colonne Company contient la chaîne de recherche (par exemple, co).Similar to using the in operator, the Search function searches the Customers data source for records in which either the Name column or the Company column contains the search string (for example, co) anywhere within it. La fonction Search est plus facile à lire et à écrire que la fonction Filter si vous voulez spécifier plusieurs colonnes et plusieurs opérateurs in.The Search function is easier to read and write than Filter if you want to specify multiple columns and multiple in operators. Notez que le nom des colonnes doit être placé entre guillemets doubles.Note that you must enclose the names of the columns in double quotation marks.