Proprietà dell'indicizzatore di estensione (Visual Basic)

Articolo
06/08/2015

Fornisce accesso ai singoli elementi di una raccolta.

object(index)

Parti

Termine	Definizione
object	Obbligatorio. Raccolta queryable. Ovvero, una raccolta che implementa un oggetto IEnumerable o un oggetto IQueryable.
(	Obbligatorio. Indica l'inizio della proprietà dell'indicizzatore.
index	Obbligatorio. Una espressione integrale che specifica la posizione in base zero di un elemento della raccolta.
)	Obbligatorio. Indica la fine della proprietà dell'indicizzatore.

Valore restituito

L'oggetto dal percorso specificato nella raccolta, o Nothing se l'indice è esterno all'intervallo.

Note

È possibile utilizzare la proprietà dell'indicizzatore di estensione per accedere ai singoli elementi in una raccolta. Questa proprietà dell'indicizzatore viene utilizzata in genere sull'output delle proprietà axis XML. L'elemento figlio XML e la proprietà axis descendant XML restituiscono raccolte di oggetti XElement o un valore dell'attributo.

Tramite il compilatore Visual Basic le proprietà dell'indicizzatore di estensione vengono convertite in chiamate al metodoElementAtOrDefault. A differenza dell'indicizzatore di matrice, se l'indice è esterno all'intervallo, tramite il metodo ElementAtOrDefault viene restituito Nothing. Questo comportamento si rivela utile quando non è possibile determinare facilmente il numero di elementi in una raccolta.

Questa proprietà dell'indicizzatore è simile a una proprietà di estensione per raccolte che implementa IEnumerable o IQueryable: viene utilizzata solo se la raccolta non ha un indicizzatore o una proprietà predefinita.

Per accedere al valore del primo elemento di una raccolta di oggetti XElement o XAttribute, è possibile utilizzare la proprietà Value XML. Per ulteriori informazioni, vedere Proprietà Value XML (Visual Basic).

Esempio

Nell'esempio riportato di seguito viene illustrato come utilizzare l'indicizzatore di estensione per accedere al secondo nodo figlio di una raccolta di oggetti XElement. È possibile accedere alla raccolta utilizzando la proprietà axis dell'elemento figlio che ottiene tutti gli elementi figlio denominati phone nell'oggetto contact.

Dim contact As XElement = 
    <contact>
        <name>Patrick Hines</name>
        <phone type="home">206-555-0144</phone>
        <phone type="work">425-555-0145</phone>
    </contact>

Console.WriteLine("Second phone number: " & contact.<phone>(1).Value)

Verrà visualizzato il seguente testo:

Second phone number: 425-555-0145