Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Reinicializa os elementos de matrizes de tamanho fixo e libera o espaço de armazenamento de matriz dinâmica.
Sintaxe
Apagarlista de matrizes
O argumento da lista de matrizes necessário é uma ou mais variáveis de matriz delimitadas por vírgula a serem apagadas.
Comentários
Apagar se comporta de forma diferente dependendo se uma matriz é de tamanho fixo (comum) ou dinâmica. Apagar não recupera memória para matrizes de tamanho fixo. Apagar define os elementos de uma matriz fixa da seguinte maneira:
| Tipo de matriz | Efeito de Apagar em elementos de matriz fixa |
|---|---|
| Matriz numérica fixa | Define cada elemento como zero. |
| Matriz de cadeia de caracteres fixa (comprimento variável) | Define cada elemento como uma cadeia de comprimento zero (""). |
| Matriz de cadeia de caracteres fixa (comprimento fixo) | Define cada elemento como zero. |
| Matriz de variante fixa | Define cada elemento como Vazio. |
| Matriz de tipos definidos pelo usuário | Define cada elemento como se fosse uma variável separada. |
| Matriz de objetos | Define cada elemento com o valor especial Nothing. |
Apagar libera a memória usada por matrizes dinâmicas. Antes que o programa possa se referir à matriz dinâmica novamente, ele deve redeclarar as dimensões da variável de matriz usando uma instrução ReDim .
Exemplo
Este exemplo usa a instrução Erase para reinicializar os elementos de matrizes de tamanho fixo e desalocar o espaço de armazenamento de matriz dinâmica.
' Declare array variables.
Dim NumArray(10) As Integer ' Integer array.
Dim StrVarArray(10) As String ' Variable-string array.
Dim StrFixArray(10) As String * 10 ' Fixed-string array.
Dim VarArray(10) As Variant ' Variant array.
Dim DynamicArray() As Integer ' Dynamic array.
ReDim DynamicArray(10) ' Allocate storage space.
Erase NumArray ' Each element set to 0.
Erase StrVarArray ' Each element set to zero-length
' string ("").
Erase StrFixArray ' Each element set to 0.
Erase VarArray ' Each element set to Empty.
Erase DynamicArray ' Free memory used by array.
Confira também
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.