XML Değeri Özelliği (Visual Basic)

Bir nesne koleksiyonunun XElement ilk öğesinin değerine erişim sağlar.

Sözdizimi

object.Value

Parça

Süre Tanım
object Gerekli. Nesne koleksiyonu XElement .

Dönüş Değeri

String Koleksiyonun ilk öğesinin değerini içeren veya Nothing koleksiyon boşsa.

Açıklamalar

özelliği, Value bir nesne koleksiyonundaki ilk öğenin değerine erişmeyi XElement kolaylaştırır. Bu özellik önce koleksiyonun en az bir nesne içerip içermediğini denetler. Koleksiyon boşsa, bu özellik döndürür Nothing. Aksi takdirde, bu özellik koleksiyondaki Value ilk öğenin özelliğinin değerini döndürür.

Not

'@' tanımlayıcısını kullanarak bir XML özniteliğinin değerine eriştiğinde, öznitelik değeri olarak String döndürülür ve özelliği açıkça belirtmeniz Value gerekmez.

Koleksiyondaki diğer öğelere erişmek için XML uzantısı dizin oluşturucu özelliğini kullanabilirsiniz. Daha fazla bilgi için bkz . Uzantı Dizin Oluşturucu Özelliği.

Devralma

Kullanıcıların çoğunun uygulaması IEnumerable<T>gerekmez ve bu nedenle bu bölümü yoksayabilir.

Value özelliği, uygulayan IEnumerable(Of XElement)türler için bir uzantı özelliğidir. Bu uzantı özelliğinin bağlaması, uzantı yöntemlerinin bağlaması gibidir: bir tür arabirimlerden birini uygularsa ve "Değer" adına sahip bir özellik tanımlarsa, bu özelliğin uzantı özelliğinden önceliklidir. Başka bir deyişle, bu Value özellik uygulayan IEnumerable(Of XElement)bir sınıfta yeni bir özellik tanımlanarak geçersiz kılınabilir.

Örnek 1

Aşağıdaki örnekte, bir nesne koleksiyonundaki Value ilk düğüme erişmek için özelliğinin nasıl kullanılacağı gösterilmektedir XElement . Örnek, nesnedeki adlı phonecontact tüm alt düğümlerin koleksiyonunu almak için alt eksen özelliğini kullanır.

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("Phone number: " & contact.<phone>.Value)

Bu kod aşağıdaki metni görüntüler:

Phone number: 206-555-0144

Örnek 2

Aşağıdaki örnekte, bir nesne koleksiyonundan XML özniteliğinin değerinin nasıl alınacakları gösterilmektedir XAttribute . Örnek, öznitelik ekseni özelliğini kullanarak tüm phone öğelerin özniteliğinin type değerini görüntüler.

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


Dim types = contact.<phone>.Attributes("type")

For Each attr In types
  Console.WriteLine(attr.Value)
Next

Bu kod aşağıdaki metni görüntüler:

home
work

Ayrıca bkz.