XmlElement.GetElementsByTagName Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

XmlNodeList Zwraca listę wszystkich elementów podrzędnych pasujących do określonej nazwy.

Przeciążenia

GetElementsByTagName(String, String)	XmlNodeList Zwraca listę wszystkich elementów podrzędnych pasujących do określonej wartości LocalName i NamespaceURI.
GetElementsByTagName(String)	XmlNodeList Zwraca listę wszystkich elementów podrzędnych, które pasują do określonego Nameelementu .

GetElementsByTagName(String, String)

Źródło:

XmlElement.cs

XmlNodeList Zwraca listę wszystkich elementów podrzędnych pasujących do określonej wartości LocalName i NamespaceURI.

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

Parametry

localName

String

Nazwa lokalna, która ma być zgodna. Gwiazdka (*) jest specjalną wartością zgodną ze wszystkimi tagami.

namespaceURI

String

Identyfikator URI przestrzeni nazw do dopasowania.

Zwraca

XmlNodeList

Element XmlNodeList zawierający listę wszystkich pasujących węzłów. Lista jest pusta, jeśli nie ma pasujących węzłów.

Uwagi

Węzły są umieszczane w kolejności, w której zostaną one napotkane w przedorderowym przechodzeniu XmlElement drzewa.

Uwaga

Zaleca się użycie XmlNode.SelectNodes metody lub XmlNode.SelectSingleNode zamiast GetElementsByTagName metody .

GetElementsByTagName(String)

Źródło:

XmlElement.cs

XmlNodeList Zwraca listę wszystkich elementów podrzędnych, które pasują do określonego Nameelementu .

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

Parametry

name

String

Tag nazwy, który ma być zgodny. Jest to kwalifikowana nazwa. Jest on zgodny z właściwością Name pasującego węzła. Gwiazdka (*) jest specjalną wartością zgodną ze wszystkimi tagami.

Zwraca

XmlNodeList

Element XmlNodeList zawierający listę wszystkich pasujących węzłów. Lista jest pusta, jeśli nie ma pasujących węzłów.

Przykłady

Poniższy przykład pobiera i wyświetla wszystkie tytuły książki.

#using <System.Xml.dll>

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

int main()
{
   XmlDocument^ doc = gcnew 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 );
   }
}

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

W przykładzie użyto pliku , 2books.xmljako danych wejściowych.

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

Uwagi

Węzły są umieszczane w kolejności, w której zostaną one napotkane w przedorderowym przechodzeniu XmlElement drzewa.

Uwaga

Zaleca się użycie XmlNode.SelectNodes metody lub XmlNode.SelectSingleNode zamiast GetElementsByTagName metody .