XmlElement.GetElementsByTagName Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

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

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.XmlDocument.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

XmlNodeList Vrátí seznam všech následnických prvků, které odpovídají zadanému názvu.

Přetížení

GetElementsByTagName(String, String)	XmlNodeList Vrátí seznam všech následnických prvků, které odpovídají zadanému LocalName a NamespaceURI.
GetElementsByTagName(String)	XmlNodeList Vrátí seznam všech následnických prvků, které odpovídají zadanému Nameznaku .

GetElementsByTagName(String, String)

XmlNodeList Vrátí seznam všech následnických prvků, které odpovídají zadanému LocalName a 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

Místní název, který se má shodovat. Hvězdička (*) je speciální hodnota, která odpovídá všem značek.

namespaceURI

String

Identifikátor URI oboru názvů, který se má shodovat.

Návraty

XmlNodeList

Obsahuje XmlNodeList seznam všech odpovídajících uzlů. Seznam je prázdný, pokud neexistují žádné odpovídající uzly.

Poznámky

Uzly jsou umístěny v pořadí, ve kterém by byly zjištěny v předobjednávce XmlElement procházení stromu.

Poznámka

Místo metody se doporučuje použít XmlNode.SelectNodes metodu nebo XmlNode.SelectSingleNode metodu GetElementsByTagName .

GetElementsByTagName(String)

XmlNodeList Vrátí seznam všech následnických prvků, které odpovídají zadanému Nameznaku .

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

Značka názvu, která se má shodovat. Jedná se o kvalifikovaný název. Porovná se s Name vlastností odpovídajícího uzlu. Hvězdička (*) je speciální hodnota, která odpovídá všem značek.

Návraty

XmlNodeList

Obsahuje XmlNodeList seznam všech odpovídajících uzlů. Seznam je prázdný, pokud neexistují žádné odpovídající uzly.

Příklady

Následující příklad získá a zobrazí všechny názvy knih.

#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

Příklad používá soubor , 2books.xmljako vstup.

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

Poznámky

Uzly jsou umístěny v pořadí, ve kterém by byly zjištěny v předobjednávce XmlElement procházení stromu.

Poznámka

Místo metody se doporučuje použít XmlNode.SelectNodes metodu nebo XmlNode.SelectSingleNode metodu GetElementsByTagName .