Share via

EndsWith e StartsWith funcións

  • Artigo

Aplícase a: Aplicacións de lona Desktop flúe Dataverse columnas de fórmula Aplicacións impulsadas Power Platform por Modelo CLI

Comproba se unha cadea de texto comeza ou remata outra cadea de texto.

Descripción

A función EndsWith comproba se unha cadea de texto remata con outra.

A función StartsWith comproba se unha cadea de texto comeza con outra.

En ambas as funcións, as probas non diferezan entre maiúsculas e minúsculas. O valor devolto de ambas é un booleano verdadeiro ou falso.

Use EndsWith e StartsWith coa función Filter para buscar os datos na súa aplicación. Tamén pode usar o operador in ou a función Search parar mirar en calquera lugar dentro das cadeas de texto, non só ao comezo ou ao final. A súa elección de funcións dependerá das necesidades da súa aplicación e de que función pode ser delegadapara a súa orixe de datos particular. Se non se pode delegar unha destas funcións, aparecerá un aviso sobre a delegación no momento da autorización para avisarlle desta limitación.

Sintaxe

EndsWith( Text, EndText )

  • Text – Obrigatorio. O texto para comprobar.
  • EndText – Obrigatorio. O texto que hai que buscar ao final do Texto. Se EndText é unha cadea baleira, EndsWith devolve verdadeiro.

StartsWith( Text, StartText )

  • Text – Obrigatorio. O texto para comprobar.
  • StartText – Obrigatorio. O texto que hai que buscar ao comezo do Texto. Se StartText é unha cadea baleira, StartsWith devolve verdadeiro.

Exemplos

Fórmula Descripción Resultado
EndsWith( "Hello World", "world" ) Comproba se "Hello World" remata en "world". A proba non diferenza entre maiúsculas e minúsculas. true
EndsWith( "Good bye", "good" ) Conproba se "Good bye" remata en "good". O argumento de EndText ("good") aparece no texto pero non ao final. false
EndsWith( "Always say hello", "hello" ) Comproba se "Always say hello" remata en "hello". true
EndsWith( "Bye bye", "" ) Proba se "Bye bye" remata nunha cadea de texto baleira (Len devolve 0). Facilitando o seu uso en expresións de Filtro, EndsWith está definido para devolver verdadeiro neste caso. true
Fórmula Descripción Resultado
StartsWith( "Hello World", "hello" ) Comproba se "Hello World" comeza por "hello". A proba non diferenza entre maiúsculas e minúsculas. true
StartsWith( "Good bye", "hello" ) Comproba se "Good bye" comeza por "hello". false
StartsWith( "Always say hello", "hello" ) Comproba se "Always say hello" comeza por "hello". Aínda que "hello" aparece no texto, non aparece ao principio. false
StartsWith( "Bye bye", "" ) Proba se "Bye bye" comeza cunha cadea de texto baleira (Len devolve 0). Facilitando o seu uso en expresións de Filtro, StartsWith está definido para devolver verdadeiro neste caso. true

Experiencia de busca do usuario

En moitas aplicacións, pode escribir un ou varios caracteres nunha caixa de busca para filtrar unha lista de rexistros nun gran conxunto de datos. Ao escribir, a lista só mostra os rexistros que coinciden cos criterios de busca.

Os exemplos do resto deste tema mostran os resultados da busca dunha lista de Clientes que contén estes datos:

Exemplo de lista de Clientes.

Para crear esta orixe de datos como unha colección, cree un control de Botón e configure a súa propiedade OnSelect nesta fórmula:

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" }) )

Como neste exemplo, pode mostrar unha lista de rexistros nun control de galería na parte inferior dunha pantalla. Cerca da parte superior da pantalla, pode engadir un control de Entrada de texto, nomeado SearchInput, para que os usuarios poidan especificar que rexistros lles interesan.

Galería de clientes.

A medida que o usuario escribe caracteres en SearchInput, os resultados da galería fíltranse automaticamente. Neste caso, a galería está configurada para mostrar rexistros para os que o nome do cliente (non o nome da empresa) comeza coa secuencia de caracteres en SearchInput. Se o usuario escribe co na caixa de busca, a galería amosa estes resultados:

Galería de clientes con busca.

Para filtrar pola columna Name, estableza a propiedade Elementos do control de galería nunha destas fórmulas:

Fórmula Descripción Resultado
Filter( Customers, StartsWith( Name, SearchInput.Text ) ) Filtra a orixe de datos Customers polos rexistros nos que aparece a cadea de busca ao comezo da columna Name. A proba non diferenza entre maiúsculas e minúsculas. Se o usuario escribe co na caixa de busca, a galería mostra Colleen Jones e Cole Miller. A galería non mostra Mike Collins porque a columna Name para ese rexistro non comeza coa cadea de busca. Exemplo de StartsWith.
Filter( Customers, SearchInput.Text in Name ) Filtra a orixe de datos Customers polos rexistros nos que aparece a cadea de busca en calquera lugar da columna Name. A proba non diferenza entre maiúsculas e minúsculas. Se o usuario escribe co na caixa de busca, a galería mostra Colleen JonesCole Miller, e Mike Collins porque a cadea de busca aparece nalgún lugar da columna Name de todos eses rexistros. Exemplo de SearchInput.Text en Name.
Search( Customers, SearchInput.Text, "Name" ) Semellante ao uso do operador in, a función Search busca unha coincidencia en calquera parte da columna Name de cada rexistro. Teña en conta que debe incluír o nome da columna entre comiñas dobres. Exemplo de SearchInput.Text con Name.

Pode ampliar a súa busca para incluír a columna Company así como a columna Name:

Fórmula Descripción Resultado
Filter(Customers, StartsWith(Name, SearchInput.Text) || StartsWith(Company, SearchInput.Text) ) Filtra a orixe de datos Customers polos rexistros nos cales a columnaName ou a columna Company comeza coa cadea de busca (por exemplo, co). O || operador é true se a función StartsWith é true. Filtrar con StartsWith.
Filter(Customers, SearchInput.Text in Name || SearchInput. Text in Company) Filtra a orixe de datos Customers polos rexistros nos cales a columnaName ou a columna Company contén a cadea de busca (por exemplo, co) en calquera parte. Filtrar con texto de busca no nome.
Search( Customers, SearchInput.Text, "Name", "Company" ) Similar ao uso do operador in, a función Search busca na orixe de datos Customers os rexistros nos cales a columna Name ou a columna Company contén a cadea de busca (por exemplo, co) en calquera parte. A función Search é máis fácil de ler e escribir que Filter se desexa especificar varias columnas e varios operadores in. Teña en conta que debe incluír os nomes das columnas entre comiñas dobres. Filtrar con texto de busca no nome, empresa.