XmlDocument.GetElementById(String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de XmlElement opgegeven id op.
public:
virtual System::Xml::XmlElement ^ GetElementById(System::String ^ elementId);
public virtual System.Xml.XmlElement GetElementById(string elementId);
abstract member GetElementById : string -> System.Xml.XmlElement
override this.GetElementById : string -> System.Xml.XmlElement
Public Overridable Function GetElementById (elementId As String) As XmlElement
Parameters
- elementId
- String
De kenmerk-id die moet overeenkomen.
Retouren
De XmlElement met de overeenkomende id of null als er geen overeenkomend element wordt gevonden.
Voorbeelden
In het volgende voorbeeld wordt de methode GetElementById gebruikt.
using System;
using System.Xml;
public class Sample
{
public static void Main()
{
XmlDocument doc = new XmlDocument();
doc.Load("ids.xml");
//Get the first element with an attribute of type ID and value of A111.
//This displays the node <Person SSN="A111" Name="Fred"/>.
XmlElement elem = doc.GetElementById("A111");
Console.WriteLine( elem.OuterXml );
//Get the first element with an attribute of type ID and value of A222.
//This displays the node <Person SSN="A222" Name="Tom"/>.
elem = doc.GetElementById("A222");
Console.WriteLine( elem.OuterXml );
}
}
Option Explicit
Option Strict
Imports System.Xml
Public Class Sample
Public Shared Sub Main()
Dim doc As New XmlDocument()
doc.Load("ids.xml")
'Get the first element with an attribute of type ID and value of A111.
'This displays the node <Person SSN="A111" Name="Fred"/>.
Dim elem As XmlElement = doc.GetElementById("A111")
Console.WriteLine(elem.OuterXml)
'Get the first element with an attribute of type ID and value of A222.
'This displays the node <Person SSN="A222" Name="Tom"/>.
elem = doc.GetElementById("A222")
Console.WriteLine(elem.OuterXml)
End Sub
End Class
In het voorbeeld wordt het bestand als ids.xmlinvoer gebruikt.
<!DOCTYPE root [
<!ELEMENT root ANY>
<!ELEMENT Person ANY>
<!ELEMENT Customer EMPTY>
<!ELEMENT Team EMPTY>
<!ATTLIST Person SSN ID #REQUIRED>
<!ATTLIST Customer id IDREF #REQUIRED >
<!ATTLIST Team members IDREFS #REQUIRED>]>
<root>
<Person SSN='A111' Name='Fred'/>
<Person SSN='A222' Name='Tom'/>
<Customer id='A222334444'/>
<Team members='A222334444 A333445555'/>
</root>
Opmerkingen
Als het document meerdere elementen heeft met de overeenkomende id, retourneert deze methode het eerste overeenkomende element in het document.
Note
De DOM-implementatie moet informatie bevatten die bepaalt welke kenmerken van het type ID zijn. Hoewel kenmerken van het type ID kunnen worden gedefinieerd in XSD-schema's of DTD's, ondersteunt deze versie van het product alleen de kenmerken die zijn gedefinieerd in DTD's. Kenmerken met de naam 'ID' zijn niet van het type ID, tenzij dit is gedefinieerd in de DTD. Implementaties waarbij het onbekend is of de kenmerken van het type ID worden verwacht te retourneren null.