XmlReader.ReadElementContentAsString Metod

Definition

Namnområde:
System.Xml
Sammansättningar:
System.Xml.dll, System.Xml.ReaderWriter.dll
Sammansättningar:
netstandard.dll, System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.dll
Sammansättning:
netstandard.dll

Läser det aktuella elementet och returnerar innehållet som ett String objekt.

Överlagringar

Name Description
ReadElementContentAsString(String, String)

Kontrollerar att det angivna lokala namnet och namnområdes-URI:n matchar det aktuella elementets, läser det aktuella elementet och returnerar innehållet som ett String objekt.
ReadElementContentAsString()

Läser det aktuella elementet och returnerar innehållet som ett String objekt.

ReadElementContentAsString(String, String)

Källa:
XmlReader.cs
Källa:
XmlReader.cs
Källa:
XmlReader.cs
Källa:
XmlReader.cs
Källa:
XmlReader.cs

Kontrollerar att det angivna lokala namnet och namnområdes-URI:n matchar det aktuella elementets, läser det aktuella elementet och returnerar innehållet som ett String objekt.

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

Parametrar

localName
String

Elementets lokala namn.

namespaceURI
String

Elementets namnområdes-URI.

Returer

String

Elementinnehållet som ett String objekt.

Undantag

InvalidOperationException

XmlReader Är inte placerad på ett element.

-eller-

En XmlReader metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".

XmlException

Det aktuella elementet innehåller underordnade element.

-eller-

Elementinnehållet kan inte konverteras till ett String objekt.

ArgumentNullException

Metoden anropas med null argument.

ArgumentException

Det angivna lokala namnet och namnområdes-URI:n matchar inte det aktuella element som läses.

Exempel

I följande exempel läses elementet stringValue och textinnehållet returneras (kommentaren ignoreras och bearbetningsinstruktionen ignoreras).

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

I exemplet används dataFile.xml filen som indata.

<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>

Kommentarer

Den här metoden läser starttaggen, innehållet i elementet och flyttar läsaren förbi taggen slutelement. Den expanderar entiteter och ignorerar bearbetningsinstruktioner och kommentarer. Elementet kan bara innehålla enkelt innehåll. Den kan alltså inte ha underordnade element.

Mer information finns i avsnittet Kommentarer på XmlReader referenssidan och W3C XML-schemadel 2: Rekommendationen Datatyper .

Gäller för

ReadElementContentAsString()

Källa:
XmlReader.cs
Källa:
XmlReader.cs
Källa:
XmlReader.cs
Källa:
XmlReader.cs
Källa:
XmlReader.cs

Läser det aktuella elementet och returnerar innehållet som ett String objekt.

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

Returer

String

Elementinnehållet som ett String objekt.

Undantag

InvalidOperationException

XmlReader Är inte placerad på ett element.

-eller-

En XmlReader metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".

XmlException

Det aktuella elementet innehåller underordnade element.

-eller-

Elementinnehållet kan inte konverteras till ett String objekt.

ArgumentNullException

Metoden anropas med null argument.

Exempel

I följande exempel läses elementet stringValue och textinnehållet returneras (kommentaren ignoreras och bearbetningsinstruktionen ignoreras).

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

I exemplet används dataFile.xml filen som indata.

<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>

Kommentarer

Den här metoden läser starttaggen, innehållet i elementet och flyttar läsaren förbi taggen slutelement. Den expanderar entiteter och ignorerar bearbetningsinstruktioner och kommentarer. Elementet kan bara innehålla enkelt innehåll. Den kan alltså inte ha underordnade element.

Mer information finns i avsnittet Kommentarer på XmlReader referenssidan och W3C XML-schemadel 2: Rekommendationen Datatyper .

Den asynkrona versionen av den här metoden finns i ReadElementContentAsStringAsync.

Gäller för