Vlastnost indexeru rozšíření (Visual Basic)Extension Indexer Property (Visual Basic)

Poskytuje přístup k jednotlivým prvkům v kolekci.Provides access to individual elements in a collection.

SyntaxeSyntax

object(index)  

SoučástiParts

PojemTerm DefiniceDefinition
object Povinná hodnota.Required. Kolekce Queryable.A queryable collection. To znamená, že kolekce implementující IEnumerable<T> nebo IQueryable<T> .That is, a collection that implements IEnumerable<T> or IQueryable<T>.
(( Povinná hodnota.Required. Označuje začátek vlastnosti indexeru.Denotes the start of the indexer property.
index Povinná hodnota.Required. Celočíselný výraz, který určuje pozici prvku kolekce na základě nuly.An integer expression that specifies the zero-based position of an element of the collection.
)) Povinná hodnota.Required. Označuje konec vlastnosti indexeru.Denotes the end of the indexer property.

Návratová hodnotaReturn Value

Objekt ze zadaného umístění v kolekci, nebo Nothing Pokud je index mimo rozsah.The object from the specified location in the collection, or Nothing if the index is out of range.

PoznámkyRemarks

Vlastnost indexeru rozšíření můžete použít pro přístup k jednotlivým prvkům v kolekci.You can use the extension indexer property to access individual elements in a collection. Tato vlastnost indexeru se obvykle používá ve výstupu vlastností osy XML.This indexer property is typically used on the output of XML axis properties. Vlastnosti podřízenosti a podřízené osy XML vrací kolekce XElement objektů nebo hodnoty atributu.The XML child and XML descendent axis properties return collections of XElement objects or an attribute value.

Kompilátor Visual Basic převádí vlastnosti indexeru rozšíření na volání ElementAtOrDefault metody.The Visual Basic compiler converts extension indexer properties to calls to the ElementAtOrDefault method. Na rozdíl od indexeru pole, ElementAtOrDefault Metoda vrátí, Nothing Pokud je index mimo rozsah.Unlike an array indexer, the ElementAtOrDefault method returns Nothing if the index is out of range. Toto chování je užitečné, pokud nemůžete snadno určit počet prvků v kolekci.This behavior is useful when you cannot easily determine the number of elements in a collection.

Tato vlastnost indexeru je stejná jako vlastnost rozšíření pro kolekce, které implementují IEnumerable<T> nebo IQueryable<T> : používá se pouze v případě, že kolekce nemá indexer nebo výchozí vlastnost.This indexer property is like an extension property for collections that implement IEnumerable<T> or IQueryable<T>: it is used only if the collection does not have an indexer or a default property.

Chcete-li získat přístup k hodnotě prvního prvku v kolekci XElement objektů nebo XAttribute , můžete použít Value vlastnost XML.To access the value of the first element in a collection of XElement or XAttribute objects, you can use the XML Value property. Další informace najdete v tématu vlastnost hodnoty XML.For more information, see XML Value Property.

PříkladExample

Následující příklad ukazuje, jak použít indexer rozšíření pro přístup k druhému podřízenému uzlu v kolekci XElement objektů.The following example shows how to use the extension indexer to access the second child node in a collection of XElement objects. Ke kolekci je přistupovaná pomocí vlastnosti podřízené osy, která vrací všechny podřízené prvky s názvem phone v contact objektu.The collection is accessed by using the child axis property, which gets all child elements named phone in the contact object.

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)

Tento kód zobrazí následující text:This code displays the following text:

Second phone number: 425-555-0145

Viz takéSee also