Compartilhar via


ReDim instrução (Visual Basic)

Realoca espaço de armazenamento para uma variável de matriz.

ReDim [ Preserve ] name(boundlist) [ , name(boundlist) [, ... ] ]

Partes

Termo

Definição

Preserve

Opcional.Modificador usado para preservar os dados na matriz existente quando você alterar o tamanho de dimensão apenas a última vez.

name

Obrigatório.Nome de variável de matriz.Consulte Nomes de elementos declarados (Visual Basic).

boundlist

Obrigatório.Lista dos limites de cada dimensão de matriz redefinido.

Comentários

Você pode usar a instrução de ReDim para alterar o tamanho de uma ou mais dimensões de um array que já.Se você tiver uma matriz grande e não precisa de alguns dos seus elementos, ReDim pode liberar mais memória reduzindo o tamanho da matriz.Por outro lado, se sua matriz precisa mais elementos, ReDim pode adicioná-los.

A declaração de ReDim destina-se somente para matrizes.Não é válido em escalares (variáveis contendo apenas um único valor), em coleções, ou estruturas.Observe que se você declara uma variável para ser do tipo Array, a instrução de ReDim não tem a suficiente informações de tipo para criar a nova matriz.

Você pode usar ReDim somente em nível de procedimento.Como consequência, o contexto da declaração da variável deve ser um procedimento; não pode ser um arquivo fonte, namespace, interface, classe, estrutura, módulo, procedimento ou bloco.Para obter mais informações, consulte Níveis de acesso padrão (Visual Basic) e os contextos de declaração.

Regras.

  • Diversas variáveis. Você pode redimensionar diversas variáveis de matriz na mesma instrução de declaração e especificar as partes de name e de boundlist para cada variável.Diversas variáveis são separadas por vírgulas.

  • Limites da matriz. Cada entrada em boundlist pode especificar os limites inferior e superior dessa dimensão.O limite inferior é sempre 0 (zero).O limite superior é o valor de índice mais alto possível para a dimensão, não o comprimento da dimensão (que é o limite superior mais um).O índice para cada dimensão pode variar de 0 até o valor de limite superior.

    O número de dimensões em boundlist deve corresponder ao original (número de dimensões) classificação da matriz.

  • Tipos de dados. A declaração de ReDim não pode alterar o tipo de dados de uma variável de matriz ou seus elementos.

  • Inicialização. A declaração de ReDim não pode fornecer novos valores de inicialização para elementos da matriz.

  • Classificação. A declaração de ReDim não pode alterar a ordem (número de dimensões) da matriz.

  • Redimensionar com preserve. Se você usar Preserve, você pode redimensionar somente à última dimensão da matriz.Para cada dimensão outra, você deve especificar o limite de matriz existente.

    Por exemplo, se seu array tem apenas uma dimensão, você pode redimensionar a dimensão e ainda preservar o conteúdo da matriz, porque você está alterando o último e somente a dimensão.No entanto, se o seu array tem dois ou mais dimensões, você pode alterar o tamanho de dimensão apenas a última se você usar Preserve.

  • Propriedades. Você pode usar ReDim em uma propriedade que contém uma matriz de valores.

Comportamento

  • **Substituição de matriz.**ReDim libera a matriz existente e cria um novo array com a mesma ordem.A nova matriz liberada substitui a matriz na variável de matriz.

  • Inicialização sem preserve. Se você não especificar Preserve, ReDim inicializa todos os elementos da nova matriz usando o valor padrão para seu tipo de dados.

  • Inicialização com preserve. Se você especificar PreserveVisual Basic, copiar os elementos da matriz existente para a nova matriz.

Exemplo

O exemplo aumentar o tamanho da última dimensão de uma matriz dinâmica sem perder os dados existentes na matriz, e reduz o tamanho com perda de dados parcial.Finalmente, diminui o tamanho de volta para o valor original e reinicializa todos os elementos da matriz.

Dim intArray(10, 10, 10) As Integer
ReDim Preserve intArray(10, 10, 20)
ReDim Preserve intArray(10, 10, 15)
ReDim intArray(10, 10, 10)

A declaração de Dim cria um novo array com três dimensões.Cada dimensão é declarada com um limite de 10, então o índice de matriz para cada dimensão pode variar de 0 a 10.Na discussão, as três dimensões são chamadas da camada, linha, e a coluna.

Primeiro ReDim cria uma nova matriz que substitui a matriz existente em intArrayvariável.ReDim copia todos os elementos da matriz existente na nova matriz.Ele também adiciona 10 mais colunas ao final de cada linha em cada camada e inicializa todos os elementos nessas novas linhas em 0 (o valor padrão de Integer, que é o tipo da matriz).

Dependendo de ReDim cria outra nova matriz e copia todos os elementos que ajustaram.No entanto, cinco colunas são perdidas no final de cada linha em cada nível.Isso não é um problema se você tiver terminado de usar essas colunas.Reduzir o tamanho de uma matriz grande pode liberar mais memória que você não precisa.

Terceiro ReDim cria outra nova matriz e remove outras cinco colunas do final de cada linha em cada nível.Desta vez não copiar elementos existentes.Essa instrução retorna a matriz ao seu tamanho original.Porque a declaração não inclui o modificador de Preserve , defina todos os elementos da matriz para seus valores padrão originais.

Para exemplos adicionais, consulte Matrizes em Visual Basic.

Consulte também

Referência

Instrução const (Visual Basic)

Instrução (Visual Basic) Dim

Apagar a instrução (Visual Basic)

Nada (Visual Basic)

IndexOutOfRangeException

Outros recursos

Matrizes em Visual Basic