Compartilhar via


Criar e atualizar uma coleção em um aplicativo de tela

Use uma coleção para armazenar dados que os usuários podem gerenciar em seu aplicativo. Uma coleção é um grupo de itens semelhantes, como produtos em uma lista de produtos. Para mais informações sobre diferentes tipos de variáveis, como coleções: Noções básicas sobre variáveis de aplicativo de tela.

Pré-requisitos

  • Inscreva-se no Power Apps e depois entre fornecendo as mesmas credenciais que usou para se inscrever.
  • Crie um aplicativo ou abra um aplicativo existente no Power Apps.
  • Saiba como configurar um controle no Power Apps.

Assista a este vídeo para aprender como criar e atualizar uma coleção:

Criar uma coleção de várias colunas

  1. No Power Apps Studio, adicione um controle Entrada de texto.

    Inserir um controle Entrada de texto.

  2. Renomeie o controle selecionando suas reticências no painel de navegação esquerdo, selecionando Renomear e, em seguida, digitando ProductName.

    Renomear um controle.

  3. Adicione um controle Lista suspensa.

    Adicionar lista suspensa.

  4. Renomeie o controle Lista suspensa para Colors e verifique se a propriedade Items está selecionada na lista de propriedades.

    Propriedade Items.

  5. Na barra de fórmulas, substitua DropDownSample por esta expressão:

    ["Red","Green","Blue"]

  6. Adicione um controle Botão, defina sua propriedade Text como "Add" e defina sua propriedade OnSelect como esta fórmula:

    Collect(
        ProductList,
        {
            Product: ProductName.Text,
            Color: Colors.Selected.Value
        }
    )
    
  7. Pressione F5, digite algum texto em ProductName, selecione uma opção em Colors e selecione Add.

    Visualização do aplicativo.

  8. Repita a etapa anterior pelo menos mais duas vezes e pressione Esc.

  9. Se estiver usando a versão preliminar do Power Apps Studio, selecione o painel Variáveis e Coleções para ver as coleções que você criou.

    Mostrar coleções.

    Se estiver usando a versão clássica do Power Apps Studio, no menu Arquivo , selecione Coleções.

    Mostrar coleção.

Mostrar uma coleção

  1. Adicionar um controle Galeria vertical.

    Adicionar uma galeria vertical.

  2. Defina a propriedade Items da galeria como ProductList.

  3. No painel Dados, defina o campo de subtítulo como Color e defina o campo de título como Product.

    Defina a propriedade Items da galeria e altere os campos que ela mostra.

  4. Feche o painel Dados, selecione a galeria e defina o campo Layout como Title and subtitle.

    Alterar o layout da galeria.

    Sua tela deverá ser semelhante a este exemplo:

    Exemplo da primeira tela.

Remover um ou todos os itens

  1. Selecione o modelo de galeria clicando ou tocando próximo à parte inferior da galeria e, depois, clicando ou tocando no ícone de lápis próximo ao canto superior esquerdo.

    Selecionar modelo de galeria.

  2. Adicione um ícone da Lixeira ao modelo da galeria.

    Adicionar ícone da lixeira.

  3. Defina a propriedade OnSelect do ícone como esta fórmula:

    Remove(ProductList, ThisItem)

  4. Fora da galeria, adicione um botão, defina sua propriedade Text como "Clear" e defina sua propriedade OnSelect como esta fórmula:

    Clear(ProductList)

  5. Enquanto pressiona a tecla Alt, selecione o ícone da Lixeira de um item para remover esse item da coleção ou selecione o botão Limpar para remover todos os itens da coleção.

Colocar uma lista em uma coleção

  1. Cria uma conexão a uma lista criada usando Listas da Microsoft.

  2. Adicione um botão e defina sua propriedade OnSelect para essa função, substituindo ListName pelo nome da lista:

    Collect(MySPCollection, ListName)

    Essa função cria uma coleção denominada MySPCollection que contém os mesmos dados do que a lista.

  3. Mantendo a tecla Alt pressionada, selecione o botão.

  4. (opcional) Para visualizar a coleção que você criou, selecione Coleções no menu Arquivo.

Para obter informações de como mostrar dados das Listas da Microsoft ou do SharePoint (por exemplo, datas, opções e pessoas) em uma galeria: Mostrar dados em uma galeria. Para obter informações de como mostrar dados em um formulário (com listas suspensas, seletores de data e seletores de pessoas): Controles Editar formulário e Exibir formulário.

Próximas etapas

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).