Udostępnij za pośrednictwem


XmlElement.GetElementsByTagName Metoda

Definicja

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
Źródło:
XmlElement.cs
Ź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

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 .

Dotyczy

GetElementsByTagName(String)

Źródło:
XmlElement.cs
Źródło:
XmlElement.cs
Ź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

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 .

Dotyczy