XmlElement.GetElementsByTagName Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

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

Aşırı Yüklemeler

Name	Description
GetElementsByTagName(String, String)	Belirtilen XmlNodeList ve LocalNameile eşleşen tüm alt öğelerin listesini içeren bir NamespaceURI liste döndürür.
GetElementsByTagName(String)	Belirtilen XmlNodeListile eşleşen tüm alt öğelerin listesini içeren bir Name döndürür.

GetElementsByTagName(String, String)

Kaynak:

XmlElement.cs

Belirtilen XmlNodeList ve LocalNameile eşleşen tüm alt öğelerin listesini içeren bir NamespaceURI 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şecek yerel ad. Yıldız işareti (*) tüm etiketlerle eşleşen özel bir değerdir.

namespaceURI

String

Eşleştirecek ad alanı URI'si.

Döndürülenler

XmlNodeList

XmlNodeList Eşleşen tüm düğümlerin listesini içeren. Eşleşen düğüm yoksa liste boştur.

Açıklamalar

Düğümler, ağacın ön sipariş geçişi XmlElement içinde karşılaşılacak sırayla yerleştirilir.

Note

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

GetElementsByTagName(String)

Kaynak:

XmlElement.cs

Belirtilen XmlNodeListile eşleşen tüm alt öğelerin listesini içeren bir Name 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 ad etiketi. Bu, nitelenmiş bir addır. Eşleşen düğümün Name özelliğiyle eşleştirilir. Yıldız işareti (*) tüm etiketlerle eşleşen özel bir değerdir.

Döndürülenler

XmlNodeList

XmlNodeList Eşleşen tüm düğümlerin listesini içeren. Eşleşen düğüm yoksa liste boştur.

Örnekler

Aşağıdaki örnek tüm kitap başlıklarını alır ve görüntüler.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
     XmlDocument doc = new XmlDocument();
     doc.Load("2books.xml");

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

Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

    Dim doc as XmlDocument = new XmlDocument()
    doc.Load("2books.xml")
                         
     ' Get and display all the book titles.
     Dim root as XmlElement = doc.DocumentElement
     Dim elemList as XmlNodeList = root.GetElementsByTagName("title")
     Dim i as integer
     for i=0  to elemList.Count-1
        Console.WriteLine(elemList.ItemOf(i).InnerXml)
     next
    
  end sub
end class

Örnekte giriş 2books.xmlolarak dosyası kullanılır.

<!--sample XML fragment-->
<bookstore>
  <book genre='novel' ISBN='10-861003-324'>
    <title>The Handmaid's Tale</title>
    <price>19.95</price>
  </book>
  <book genre='novel' ISBN='1-861001-57-5'>
    <title>Pride And Prejudice</title>
    <price>24.95</price>
  </book>
</bookstore>

Açıklamalar

Düğümler, ağacın ön sipariş geçişi XmlElement içinde karşılaşılacak sırayla yerleştirilir.

Note

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