XmlReader.ReadElementContentAsObject Yöntem
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Geçerli öğeyi okur ve içeriğini olarak Objectdöndürür.
| ReadElementContentAsObject() |
Geçerli öğeyi okur ve içeriğini olarak Objectdöndürür. |
| ReadElementContentAsObject(String, String) |
Belirtilen yerel ad ve ad alanı URI'sinin geçerli öğenin adıyla eşleşip eşleşmediğini denetler, ardından geçerli öğeyi okur ve içeriğini olarak Objectdöndürür. |
ReadElementContentAsObject()
Geçerli öğeyi okur ve içeriğini olarak Objectdöndürür.
public:
virtual System::Object ^ ReadElementContentAsObject();public virtual object ReadElementContentAsObject ();abstract member ReadElementContentAsObject : unit -> obj
override this.ReadElementContentAsObject : unit -> objPublic Overridable Function ReadElementContentAsObject () As ObjectDöndürülenler
En uygun türde kutulu ortak dil çalışma zamanı (CLR) nesnesi. ValueType özelliği uygun CLR türünü belirler. İçerik bir liste türü olarak yazıldıysa, bu yöntem uygun türde bir kutulanmış nesne dizisi döndürür.
Özel durumlar
XmlReader öğesinde konumlandırılmaz.
-veya-
Önceki XmlReader bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.
yöntemi bağımsız değişkenlerle null çağrılır.
Örnekler
Aşağıdaki örnek, düğümün içeriğini price okumak için yöntemini kullanır. Okuyucu, şemadaki bilgileri kullanarak içeriği doğru veri türüne eşler.
// Create a validating reader.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.Schema;
settings.Schemas.Add("urn:items", "item.xsd");
XmlReader reader = XmlReader.Create("item.xml", settings);
// Get the CLR type of the price element.
reader.ReadToFollowing("price");
Console.WriteLine(reader.ValueType);
// Return the value of the price element as Decimal object.
Decimal price = (Decimal) reader.ReadElementContentAsObject();
// Add 2.50 to the price.
price = Decimal.Add(price, 2.50m);
' Create a validating reader.
Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.Schema
settings.Schemas.Add("urn:items", "item.xsd")
Dim reader As XmlReader = XmlReader.Create("item.xml", settings)
' Get the CLR type of the price element.
reader.ReadToFollowing("price")
Console.WriteLine(reader.ValueType)
' Return the value of the price element as Decimal object.
Dim price As [Decimal] = CType(reader.ReadElementContentAsObject(), [Decimal])
' Add 2.50 to the price.
price = [Decimal].Add(price, 2.5D)
Örnekte giriş olarak aşağıdaki iki dosya kullanılır.
item.xml
<item xmlns="urn:items" productID='123098'>
<name>hammer</name>
<price>9.95</price>
<supplierID>1929</supplierID>
</item>
item.xsd
<?xml version="1.0"?>
<xs:schema xmlns:tns="urn:items" attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="urn:items" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="name" type="xs:string" />
<xs:element name="price" type="xs:decimal" />
<xs:element name="supplierID" type="xs:unsignedShort" />
</xs:sequence>
<xs:attribute name="productID" type="xs:unsignedInt" use="required" />
</xs:complexType>
</xs:element>
</xs:schema>
Açıklamalar
Bu yöntem başlangıç etiketini, öğesinin içeriğini okur ve okuyucuyu bitiş öğesi etiketinin dışına taşır. Varlıkları genişletir ve işleme yönergelerini ve açıklamalarını yoksayar. öğesi yalnızca basit içerik içerebilir. Başka bir ifadeyle, alt öğeleri olamaz.
Daha fazla bilgi için başvuru sayfasının Açıklamalar bölümüne XmlReader ve W3C XML Şema Bölüm 2: Veri türleri önerisine bakın.
Bu yöntemin zaman uyumsuz sürümü için bkz ReadElementContentAsObjectAsync. .
Şunlara uygulanır
.NET 7 ve diğer sürümler
| Ürün | Sürümler |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
ReadElementContentAsObject(String, String)
Belirtilen yerel ad ve ad alanı URI'sinin geçerli öğenin adıyla eşleşip eşleşmediğini denetler, ardından geçerli öğeyi okur ve içeriğini olarak Objectdöndürür.
public:
virtual System::Object ^ ReadElementContentAsObject(System::String ^ localName, System::String ^ namespaceURI);public virtual object ReadElementContentAsObject (string localName, string namespaceURI);abstract member ReadElementContentAsObject : string * string -> obj
override this.ReadElementContentAsObject : string * string -> objPublic Overridable Function ReadElementContentAsObject (localName As String, namespaceURI As String) As ObjectParametreler
- localName
- String
Öğesinin yerel adı.
- namespaceURI
- String
öğesinin ad alanı URI'si.
Döndürülenler
En uygun türde kutulu ortak dil çalışma zamanı (CLR) nesnesi. ValueType özelliği uygun CLR türünü belirler. İçerik bir liste türü olarak yazıldıysa, bu yöntem uygun türde bir kutulanmış nesne dizisi döndürür.
Özel durumlar
XmlReader öğesinde konumlandırılmaz.
-veya-
Önceki XmlReader bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.
yöntemi bağımsız değişkenlerle null çağrılır.
Belirtilen yerel ad ve ad alanı URI'si okunan geçerli öğenin adıyla eşleşmiyor.
Açıklamalar
Bu yöntem başlangıç etiketini, öğesinin içeriğini okur ve okuyucuyu bitiş öğesi etiketinin dışına taşır. Varlıkları genişletir ve işleme yönergelerini ve açıklamalarını yoksayar. öğesi yalnızca basit içerik içerebilir. Başka bir ifadeyle, alt öğeleri olamaz.
Daha fazla bilgi için başvuru sayfasının Açıklamalar bölümüne XmlReader ve W3C XML Şema Bölüm 2: Veri türleri önerisine bakın.
Şunlara uygulanır
.NET 7 ve diğer sürümler
| Ürün | Sürümler |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |