XmlDocument.GetElementsByTagName Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

System.Xml.dll, System.Xml.XmlDocument.dll

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Bütünleştirilmiş Kod:

System.Xml.XmlDocument.dll

Bütünleştirilmiş Kod:

System.Xml.dll

Bütünleştirilmiş Kod:

netstandard.dll

Belirtilen adla eşleşen tüm alt öğelerin listesini içeren bir XmlNodeList liste döndürür.

Aşırı Yüklemeler

GetElementsByTagName(String)	Belirtilen Nameile eşleşen tüm alt öğelerin listesini içeren bir XmlNodeList liste döndürür.
GetElementsByTagName(String, String)	Belirtilen LocalName ve NamespaceURIile eşleşen tüm alt öğelerin listesini içeren bir XmlNodeList liste döndürür.

GetElementsByTagName(String)

Belirtilen Nameile eşleşen tüm alt öğelerin listesini içeren bir XmlNodeList liste döndürür.

public:
 virtual System::Xml::XmlNodeList ^ GetElementsByTagName(System::String ^ name);

public virtual System.Xml.XmlNodeList GetElementsByTagName (string name);

abstract member GetElementsByTagName : string -> System.Xml.XmlNodeList
override this.GetElementsByTagName : string -> System.Xml.XmlNodeList

Public Overridable Function GetElementsByTagName (name As String) As XmlNodeList

Parametreler

name

String

Eşleşecek nitelenmiş ad. Eşleşen düğümün Name özelliğiyle eşleştirilir. "*" özel değeri tüm etiketlerle eşleşir.

Döndürülenler

XmlNodeList

XmlNodeList Eşleşen tüm düğümlerin listesini içeren. Eşleşen namedüğüm yoksa, döndürülen koleksiyon boş olur.

Örnekler

Aşağıdaki örnek bir XmlDocument nesne oluşturur ve tüm kitap başlıklarını görüntülemek için yöntemini ve sonuçta elde edilen XmlNodeList nesneyi kullanırGetElementsByTagName.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;

int main()
{
   //Create the XmlDocument.
   XmlDocument^ doc = gcnew XmlDocument;
   doc->Load( "books.xml" );
   
   //Display all the book titles.
   XmlNodeList^ elemList = doc->GetElementsByTagName( "title" );
   for ( int i = 0; i < elemList->Count; i++ )
   {
      Console::WriteLine( elemList[ i ]->InnerXml );
   }
}

using System;
using System.Xml;

public class Sample1
{
    public static void Main()
    {
        //Create the XmlDocument.
        XmlDocument doc = new XmlDocument();
        doc.Load("books.xml");

        //Display all the book titles.
        XmlNodeList elemList = doc.GetElementsByTagName("title");
        for (int i = 0; i < elemList.Count; i++)
        {
            Console.WriteLine(elemList[i].InnerXml);
        }
    }
}

Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        'Create the XmlDocument.
        Dim doc As New XmlDocument()
        doc.Load("books.xml")
        
        'Display all the book titles.
        Dim elemList As XmlNodeList = doc.GetElementsByTagName("title")
        Dim i As Integer
        For i = 0 To elemList.Count - 1
            Console.WriteLine(elemList(i).InnerXml)
        Next i
    End Sub
End Class

Örnekte giriş olarak dosya kullanılır books.xml .

<?xml version='1.0'?>
<!-- This file represents a fragment of a book store inventory database -->
<bookstore>
  <book genre="autobiography" publicationdate="1981" ISBN="1-861003-11-0">
    <title>The Autobiography of Benjamin Franklin</title>
    <author>
      <first-name>Benjamin</first-name>
      <last-name>Franklin</last-name>
    </author>
    <price>8.99</price>
  </book>
  <book genre="novel" publicationdate="1967" ISBN="0-201-63361-2">
    <title>The Confidence Man</title>
    <author>
      <first-name>Herman</first-name>
      <last-name>Melville</last-name>
    </author>
    <price>11.99</price>
  </book>
  <book genre="philosophy" publicationdate="1991" ISBN="1-861001-57-6">
    <title>The Gorgias</title>
    <author>
      <name>Plato</name>
    </author>
    <price>9.99</price>
  </book>
</bookstore>

Açıklamalar

Düğümler, belgede karşılaşılacakları sırayla yerleştirilir.

Not

yöntemi yerine GetElementsByTagName veya XmlNode.SelectSingleNode yöntemini kullanmanız XmlNode.SelectNodes önerilir.

GetElementsByTagName(String, String)

Belirtilen LocalName ve NamespaceURIile eşleşen tüm alt öğelerin listesini içeren bir XmlNodeList liste döndürür.

public:
 virtual System::Xml::XmlNodeList ^ GetElementsByTagName(System::String ^ localName, System::String ^ namespaceURI);

public virtual System.Xml.XmlNodeList GetElementsByTagName (string localName, string namespaceURI);

abstract member GetElementsByTagName : string * string -> System.Xml.XmlNodeList
override this.GetElementsByTagName : string * string -> System.Xml.XmlNodeList

Public Overridable Function GetElementsByTagName (localName As String, namespaceURI As String) As XmlNodeList

Parametreler

localName

String

Eşleştirecek LocalName. "*" özel değeri tüm etiketlerle eşleşir.

namespaceURI

String

Eşleştirecek Ad AlanıURI'sini seçin.

Döndürülenler

XmlNodeList

XmlNodeList Eşleşen tüm düğümlerin listesini içeren. Belirtilen localName ve namespaceURIile eşleşen düğüm yoksa, döndürülen koleksiyon boş olur.

Açıklamalar

Düğümler, belge ağacında karşılaşılacakları sırayla yerleştirilir.

Not

yöntemi yerine GetElementsByTagName veya XmlNode.SelectSingleNode yöntemini kullanmanız XmlNode.SelectNodes önerilir.