Proprietà dell'indicizzatore di estensione (Visual Basic)

Articolo
08/11/2011

Fornisce accesso ai singoli elementi di un insieme.

object(index)

Parti

Argomento	Definizione
object	Obbligatoria. Insieme queryable. Ovvero, un insieme che implementa un oggetto IEnumerable<T> o un oggetto IQueryable<T>.
(	Obbligatorio. Indica l'inizio della proprietà dell'indicizzatore.
index	Obbligatorio. Una espressione integrale che specifica la posizione in base zero di un elemento dell'insieme.
)	Obbligatorio. Indica la fine della proprietà dell'indicizzatore.

Valore restituito

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

Note

È possibile utilizzare la proprietà dell'indicizzatore di estensione per accedere ai singoli elementi in un insieme. 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 insiemi 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 un insieme.

Questa proprietà dell'indicizzatore è simile a una proprietà di estensione per insiemi che implementa IEnumerable<T> o IQueryable<T>: viene utilizzata solo se l'insieme non ha un indicizzatore o una proprietà predefinita.

Per accedere al valore del primo elemento di un insieme 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 un insieme di oggetti XElement. È possibile accedere all'insieme 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