LOAD SET
LOAD SET ( {tabela ;} conjunto ; documento )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| tabela | Table | → | Tabela à qual o conjunto pertence, ou tabela padrão, se omitido |
| conjunto | Text | → | Nome do conjunto a ser criado em memória |
| documento | Text | → | Documento que contém o conjunto |
Descrição
LOAD SET carrega um conjunto desde o arquivo documento, criado com o comando SAVE SET.
O conjunto guardado em documento deve aplicar a tabela. O conjunto criado em memória é reescrito se já existir.
O parâmetro documento é o nome do documento disco que contém o conjunto. O documento não necessita ter o mesmo nome do conjunto. Se passa uma cadeia vazia em documento, se mostra uma caixa de diálogo padrão de Abertura de arquivos, permitindo ao usuário escolher o conjunto a carregar.
Lembre que um conjunto é uma reapresentação de uma seleção de registros no momento em que o conjunto é criado. Se os registros representados pelo conjunto mudam, o conjunto poderia ficar inválido. Portanto, um conjunto carregado desde um disco deve representar a um grupo de registros que não muda frequentemente. Várias coisas podem tornar um conjunto inválido: modificação ou eliminação de um registro do conjunto, ou modificação dos critérios que determinam a criação do conjunto.
Exemplo
O exemplo abaixo utiliza LOAD SET para carregar um conjunto de sedes da empresa Acme em Nova Iorque:
LOAD SET([Empresas];"NY Acme";"NYAcmeSt") // Carregar o conjunto em memória
USE SET("NY Acme") // Mudar a seleção atual a NY Acme
CLEAR SET("NY Acme") // Apagar o conjunto da memória
Variáveis e conjuntos do sistema
Se o usuário clicar em Cancelar na caixa de diálogo de abrir arquivos, ou se for produzido um erro durante o carregamento, a variável sistema OK assume o valor 0. Do contrário, assume o valor 1.