Carregador de vários arquivos

Você pode selecionar e carregar vários arquivos usando o controle Carregador de vários arquivos , que define o valor como uma lista IResource .

Observação:

Public Apps não oferecem suporte ao controle Carregador de vários arquivos .

Trabalhando com o IResource

Se você obter um arquivo como um ILocalResource, ele será convertido automaticamente em um IResource usando:

JobAttachment.fromResource(file) // file is an ILocalResource

Importante:

As seguintes funções foram descontinuadas e você não deve mais usá-las:

• .toLocalResource
• .toAppsFile

Geral

• Tamanho máximo do arquivo — o tamanho máximo do arquivo de cada arquivo que você pode carregar. O tamanho de arquivo máximo recomendado é de 10 MB.

  Observação:

  É possível carregar no máximo 10 arquivos.

• Tipos de arquivos permitidos — os tipos de arquivos que você pode carregar. Use uma vírgula , para separar extensões de arquivos. Por exemplo, se você escrever .jpg, .png, .svg, poderá carregar apenas esses tipos de arquivos. O símbolo de ponto . não é obrigatório ao se listar os tipos de arquivos.

• Texto de ajuda — o texto de ajuda a ser exibido no tempo de execução.

• Dica de ferramenta — o texto a ser exibido quando um usuário de aplicativo passa o mouse sobre o controle. Use a dica para fornecer informações adicionais sobre o controle.

• Rótulo — o texto de exibição do controle.

• Obrigatório — se definido como verdadeiro, os usuários de aplicativos devem fornecer dados no controle. Para marcar o controle como obrigatório no tempo de execução, um asterisco (*) é adicionado após o texto do rótulo.

• Mensagem de erro personalizada - o texto a ser exibido se a propriedade Obrigatório estiver definida como verdadeira e o controle for deixado vazio.

• Oculto — Se definido como verdadeiro, oculta o controle no tempo de execução.

Events

• Valor Alterado — configure o que deve acontecer quando um arquivo é adicionado ou removido da seleção.

Estilo

• Alinhamento de controle — Por padrão, herda o alinhamento parent. É possível definir outro alinhamento que não o pai. Para voltar ao alinhamento padrão pai, desmarque as opções substituídas.

Observação:

O alinhamento depende do layout selecionado para o pai, como Vertical ou Horizontal.

• Posicionamento do rótulo — por padrão, o rótulo é exibido na parte superior do controle, alinhado à esquerda. Você pode colocá-lo à esquerda do controle na mesma linha. A propriedade Largura do rótulo configura a largura do rótulo e a propriedade Espaço entre define a distância entre o rótulo e o controle.
• Fonte — os atributos de fonte para o texto do rótulo e da entrada, como família de fontes, tamanho, cor ou estilo, como negrito, itálico e sublinhado. Por padrão, o controle herda a família de fontes do contêiner pai imediato, indicado pela palavra-chave Herdada.
• Margem — a margem do controle. Por padrão, uma margem de 4px é definida. As propriedades Top/Bottom e Left/Right são combinadas. Essas propriedades podem ser desanexadas usando o botão Link no lado direito da seção Margem .
• Tamanho — a largura e a altura do controle. Por padrão, o tamanho é definido como auto. Para definir valores mínimos ou máximos, selecione o ícone de três pontos (...).

Propriedades VB

Propriedade do VB	Tipo de dados	Description
Tooltip	String	Texto informativo que aparece quando o usuário passa o mouse sobre o Carregador de arquivos.
Label	String	O rótulo do Carregador de arquivo, normalmente o texto exibido precedendo o controle.
Value	IResource	Nome do arquivo carregado atualmente.
Required	Booleano	Especifica se o upload do arquivo é obrigatório.
RequiredErrorMessage	String	Mensagem exibida quando o upload do arquivo é necessário, mas não foi fornecido.
Hidden	Booleano	Determina a visibilidade do controle Carregador de arquivos . Se definido como verdadeiro, oculta o controle no tempo de execução.
Disabled	Booleano	Determina se é possível interagir com o controle Carregador de arquivos . Se definido como verdadeiro, desabilita a interação com o Carregador de arquivos no runtime.
IsValid	Booleano	Verifica a validade do valor do Carregador de arquivo . Se for verdadeiro, indica que é válido.

Uso do Carregador de arquivos

Este exemplo mostra como é possível usar a atividade Multi File Uploader com um bucket de armazenamento:

1. Abra um aplicativo existente ou crie um.

• Adicione um controle Carregador de vários arquivos .
• Selecione Eventos. Em Valor Alterado, selecione Definir automação.

2. Adicione uma atividade For Each que itera sobre a seleção de arquivos.
   • Você pode usar a expressão Controls.MainPage.MultiFileUploader.Value.
   • Adicione uma atividade Upload Storage File em For Each.
     • Especifique o caminho da pasta do Orchestrator e o nome do compartimento de armazenamento.
     • No campo Arquivo , selecione a expressão currentIResource.
     • No campo Onde carregar , selecione a expressão currentIResource.FullName.
3. Teste ou execute seu aplicativo.

Quando você executa o aplicativo e adiciona vários arquivos no Carregador de vários arquivos, o aplicativo carrega o arquivo de armazenamento para o bucket de armazenamento.