XmlNodeReader.GetAttribute Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значение атрибута.
Перегрузки
GetAttribute(Int32) |
Возвращает значение атрибута по заданному индексу. |
GetAttribute(String) |
Возвращает значение атрибута с указанным именем. |
GetAttribute(String, String) |
Возвращает значение атрибута с указанным локальным именем и универсальным кодом ресурса (URI) пространства имен. |
GetAttribute(Int32)
Возвращает значение атрибута по заданному индексу.
public:
override System::String ^ GetAttribute(int attributeIndex);
public override string GetAttribute (int attributeIndex);
override this.GetAttribute : int -> string
Public Overrides Function GetAttribute (attributeIndex As Integer) As String
Параметры
- attributeIndex
- Int32
Индекс атрибута. Индексация начинается с нуля. (Индекс первого атрибута равен нулю.)
Возвращаемое значение
Значение указанного атрибута.
Исключения
Параметр i
меньше 0 или больше или равен AttributeCount.
Комментарии
Примечание
В платформа .NET Framework 2.0 рекомендуется создавать XmlReader экземпляры с помощью XmlReaderSettings класса и Create метода. Это позволяет использовать все новые функции, представленные в платформа .NET Framework. Дополнительные сведения см. в разделе "Примечания" на XmlReader странице справки.
Этот метод не изменяет позицию средства чтения.
Применяется к
GetAttribute(String)
Возвращает значение атрибута с указанным именем.
public:
override System::String ^ GetAttribute(System::String ^ name);
public override string? GetAttribute (string name);
public override string GetAttribute (string name);
override this.GetAttribute : string -> string
Public Overrides Function GetAttribute (name As String) As String
Параметры
- name
- String
Полное имя атрибута.
Возвращаемое значение
Значение указанного атрибута. Если атрибут не найден, возвращается значение null
.
Примеры
В следующем примере возвращается значение атрибута ISBN.
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
XmlNodeReader^ reader = nullptr;
try
{
//Create and load the XML document.
XmlDocument^ doc = gcnew XmlDocument;
doc->LoadXml( "<book genre='novel' ISBN='1-861003-78' publicationdate='1987'> "
"</book>" );
// Load the XmlNodeReader
reader = gcnew XmlNodeReader( doc );
//Read the ISBN attribute.
reader->MoveToContent();
String^ isbn = reader->GetAttribute( "ISBN" );
Console::WriteLine( "The ISBN value: {0}", isbn );
}
finally
{
if ( reader != nullptr )
reader->Close();
}
}
using System;
using System.IO;
using System.Xml;
public class Sample
{
public static void Main()
{
XmlNodeReader reader = null;
try
{
//Create and load the XML document.
XmlDocument doc = new XmlDocument();
doc.LoadXml("<book genre='novel' ISBN='1-861003-78' publicationdate='1987'> " +
"</book>");
// Load the XmlNodeReader
reader = new XmlNodeReader(doc);
//Read the ISBN attribute.
reader.MoveToContent();
string isbn = reader.GetAttribute("ISBN");
Console.WriteLine("The ISBN value: " + isbn);
}
finally
{
if (reader != null)
reader.Close();
}
}
} // End class
Imports System.IO
Imports System.Xml
Public Class Sample
Public Shared Sub Main()
Dim reader As XmlNodeReader = Nothing
Try
'Create and load the XML document.
Dim doc As New XmlDocument()
doc.LoadXml("<book genre='novel' ISBN='1-861003-78' publicationdate='1987'> " & _
"</book>")
' Load the XmlNodeReader
reader = New XmlNodeReader(doc)
'Read the ISBN attribute.
reader.MoveToContent()
Dim isbn As String = reader.GetAttribute("ISBN")
Console.WriteLine("The ISBN value: " & isbn)
Finally
If Not (reader Is Nothing) Then
reader.Close()
End If
End Try
End Sub
End Class
Комментарии
Примечание
В платформа .NET Framework 2.0 рекомендуется создавать XmlReader экземпляры с помощью XmlReaderSettings класса и Create метода. Это позволяет использовать все новые функции, представленные в платформа .NET Framework. Дополнительные сведения см. в разделе "Примечания" на XmlReader странице справки.
Этот метод не изменяет позицию средства чтения.
Если средство чтения размещено на DocumentType
узле, этот метод можно использовать для получения открытых и СИСТЕМных литералов, например. reader.GetAttribute("PUBLIC")
Применяется к
GetAttribute(String, String)
Возвращает значение атрибута с указанным локальным именем и универсальным кодом ресурса (URI) пространства имен.
public:
override System::String ^ GetAttribute(System::String ^ name, System::String ^ namespaceURI);
public override string? GetAttribute (string name, string? namespaceURI);
public override string GetAttribute (string name, string namespaceURI);
override this.GetAttribute : string * string -> string
Public Overrides Function GetAttribute (name As String, namespaceURI As String) As String
Параметры
- name
- String
Локальное имя атрибута.
- namespaceURI
- String
Универсальный код ресурса (URI) пространства имен атрибута.
Возвращаемое значение
Значение указанного атрибута. Если атрибут не найден, возвращается значение null
.
Комментарии
Примечание
В платформа .NET Framework 2.0 рекомендуется создавать XmlReader экземпляры с помощью XmlReaderSettings класса и Create метода. Это позволяет использовать все новые функции, представленные в платформа .NET Framework. Дополнительные сведения см. в разделе "Примечания" на XmlReader странице справки.
Следующий XML-код содержит атрибут в определенном пространстве имен:
<test xmlns:dt="urn:datatypes" dt:type="int"/>
Вы можете искать dt:type
атрибут, используя один аргумент (префикс и локальное имя) или два аргумента (URI локального имени и пространства имен):
String dt = reader.GetAttribute("dt:type");
String dt2 = reader.GetAttribute("type","urn:datatypes");
Чтобы найти xmlns:dt
атрибут, используйте один из следующих аргументов:
String dt3 = reader.GetAttribute("xmlns:dt");
String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);
Эти сведения также можно получить с помощью Prefix свойства.