XmlReader.ReadElementContentAsString Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Beolvassa az aktuális elemet, és objektumként String adja vissza a tartalmat.

Túlterhelések

Name	Description
ReadElementContentAsString(String, String)	Ellenőrzi, hogy a megadott helyi név és névtér URI megegyezik-e az aktuális elem nevével, majd beolvassa az aktuális elemet, és objektumként String adja vissza a tartalmat.
ReadElementContentAsString()	Beolvassa az aktuális elemet, és objektumként String adja vissza a tartalmat.

ReadElementContentAsString(String, String)

Forrás:

XmlReader.cs

Ellenőrzi, hogy a megadott helyi név és névtér URI megegyezik-e az aktuális elem nevével, majd beolvassa az aktuális elemet, és objektumként String adja vissza a tartalmat.

public:
 virtual System::String ^ ReadElementContentAsString(System::String ^ localName, System::String ^ namespaceURI);

public virtual string ReadElementContentAsString(string localName, string namespaceURI);

abstract member ReadElementContentAsString : string * string -> string
override this.ReadElementContentAsString : string * string -> string

Public Overridable Function ReadElementContentAsString (localName As String, namespaceURI As String) As String

Paraméterek

localName

String

Az elem helyi neve.

namespaceURI

String

Az elem névterének URI-ja.

Válaszok

String

Az elem tartalma objektumként String .

Kivételek

InvalidOperationException

Az XmlReader elem nincs elemen elhelyezve.

-vagy-

Egy XmlReader metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

XmlException

Az aktuális elem gyermekelemeket tartalmaz.

-vagy-

Az elem tartalma nem konvertálható objektummá String .

ArgumentNullException

A metódus argumentumokkal van null meghívva.

ArgumentException

A megadott helyi név és névtér URI-ja nem egyezik meg az éppen beolvasott elemével.

Példák

Az alábbi példa beolvassa az stringValue elemet, és visszaadja a szöveges tartalmat (figyelmen kívül hagyva a megjegyzést és a feldolgozási utasítást).

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""));
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""))
End Using

A példa a dataFile.xml fájlt használja bemenetként.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Megjegyzések

Ez a metódus felolvassa a kezdőcímkét, az elem tartalmát, és áthelyezi az olvasót a záróelem címkéje mellett. Kibővíti az entitásokat, és figyelmen kívül hagyja a feldolgozási utasításokat és megjegyzéseket. Az elem csak egyszerű tartalmat tartalmazhat. Vagyis nem rendelkezhet gyermekelemekkel.

További információkért tekintse meg a referenciaoldal Megjegyzések szakaszát XmlReader és a W3C XML-séma 2. részét: Adattípusokra vonatkozó javaslatot.

ReadElementContentAsString()

Forrás:

XmlReader.cs

Beolvassa az aktuális elemet, és objektumként String adja vissza a tartalmat.

public:
 virtual System::String ^ ReadElementContentAsString();

public virtual string ReadElementContentAsString();

abstract member ReadElementContentAsString : unit -> string
override this.ReadElementContentAsString : unit -> string

Public Overridable Function ReadElementContentAsString () As String

Válaszok

String

Az elem tartalma objektumként String .

Kivételek

InvalidOperationException

Az XmlReader elem nincs elemen elhelyezve.

-vagy-

Egy XmlReader metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

XmlException

Az aktuális elem gyermekelemeket tartalmaz.

-vagy-

Az elem tartalma nem konvertálható objektummá String .

ArgumentNullException

A metódus argumentumokkal van null meghívva.

Példák

Az alábbi példa beolvassa az stringValue elemet, és visszaadja a szöveges tartalmat (figyelmen kívül hagyva a megjegyzést és a feldolgozási utasítást).

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString());			
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString())
End Using

A példa a dataFile.xml fájlt használja bemenetként.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Megjegyzések

Ez a metódus felolvassa a kezdőcímkét, az elem tartalmát, és áthelyezi az olvasót a záróelem címkéje mellett. Kibővíti az entitásokat, és figyelmen kívül hagyja a feldolgozási utasításokat és megjegyzéseket. Az elem csak egyszerű tartalmat tartalmazhat. Vagyis nem rendelkezhet gyermekelemekkel.

További információkért tekintse meg a referenciaoldal Megjegyzések szakaszát XmlReader és a W3C XML-séma 2. részét: Adattípusokra vonatkozó javaslatot.

A metódus aszinkron verziójáról lásd ReadElementContentAsStringAsync: .