Compartilhar via

Apagar instrução

  • Artigo

Reinitializa os elementos de matrizes de tamanho fixo e libera espaço de armazenamento de matriz dinâmica.

Sintaxe

Lista de matrizes de apagamento

O argumentoarraylist necessário é uma ou mais variáveis de matriz delimitadas por vírgula a serem apagadas.

Comentários

O apagamento se comporta de forma diferente dependendo se uma matriz é de tamanho fixo (comum) ou dinâmica. O apagamento não recupera nenhuma 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 de variável) Define cada elemento como uma cadeia de caracteres de comprimento zero ("").
Matriz de cadeia de caracteres fixa (comprimento fixo) Define cada elemento como zero.
Matriz Variant 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 como o valor especial Nothing.

Apagar libera a memória usada por matrizes dinâmicas. Antes que seu programa possa se referir à matriz dinâmica novamente, ele deve redeclare as dimensões da variável de matriz usando uma instrução ReDim .

Exemplo

Este exemplo usa a instrução Apagar para reinitializar 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.