Operadores e tipos de dados no PowerAppsOperators and data types in PowerApps

Alguns desses operadores dependem do idioma do autor.Some of these operators are dependent on the language of the author. Consulte Aplicativos globais para obter mais informações.See Global apps for more information.

SímboloSymbol TipoType SintaxeSyntax DescriçãoDescription
.. Seletor de propriedadeProperty Selector Slider1.Value
Color.Red
Acceleration.X
Slider1.Value
Color.Red
Acceleration.X
Extrai uma propriedade de uma tabela, controle, sinal ou de enumeração.Extracts a property from a table, control, signal, or enumeration. Para compatibilidade com versões anteriores, !For backwards compatibility, ! também pode ser usado.may also be used.
..
[ou , dependendo do idioma][or , depending on the language]
Separador decimalDecimal separator 1,231.23
[ou 1.23 dependendo do idioma][or 1,23 depending on the language]
Separador entre inteiro e frações de um número.Separator between whole and fractional parts of a number. O caractere depende do idioma.The character is dependent on the language.
( )( ) ParêntesesParentheses Filter(T, A < 10)Filter(T, A < 10)

(1 + 2) * 3(1 + 2) * 3
Impõe a ordem de precedência e agrupa subexpressões em uma expressão maiorEnforces precedence order, and groups sub-expressions in a larger expression
+ Operadores aritméticosArithmetic operators 1 + 21 + 2 AdiçãoAddition
-   2 – 12 - 1 Subtração e sinalSubtraction and sign
\*   2 * 32 * 3 MultiplicaçãoMultiplication
/   2 / 32 / 3 Divisão (consulte também a função Mod)Division (also see the Mod function)
^   2 ^ 32 ^ 3 Exponenciação, equivalente à função PowerExponentiation, equivalent to the Power function
%   20%20% Percentual (equivalente a "* 1/100")Percentage (equivalent to "* 1/100")
= Operadores de comparaçãoComparison operators Preço = 100Price = 100 Igual aEqual to
>   Preço > 100Price > 100 Maior queGreater than
>=   Preço >= 100Price >= 100 Maior ou igual aGreater than or equal to
<   Preço < 100Price < 100 Menor queLess than
<=   Preço <= 100Price <= 100 Menor ou igual aLess than or equal to
<>   Preço <> 100Price <> 100 Não igual aNot equal to
& Operador de concatenação de cadeia de caracteresString concatenation operator "hello" & " " & "world""hello" & " " & "world" Faz com que várias cadeias de caracteres apareçam contínuasMakes multiple strings appear continuous
&& ou And&& or And Operadores lógicosLogical operators Preço < 100 && Slider1.Value = 20Price < 100 && Slider1.Value = 20
ou Price < 100 And Slider1.Value = 20or Price < 100 And Slider1.Value = 20
Conjunção lógica equivalente à função AndLogical conjunction, equivalent to the And function
|| ou Or|| or Or   Price < 100 || Slider1.Value = 20 ou Price < 100 Or Slider1.Value = 20Price < 100 || Slider1.Value = 20 or Price < 100 Or Slider1.Value = 20 Disjunção lógica, equivalente à função OrLogical disjunction, equivalent to the Or function
!! ou Notor Not   !(Price < 100) ou Not (Price < 100)!(Price < 100) or Not (Price < 100) Negação lógica, equivalente à função NotLogical negation, equivalent to the Not function
exactinexactin Operadores de associaçãoMembership operators Gallery1.Selected exactin SavedItemsGallery1.Selected exactin SavedItems Pertencente a uma coleção ou a uma tabelaBelonging to a collection or a table
exactinexactin   "Windows" exactin "Para exibir janelas no sistema operacional Windows...""Windows" exactin “To display windows in the Windows operating system...” Teste de subcadeia de caracteres (diferencia maiúsculas de minúsculas)Substring test (case-sensitive)
inin   Gallery1.Selected in SavedItemsGallery1.Selected in SavedItems Pertencente a uma coleção ou a uma tabelaBelonging to a collection or a table
inin   "O" em "O teclado e o monitor...""The" in "The keyboard and the monitor..." Teste de subcadeia de caracteres (não diferencia maiúsculas de minúsculas)Substring test (case-insensitive)
@ Operador de desambiguidadeDisambiguation operator MyTable[@fieldname]MyTable[@fieldname] Desambiguidade de campoField disambiguation
@   [@MyVariable][@MyVariable] Desambiguidade globalGlobal disambiguation
,,
[ou ; dependendo do idioma][or ; depending on the language]
Separador de listaList separator If( X < 10, "Baixo", "Bom" )If( X < 10, "Low", "Good" )
{ X: 12, Y: 32 }{ X: 12, Y: 32 }
[ 1, 2, 3 ][ 1, 2, 3 ]
[ou If( X < 10; "Baixo"; "Bom" )
{ FirstName: "Jane"; LastName: "Doe" }
[ 1; 2; 3 ]
]
[or If( X < 10; "Low"; "Good" )
{ FirstName: "Jane"; LastName: "Doe" }
[ 1; 2; 3 ]
]
Separa:Separates: .. Este caractere depende do idioma.This characters is dependent on the language.
;;
[ou ;; dependendo do idioma][or ;; depending on the language]
Encadeamento de fórmulaFormula chaining Collect(T, A); Navigate(S1, "")Collect(T, A); Navigate(S1, "")
[ou Collect(T; A);; Navigate(S1; "")][or Collect(T; A);; Navigate(S1; "")]
Separa invocações de funções em propriedades de comportamento.Separate invocations of functions in behavior properties. O caractere de encadeamento depende do idioma.The chaining operator is dependent on the language.
PaiParent Operador paiParent operator Parent.FillParent.Fill Acesso a propriedades de um contêiner de controleAccess to properties of a control container
ThisItemThisItem Operador ThisItemThisItem operator ThisItem.FirstNameThisItem.FirstName Acesso a campos de uma Galeria ou controle de formulárioAccess to fields of a Gallery or form control

operadores in e exactinin and exactin operators

É possível usar os operadores in e exactin para localizar uma cadeia de caracteres em uma fonte de dados, como uma coleção ou uma tabela importada.You can use the in and exactin operators to find a string in a data source, such as a collection or an imported table. O operador in identificará correspondências independentemente de letras maiúsculas e minúsculas e o operador exactin identificará correspondências somente se as letras maiúsculas e minúsculas forem usadas da mesma maneira.The in operator identifies matches regardless of case, and the exactin operator identifies matches only if they're capitalized the same way. Aqui está um exemplo:Here's an example:

  1. Crie ou importe uma coleção denominada Inventário e mostre-a em uma galeria, como o primeiro procedimento em Mostrar imagens e texto em uma galeria descreve.Create or import a collection named Inventory, and show it in a gallery, as the first procedure in Show images and text in a gallery describes.
  2. Defina a propriedade Itens da galeria como esta fórmula:Set the Items property of the gallery to this formula:
    Filter(Inventory, "E" in ProductName)Filter(Inventory, "E" in ProductName)

    A galeria mostra todos os produtos, exceto Calisto, porque o nome do produto é o único que não contém a letra especificada.The gallery shows all products except Callisto because the name of that product is the only one that doesn't contain the letter you specified.

  3. Altere a propriedade Itens da galeria para esta fórmula:Change the Items property of the gallery to this formula:
    Filter(Inventory, "E" exactin ProductName)Filter(Inventory, "E" exactin ProductName)

    A galeria mostra apenas Europa, porque apenas seu nome contém a letra especificada no caso especificado.The gallery shows only Europa because only its name contains the letter that you specified in the case that you specified.

Operador ThisItemThisItem operator

É possível mostrar dados nos controles Galeria, Editar formulário ou Exibir formulário associando-os a uma tabela ou a uma coleção.You can show data in Gallery, Edit form, or Display form controls by binding it to a table or a collection. Esses controles são um contêiner para outros controles e cartões.These controls are a container for other cards and controls. Cada cartão ou controle dentro do contêiner pode acessar os dados associados por meio do operador ThisItem.Each card or control within the container can access the bound data through the ThisItem operator.

Use o operador ThisItem para especificar a coluna de dados que cada cartão ou controle dentro do controle externo.You use the ThisItem operator to specify the column of data that each card or control within the outer control. Por exemplo, esse operador na galeria de produto para Mostrar imagens e texto em uma galeria especificou que o controle de imagem mostrou o design do produto, o rótulo superior mostrou o nome do produto e o rótulo inferior mostrou o número de unidades no estoque.For example, that operator in the product gallery for Show images and text in a gallery specified that the image control showed the product design, the upper label showed the product name, and the lower label showed the number of units in stock.

Para galerias aninhadas, ThisItem refere-se aos itens da galeria mais interna.For nested galleries, ThisItem refers to the innermost gallery's items. Supondo que os campos de linha nas galerias internas e externas não entram em conflito, também é possível usar os nomes (de coluna) de campos não qualificados diretamente.Assuming the row fields in the inner and outer galleries don't conflict, you can also use the unqualified field (column) names directly. Essa abordagem permite que as regras em uma galeria interna se refiram aos itens de uma galeria externa.This approach enables rules in an inner gallery to refer to an outer gallery's items.

Operador paiParent operator

Alguns controles hospedam outros controles.Some controls host other controls. Por exemplo, os controles Tela, Galeria, Cartão, Editar formulário e Exibir formulário são todos contêineres para controles.For example, Screen, Gallery, Card, Edit form, and Display form controls are all containers for controls. Chamamos o controle de hospedagem de "pai" dos controles dentro dele.We call the hosting control the "parent" of the controls within.

Qualquer controle no PowerApps pode ser referenciado por nome de qualquer lugar dentro do aplicativo.Any control in PowerApps can be referenced by name from anywhere within the app. Screen1 pode ser o nome de uma tela em seu aplicativo.Screen1 may be the name of a screen in your app. Para recuperar a cor da tela de fundo, é possível usar Screen1.Fill.To retrieve the background color of this screen, you can use Screen1.Fill.

Os controles nessa tela têm outra opção.Controls on this screen have another option. Eles podem usar uma referência relativa: Parent.Fill.They can use a relative reference: Parent.Fill. O operador Pai refere-se ao controle que hospeda esse controle, disponibilizando todas as suas propriedades.The Parent operator refers to the control that hosts this control, making available all of its properties. Usar Pai é útil, porque ele não depende do nome do controle.Using Parent is helpful because it doesn't depend on the name of the control. É possível copiar e colar um controle de contêiner sem precisar ajustar todas as referências dentro do contêiner.You can copy and paste a container control without needing to adjust any references within the container. Esse operador também torna a relação entre controles filho e pai mais clara ao ler fórmulas.This operator also makes the relationship between child and parent controls clearer when reading formulas.

Operador de desambiguidadeDisambiguation operator

Algumas funções criam escopos de registro para acessar os campos de tabela durante o processamento de cada registro, como Filtrar, AdicionarColunas e Somar.Some functions create record scopes for accessing the fields of table while processing each record, such as Filter, AddColumns, and Sum. Os nomes de campo adicionados com o escopo de registro substituem os mesmos nomes de outro lugar no aplicativo.Field names added with the record scope override the same names from elsewhere in the app. Quando isso acontece, ainda é possível acessar os valores de fora do escopo de registro com o operador de desambiguidade @:When this happens, you can still access values from outside the record scope with the @ disambiguation operator:

  • Para acessar valores de escopos de registro aninhados, use o operador @ com o nome da tabela que está sendo operada usando o padrão Tabela[@FieldName].To access values from nested record scopes, use the @ operator with the name of the table being operated upon using the pattern Table[@FieldName].
  • Para acessar valores globais, como fontes de dados, coleções e variáveis de contexto, use o padrão [@ObjectName] (sem uma designação de tabela).To access global values, such as data sources, collections, and context variables, use the pattern [@ObjectName] (without a table designation).

Para obter mais informações e exemplos, consulte a discussão sobre escopos de registro.For more information and examples, see the discussion on record scopes.