Proprietà dell'indicizzatore di estensione
Aggiornamento: novembre 2007
Fornisce accesso ai singoli elementi di un insieme.
object(index)
Parti
object
Obbligatorio. 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.
Il compilatore Visual Basic converte le proprietà dell'indicizzatore di estensione a chiamate al metodo ElementAtOrDefault. A differenza dell'indicizzatore di matrici, il metodoElementAtOrDefault restituisce Nothing se l'indice è esterno all'intervallo. 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.
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