XmlReader.ReadElementContentAsString Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Считывает текущий элемент и возвращает содержимое объекта String.
Перегрузки
| ReadElementContentAsString(String, String) |
Проверяет соответствие указанного URI локального имени и пространства имен с URI текущего элемента, затем считывает текущий элемент и возвращает содержимое как объект String. |
| ReadElementContentAsString() |
Считывает текущий элемент и возвращает содержимое объекта String. |
- Исходный код:
- XmlReader.cs
- Исходный код:
- XmlReader.cs
- Исходный код:
- XmlReader.cs
Проверяет соответствие указанного URI локального имени и пространства имен с URI текущего элемента, затем считывает текущий элемент и возвращает содержимое как объект String.
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 -> stringPublic Overridable Function ReadElementContentAsString (localName As String, namespaceURI As String) As StringПараметры
- localName
- String
Локальное имя элемента.
- namespaceURI
- String
Универсальный код ресурса (URI) пространства имен элемента.
Возвращаемое значение
Содержимое элемента в виде объекта String.
Исключения
Объект XmlReader не расположен на элементе.
-или-
Метод XmlReader вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".
Текущий элемент содержит дочерние элементы.
-или-
Содержимое элемента нельзя преобразовать в объект String.
Метод вызван с аргументами null.
Указанное локальное имя и URI пространства имен не совпадают с аналогичными параметрами текущего считываемого элемента.
Примеры
В следующем примере считывается stringValue элемент и возвращается текстовое содержимое (игнорируя комментарий и инструкцию по обработке).
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
В примере в качестве входных данных используется файл dataFile.xml.
<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>
Комментарии
Этот метод считывает тег start, содержимое элемента и перемещает средство чтения за тег конечного элемента. Он расширяет сущности и игнорирует инструкции и комментарии по обработке. Элемент может содержать только простое содержимое. То есть он не может содержать дочерние элементы.
Дополнительные сведения см. в разделе "Примечания" справочной XmlReader страницы и в рекомендации W3C XML Schema Part 2: Datatypes (Схема XML W3C, часть 2. Типы данных ).
Применяется к
.NET 10 и другие версии
| Продукт | Версии |
|---|---|
| .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, 8, 9, 10 |
| .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, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- Исходный код:
- XmlReader.cs
- Исходный код:
- XmlReader.cs
- Исходный код:
- XmlReader.cs
Считывает текущий элемент и возвращает содержимое объекта String.
public:
virtual System::String ^ ReadElementContentAsString();public virtual string ReadElementContentAsString();abstract member ReadElementContentAsString : unit -> string
override this.ReadElementContentAsString : unit -> stringPublic Overridable Function ReadElementContentAsString () As StringВозвращаемое значение
Содержимое элемента в виде объекта String.
Исключения
Объект XmlReader не расположен на элементе.
-или-
Метод XmlReader вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".
Текущий элемент содержит дочерние элементы.
-или-
Содержимое элемента нельзя преобразовать в объект String.
Метод вызван с аргументами null.
Примеры
В следующем примере считывается stringValue элемент и возвращается текстовое содержимое (игнорируя комментарий и инструкцию по обработке).
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
В примере в качестве входных данных используется файл dataFile.xml.
<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>
Комментарии
Этот метод считывает тег start, содержимое элемента и перемещает средство чтения за тег конечного элемента. Он расширяет сущности и игнорирует инструкции и комментарии по обработке. Элемент может содержать только простое содержимое. То есть он не может содержать дочерние элементы.
Дополнительные сведения см. в разделе "Примечания" справочной XmlReader страницы и в рекомендации W3C XML Schema Part 2: Datatypes (Схема XML W3C, часть 2. Типы данных ).
Асинхронную версию этого метода см. в разделе ReadElementContentAsStringAsync.
Применяется к
.NET 10 и другие версии
| Продукт | Версии |
|---|---|
| .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, 8, 9, 10 |
| .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, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
