Compartir por

Funcións EndsWith e StartsWith

  • Artigo

Aplícase a: Aplicacións de lenzo Fluxos de escritorio Dataverse columnas de fórmulas Aplicacións baseadas en modelos Power Pages Power Platform 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( Texto, EndText )

  • Texto – 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.

Comeza con( Texto, Texto de inicio )

  • Texto – 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("Ola mundo", "mundo") Comproba se "Hello World" remata en "world". A proba non diferenza entre maiúsculas e minúsculas. verdade
EndsWith( "Adeus", "bo" ) Conproba se "Good bye" remata en "good". O argumento de EndText ("good") aparece no texto pero non ao final. falso
EndsWith( "Saluar sempre", "ola" ) Comproba se "Always say hello" remata en "hello". verdade
EndsWith( "Adeus", "" ) 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. verdade
Fórmula Descripción Resultado
StartsWith("Ola mundo", "ola" ) Comproba se "Hello World" comeza por "hello". A proba non diferenza entre maiúsculas e minúsculas. verdade
StartsWith( "Adeus", "ola" ) Comproba se "Good bye" comeza por "hello". falso
StartsWith( "Saluar sempre", "ola" ) Comproba se "Always say hello" comeza por "hello". Aínda que "hello" aparece no texto, non aparece ao principio. falso
StartsWith( "Adeus", "" ) 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. verdade

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( Clientes, táboa( { Nome: "Fred Garcia", Empresa: "Northwind Traders" }, { Nome: "Cole Miller", Empresa: "Contoso" }, { Nome: "Glenda Johnson", Empresa: "Contoso" }, { Nome: "Mike Collins ", Empresa: "Adventure Works" }, { Nome: "Colleen Jones", Empresa: "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
Filtro (Clientes, StartsWith(Nome, 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.
Filtro (clientes, 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.
Busca (Clientes, SearchInput.Text, "Nome") 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
Filtro (Clientes, StartsWith(Nome, SearchInput.Text) || StartsWith(Compañía, 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.
Filtro (Clientes, SearchInput.Text no nome || SearchInput.Text na empresa) 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.
Busca (Clientes, SearchInput.Text, "Nome", "Empresa") 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.