Matrici in Visual Basic

Una matrice è costituita da un insieme di valori logicamente correlati tra loro, ad esempio il numero degli studenti iscritti a ciascun anno scolastico di una scuola elementare.

Utilizzando una matrice, è possibile fare riferimento a tali valori correlati mediante lo stesso nome e utilizzare un numero che è denominato indice per distinguere i valori.I singoli valori sono denominati elementi della matriceSono contigui dall'indice 0 al valore di indice massimo.

A differenza di una matrice, una variabile contenente un singolo valore viene chiamata una variabile scalare.

In questo argomento

• Elementi di matrice in una matrice semplice

• Creazione di una matrice

• Dichiarazione di una matrice

• Archiviazione di valori in una matrice

• Popolamento di una matrice con valori iniziali

  • Valori letterali della matrice annidati

• Scorrendo da una matrice

• Matrici come valori restituiti e parametri

• Matrici di matrici

• Matrici di lunghezza zero

• Dimensione della matrice

• Tipi di matrice e altri tipi

• Raccolte come alternativa alle matrici

Elementi di matrice in una matrice semplice

Nell'esempio riportato di seguito viene dichiarata una variabile di matrice che deve contenere il numero degli studenti iscritti a ciascun anno scolastico di una scuola elementare.

Dim students(6) As Integer

La matrice students nell'esempio precedente contiene sette elementi.Gli indici degli elementi sono compresi tra 0 e 6.L'utilizzo di questa matrice è più semplice rispetto alla dichiarazione di sette variabili.

Nella seguente figura è indicata la matrice students.Per ciascun elemento della matrice:

• L'indice dell'elemento rappresenta l'anno scolastico (l'indice 0 rappresenta l'asilo).

• Il valore che è contenuto nell'elemento rappresenta il numero degli studenti iscritti a tale stato.

Elementi della matrice "students"

Nell'esempio riportato di seguito viene illustrato come fare riferimento al primo, al secondo e all'ultimo elemento della matrice students.

Dim kindergarten As Integer = students(0)
Dim firstGrade As Integer = students(1)
Dim sixthGrade As Integer = students(6)
MsgBox("Students in kindergarten = " & CStr(kindergarten))
MsgBox("Students in first grade = " & CStr(firstGrade))
MsgBox("Students in sixth grade = " & CStr(sixthGrade))

Per fare riferimento all'intera matrice è sufficiente utilizzare il nome della variabile di matrice senza indici.

La matrice students nell'esempio precedente utilizza un indice e sarebbe unidimensionale.Una matrice che utilizza più indici è detta multidimensionale.Per ulteriori informazioni, vedere il resto di questo argomento e Dimensioni di matrice in Visual Basic.

Creazione di una matrice

È possibile definire la dimensione dei vari modi di una matrice.È possibile fornire la dimensione della matrice viene dichiarata, come illustrato di seguito.

Dim cargoWeights(10) As Double
Dim atmospherePressures(2, 2, 4, 10) As Short
Dim inquiriesByYearMonthDay(20)()() As Byte

È possibile utilizzare anche una clausola di New per specificare la dimensione di una matrice quando viene creato, come illustrato di seguito.

cargoWeights = New Double(10) {}
atmospherePressures = New Short(2, 2, 4, 10) {}
inquiriesByYearMonthDay = New Byte(20)()() {}

Se si dispone di una matrice esistente, è possibile ridefinirne la dimensione tramite l'istruzione Redim.È possibile specificare che l'istruzione di Redim deve mantenere i valori presenti nella matrice, oppure specificare che crea una matrice vuota.Nell'esempio seguente vengono illustrati diversi tipi di utilizzo dell'istruzione Redim per modificare la dimensione di una matrice esistente.

' Assign a new array size and retain the current element values.
ReDim Preserve cargoWeights(20)
' Assign a new array size and retain only the first five element values.
ReDim Preserve cargoWeights(4)
' Assign a new array size and discard all current element values.
ReDim cargoWeights(15)

Per ulteriori informazioni, vedere Istruzione ReDim (Visual Basic).

Dichiarazione di una matrice

Analogamente alle altre variabili, le variabili di matrici vengono dichiarate mediante l'istruzione Dim.Seguire il tipo o il nome della variabile con una o più coppie di parentesi per indicare che utilizzerà una matrice anziché scalare, ovvero una variabile contenente un unico valore.

Dopo avere dichiarato la matrice, è possibile definire la dimensione utilizzando Istruzione ReDim (Visual Basic).

Nell'esempio seguente viene dichiarata una variabile di matrice unidimensionale aggiungendo una coppia di parentesi dopo il tipo.Viene inoltre specifica le dimensioni della matrice tramite Istruzione ReDim (Visual Basic).

' Declare a one-dimensional array.
Dim cargoWeights As Double()

' Dimension the array.
ReDim cargoWeights(15)

Nell'esempio seguente viene dichiarata una variabile di matrice multidimensionale tramite l'aggiunta di una coppia di parentesi dopo il tipo e inserire virgole tra parentesi per separare le dimensioni.Viene inoltre specifica le dimensioni della matrice tramite Istruzione ReDim (Visual Basic).

' Declare a multidimensional array.
Dim atmospherePressures As Short(,,,)

' Dimension the array.
ReDim atmospherePressures(1, 2, 3, 4)

Per dichiarare una variabile di matrice di matrici, aggiungere una coppia di parentesi dopo il nome della variabile per ogni livello della matrice annidati.

Dim inquiriesByYearMonthDay()()() As Byte

Negli esempi precedenti vengono dichiarate variabili di matrice ma non assegnare le matrici.È quindi necessario creare una matrice, inizializzarla e assegnarla alla variabile.

Archiviazione di valori in una matrice

È possibile accedere a ogni posizione in una matrice utilizzando un indice di tipo Integer.È possibile archiviare e recuperare i valori in una matrice facendo riferimento a ogni posizione della matrice utilizzando il relativo indice racchiuso tra parentesi.Gli indici per le matrici multidimensionali sono separati da virgole (,).È necessario un indice per ogni dimensione della matrice.Nell'esempio riportato di seguito vengono illustrate alcune istruzioni che consentono di inserire valori nelle matrici.

Dim i = 4
Dim j = 2

Dim numbers(10) As Integer
Dim matrix(5, 5) As Double

numbers(i + 1) = 0
matrix(3, j * 2) = j

Nell'esempio riportato di seguito vengono illustrate alcune istruzioni che consentono di ottenere valori dalle matrici.

Dim v = 2
Dim i = 1
Dim j = 1
Dim k = 1
Dim wTotal As Double = 0.0
Dim sortedValues(5), rawValues(5), estimates(2, 2, 2) As Double
Dim lowestValue = sortedValues(0)
wTotal += (rawValues(v) ^ 2)
Dim firstGuess = estimates(i, j, k)

Popolamento di una matrice con valori iniziali

Utilizzando un valore letterale di matrice, è possibile creare una matrice contenente un set iniziale di valori.Un valore letterale di matrice è costituito da un elenco di valori delimitati da virgole racchiusi tra parentesi graffe ({}).

Quando si crea una matrice utilizzando un valore letterale di matrice, è possibile specificare il tipo di matrice o utilizzare l'inferenza del tipo per determinare il tipo di matrice.Il codice seguente vengono illustrate entrambe le opzioni.

Dim numbers = New Integer() {1, 2, 4, 8}
Dim doubles = {1.5, 2, 9.9, 18}

Quando si utilizza l'inferenza del tipo, il tipo di matrice è determinato dal tipo dominante nell'elenco di valori fornito per il valore letterale di matrice.Il tipo dominante è un tipo univoco in cui tutti gli altri tipi nel valore letterale di matrice può ampliarsi.Se questo tipo univoco non può essere determinato, il tipo dominante è il tipo univoco in cui tutti gli altri tipi nella matrice possono restringersi.Se nessuno di questi tipi univoci può essere determinato, il tipo dominante è Object.Ad esempio, se l'elenco di valori fornito al valore letterale di matrice contiene valori di tipo Integer, Longe Double, la matrice risultante è di tipo Double.Sia Integer che Long espandere solo a Double.Double è pertanto il tipo dominante.Per ulteriori informazioni, vedere Conversioni di ampliamento e restrizione (Visual Basic).Queste regole di inferenza si applicano a tipi che vengono dedotti per le matrici che sono variabili locali definite in un membro di classe.Sebbene sia possibile utilizzare valori letterali della matrice quando si creano variabili a livello di classe, non è possibile utilizzare l'inferenza del tipo a livello di classe.Di conseguenza, i valori letterali della matrice specificati a livello di classe deducono i valori forniti per il valore letterale di matrice come tipo Object.

È possibile specificare in modo esplicito il tipo degli elementi di una matrice creata utilizzando un valore letterale di matrice.In questo caso, i valori nel valore letterale di matrice devono potersi ampliare al tipo degli elementi della matrice.Nell'esempio di codice seguente viene creata una matrice di tipo Double da un elenco di Integer.

Dim values As Double() = {1, 2, 3, 4, 5, 6}

Valori letterali della matrice annidati

È possibile creare una matrice multidimensionale tramite valori letterali della matrice annidati.I valori letterali della matrice annidati devono avere una dimensione e un numero di dimensioni, o rango, coerente con la matrice risultante.Nell'esempio di codice seguente viene creata una matrice bidimensionale di Integer tramite un valore letterale di matrice.

Dim grid = {{1, 2}, {3, 4}}

Nell'esempio precedente, verrebbe generato un errore se il numero di elementi nei valori letterali della matrice annidati non corrispondesse.Un errore si verificherà se in modo esplicito dichiaraste la variabile di matrice sia bidimensionale.

[!NOTA]

È possibile evitare un errore quando si specificano valori letterali della matrice annidati di dimensioni diverse racchiudendo i valori letterali della matrice interni tra parentesi.Le parentesi forzano l'espressione di valore letterale di matrice da valutare e i valori risultanti vengono utilizzati con il valore letterale di matrice esterno, come illustrato nel codice.

Dim values = {({1, 2}), ({3, 4, 5})}

Quando si crea una matrice multidimensionale tramite valori letterali della matrice annidati, è possibile utilizzare l'inferenza del tipo.Quando si utilizza l'inferenza del tipo, il tipo dedotto è il tipo dominante per tutti i valori in tutti i valori letterali della matrice per un livello di annidamento.Nell'esempio di codice seguente viene creata una matrice bidimensionale di tipo Double da valori di tipo Integer e Double.

Dim a = {{1, 2.0}, {3, 4}, {5, 6}, {7, 8}}

Per ulteriori esempi, vedere Procedura: inizializzare una variabile di matrice in Visual Basic.

Scorrendo da una matrice

Quando si ripete da una matrice, è possibile accedere a ogni elemento della matrice tramite l'indice minimo all'indice più alto.

Nell'esempio scorrere una matrice unidimensionale utilizzando Istruzione For...Next (Visual Basic).Il metodo di GetUpperBound restituisce il valore dell'indice più alto possibile.Il valore più basso dell'indice è sempre 0.

Dim numbers = {10, 20, 30}

For index = 0 To numbers.GetUpperBound(0)
    Debug.WriteLine(numbers(index))
Next
' Output:
'  10
'  20
'  30

Nell'esempio scorrere una matrice multidimensionale tramite un'istruzione di For...Next.Il metodo di GetUpperBound dispone di un parametro che specifica la dimensione.GetUpperBound(0) restituisce il valore di indice lungo la prima dimensione e i valori restituiti da GetUpperBound(1) il valore di indice massimo per la seconda dimensione.

Dim numbers = {{1, 2}, {3, 4}, {5, 6}}

For index0 = 0 To numbers.GetUpperBound(0)
    For index1 = 0 To numbers.GetUpperBound(1)
        Debug.Write(numbers(index0, index1).ToString & " ")
    Next
    Debug.WriteLine("")
Next
' Output 
'  1 2 
'  3 4 
'  5 6

Nell'esempio scorrere una matrice unidimensionale utilizzando Istruzione For Each...Next (Visual Basic).

Dim numbers = {10, 20, 30}

For Each number In numbers
    Debug.WriteLine(number)
Next
' Output:
'  10
'  20
'  30

Nell'esempio scorrere una matrice multidimensionale tramite un'istruzione di For Each...Next.Tuttavia, è maggiore controllo sugli elementi di una matrice multidimensionale se si utilizza un'istruzione annidato di For…Next, come in un esempio precedente, anziché un'istruzione di For Each…Next.

Dim numbers = {{1, 2}, {3, 4}, {5, 6}}

For Each number In numbers
    Debug.WriteLine(number)
Next
' Output:
'  1
'  2
'  3
'  4
'  5
'  6

Matrici come valori restituiti e parametri

Per restituire una matrice da una routine di Function, specificare il tipo di dati matrice e il numero di dimensioni come tipo restituito di Istruzione Function (Visual Basic).Nella funzione, dichiarare una variabile di matrice locale con lo stesso tipo di dati e numero di dimensioni.In Istruzione Return (Visual Basic), includere la variabile di matrice locale senza parentesi.

Per specificare una matrice come parametro a una routine di Function o di Sub, definire il parametro come matrice con un tipo di dati e un numero di dimensioni specificate.Nella chiamata alla routine, inviare una variabile di matrice con lo stesso tipo di dati e numero di dimensioni.

Nell'esempio seguente, la funzione di GetNumbers restituisce Integer().Questo tipo di matrice è una matrice unidimensionale di tipo Integer.La routine di ShowNumbers accetta un argomento di Integer().

Public Sub Process()
    Dim numbers As Integer() = GetNumbers()
    ShowNumbers(numbers)
End Sub

Private Function GetNumbers() As Integer()
    Dim numbers As Integer() = {10, 20, 30}
    Return numbers
End Function

Private Sub ShowNumbers(numbers As Integer())
    For index = 0 To numbers.GetUpperBound(0)
        Debug.WriteLine(numbers(index) & " ")
    Next
End Sub

' Output:
'   10
'   20
'   30

Nell'esempio seguente, la funzione di GetNumbersMultiDim restituisce Integer(,).Questo tipo di matrice è una matrice bidimensionale di tipo Integer.La routine di ShowNumbersMultiDim accetta un argomento di Integer(,).

Public Sub ProcessMultidim()
    Dim numbers As Integer(,) = GetNumbersMultidim()
    ShowNumbersMultidim(numbers)
End Sub

Private Function GetNumbersMultidim() As Integer(,)
    Dim numbers As Integer(,) = {{1, 2}, {3, 4}, {5, 6}}
    Return numbers
End Function

Private Sub ShowNumbersMultidim(numbers As Integer(,))
    For index0 = 0 To numbers.GetUpperBound(0)
        For index1 = 0 To numbers.GetUpperBound(1)
            Debug.Write(numbers(index0, index1).ToString & " ")
        Next
        Debug.WriteLine("")
    Next
End Sub

' Output  
'  1 2  
'  3 4  
'  5 6

Matrici di matrici

Una matrice che utilizza altre matrici come elementi è noto come matrice di matrici o matrice di matrici.Una matrice di matrici e ogni elemento in una matrice di matrici possono contenere uno o più dimensioni.In alcuni casi, i dati nell'applicazione hanno una struttura bidimensionale ma non rettangolare.

L'esempio seguente contiene una matrice di mesi, ogni elemento di cui è una matrice dei giorni.Poiché i mesi diversi dispongono di diversi numeri dei giorni, gli elementi non costituiscono una matrice bidimensionale rettangolare.Di conseguenza, una matrice di matrici è utilizzata al posto di una matrice multidimensionale.

' Declare the jagged array.
' The New clause sets the array variable to a 12-element
' array. Each element is an array of Double elements.
Dim sales()() As Double = New Double(11)() {}

' Set each element of the sales array to a Double
' array of the appropriate size.
For month As Integer = 0 To 11
    Dim days As Integer =
        DateTime.DaysInMonth(Year(Now), month + 1)
    sales(month) = New Double(days - 1) {}
Next month

' Store values in each element.
For month As Integer = 0 To 11
    Dim upper = sales(month).GetUpperBound(0)
    For day = 0 To upper
        sales(month)(day) = (month * 100) + day
    Next
Next

Matrici di lunghezza zero

Una matrice che non contiene elementi viene chiamata una matrice di lunghezza zero.Una variabile che utilizza una matrice di lunghezza zero non ha il valore Nothing.Per creare una matrice che non dispone di elementi, dichiarare una delle dimensioni della matrice come -1, come illustrato di seguito.

Dim twoDimensionalStrings(-1, 3) As String

Potrebbe essere necessario creare una matrice di lunghezza zero nelle seguenti circostanze:

• Senza rischiare un'eccezione di NullReferenceException, il codice deve accedere ai membri della classe di Array, come Length o Rank, oppure chiamare una funzione di Visual Basic come UBound.

• Si desidera che il codice che la utilizza rimanga più leggibile senza che sia necessario verificare la presenza di Nothing come caso particolare.

• Il codice interagisce con le API (API) che richiede di passare a una matrice di lunghezza zero a una o più routine o restituisce una matrice di lunghezza zero da una o più routine.

Dimensione della matrice

La dimensione di una matrice è il prodotto delle lunghezze di tutte le relative dimensionie rappresenta il numero totale di elementi attualmente contenuti nella matrice.

Nell'esempio riportato di seguito viene dichiarata una matrice tridimensionale.

Dim prices(3, 4, 5) As Long

La dimensione complessiva della matrice nella variabile prices è pari a (3 + 1) x (4 + 1) x (5 + 1) = 120.

È possibile determinare la dimensione di una matrice utilizzando la proprietà Length.È possibile determinare la lunghezza di ogni dimensione di una matrice multidimensionale utilizzando il metodo GetLength.

È possibile ridimensionare una variabile di matrice assegnando un nuovo oggetto matrice oppure utilizzando l'istruzione ReDim.

Di seguito sono indicati alcuni elementi importanti relativi alla dimensione di una matrice.

Tipi di matrice e altri tipi

Ogni matrice dispone di un tipo di dati, diverso da quello dei relativi elementi.Non esiste un singolo tipo di dati per tutte le matrici.Il tipo di dati di una matrice viene invece determinato dal numero di dimensioni, o rango, della matrice e dal tipo di dati degli elementi nella matrice.Due variabili di matrice hanno lo stesso tipo di dati solo se hanno lo stesso numero di dimensioni e i relativi elementi includono lo stesso tipo di dati.La lunghezza delle dimensioni in una matrice non influisce sul tipo di dati della matrice.

Ogni matrice eredita dalla classe System.Array. È possibile dichiarare una variabile di tipo Array, ma non è possibile creare una matrice di tipo Array.Inoltre, l'Istruzione ReDim (Visual Basic) non è in grado di operare su una variabile dichiarata di tipo Array.Per questi motivi, e per garantire l'indipendenza dai tipi, si consiglia di dichiarare ogni matrice con un tipo specifico, ad esempio Integer nell'esempio precedente.

E' possibile determinare il tipo di dati di una matrice o dei relativi elementi in diversi modi.

• È possibile chiamare il metodo Object.GetType sulla variabile per ricevere un oggetto Type per il tipo della variabile in fase di esecuzione.Nelle proprietà e nei metodi dell'oggetto Type sono presenti informazioni complete.

• È possibile passare la variabile alla funzione TypeName per ricevere un oggetto String contenente il nome del tipo in fase di esecuzione.

• È possibile passare la variabile alla funzione VarType per ricevere un valore VariantType che rappresenta la classificazione del tipo della variabile.

Nell'esempio seguente viene chiamata la funzione TypeName per determinare il tipo della matrice e il tipo degli elementi nella matrice.Il tipo di matrice è Integer(,) e gli elementi nella matrice sono di tipo Integer.

Dim thisTwoDimArray(,) As Integer = New Integer(9, 9) {}
MsgBox("Type of thisTwoDimArray is " & TypeName(thisTwoDimArray))
MsgBox("Type of thisTwoDimArray(0, 0) is " & TypeName(thisTwoDimArray(0, 0)))

Raccolte come alternativa alle matrici

Le matrici sono utili per creare e utilizzare un numero fisso di oggetti fortemente tipizzati.Le raccolte consentono di lavorare in modo più flessibile con gruppi di oggetti.A differenza delle matrici, il gruppo di oggetti che possono aumentare o diminuire dinamicamente in e ridotte alle esigenze dell'applicazione.

Se occorre modificare la dimensione di una matrice, è necessario utilizzare l'Istruzione ReDim (Visual Basic).In questo modo, in Visual Basic viene creata una nuova matrice e la matrice precedente viene rilasciata per l'eliminazione.Questa operazione causa un aumento del tempo di esecuzione.Di conseguenza, se il numero degli elementi utilizzati cambia spesso, oppure non è possibile prevedere il numero massimo di elementi necessari, è preferibile utilizzare una raccolta per ottenere prestazioni migliori.

Per alcune raccolte, è possibile assegnarvi a una chiave a qualsiasi oggetto che inserisce nella raccolta in modo da recuperare rapidamente l'oggetto utilizzando la chiave.

Se la raccolta contiene gli elementi di un unico tipo di dati, è possibile utilizzare una delle classi nello spazio dei nomi System.Collections.Generic.In una raccolta generica viene imposta l'indipendenza dai tipi, in modo da impedire che vengano aggiunti altri tipi di dati alla raccolta.Quando si recupera un elemento da una raccolta generica, non è necessario determinarne il tipo di dati né convertirlo.

Per ulteriori informazioni sugli insiemi, vedere Raccolte (C# e Visual Basic).

Esempio

Nell'esempio seguente viene utilizzata la classe generica System.Collections.Generic.List<T> .NET Framework per creare una raccolta di oggetti Customer.

' Define the class for a customer.
Public Class Customer
    Public Property Name As String
    ' Insert code for other members of customer structure.
End Class

' Create a module-level collection that can hold 200 elements.
Public CustomerList As New List(Of Customer)(200)

' Add a specified customer to the collection.
Private Sub AddNewCustomer(ByVal newCust As Customer)
    ' Insert code to perform validity check on newCust.
    CustomerList.Add(newCust)
End Sub

' Display the list of customers in the Debug window.
Private Sub PrintCustomers()
    For Each cust As Customer In CustomerList
        Debug.WriteLine(cust)
    Next cust
End Sub

La dichiarazione della raccolta CustomerFile specifica che la raccolta può contenere soltanto elementi di tipo Customere definisce inoltre una capacità iniziale di 200 elementi.La routine AddNewCustomer controlla la validità del nuovo elemento e quindi lo aggiunge alla raccolta.La routine PrintCustomers utilizza un ciclo For Each per attraversare la raccolta e visualizzarne gli elementi.

Argomenti correlati

Vedere anche

Riferimenti

Istruzione Dim (Visual Basic)

Istruzione ReDim (Visual Basic)

Array