Xml.xmldom.GetDOMVendor

• Aller au parent : Xml.xmldom

Delphi

function GetDOMVendor(VendorDesc: string): TDOMVendor;

C++

extern DELPHI_PACKAGE TDOMVendor* __fastcall GetDOMVendor(System::UnicodeString VendorDesc);

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	Xml.Xmldom.pas Xml.xmldom.hpp	Xml.xmldom	Xml.xmldom

Description

Renvoie l'objet TDOMVendor d'un fournisseur DOM spécifié.

Appelez GetDOMVendor pour obtenir l'objet TDOMVendor qui représente une implémentation DOM recensée. Vous pouvez ensuite affecter cette valeur de retour à la propriété DOMVendor de TXMLDocument ou appeler la méthode DOMImplementation de cet objet pour accéder à l'interface IDOMImplementation de l'implémentation DOM.

VendorDesc est la chaîne descriptive qui identifie l’implémentation DOM souhaitée. Il s'agit de la valeur renvoyée par la méthode Description de l'objet TDOMVendor. La liste des fournisseurs XML intégrés affiche les variables globales que vous pouvez transmettre à GetDOMVendor en tant que VendorDesc pour obtenir l'une des implémentations XML intégrées.

Si vous spécifiez une chaîne vide en tant que VendorDesc, GetDOMVendor renvoie une instance deTDOMVendor qui correspond à la valeur de DefaultDOMVendor à la place. Si DefaultDOMVendor n'est pas défini, GetDOMVendor renvoie la première instance de TDOMVendor dans la liste des fournisseurs DOM recensés.

Avant le renvoi de l'instance de TDOMVendor, GetDOMVendor change la valeur de CurrentDOMVendor par la description de cette instance de TDOMVendor.

Exceptions

Un appel à GetDOMVendor peut soulever l'une des exceptions suivantes :

Exception	Exception.Message	Scénarios
Exception	Aucun fournisseur DOM sélectionné	Aucun TDOMVendor n'est recensé dans la liste des fournisseurs DOM. Cela peut survenir si vous oubliez d'ajouter une référence à l'unité d'un fournisseur XML dans votre unité. Voir Utilisation du modèle DOM pour de plus amples informations. La propriété DOMImplementation de l'instance de TDOMVendor que GetDOMVendor doit renvoyer a nil comme valeur. L'instance de TDOMVendor que GetDOMVendor renvoie est l'instance provenant de la liste de fournisseurs DOM correspondant à VendorDesc, à DefaultDOMVendor si VendorDesc est vide ou la première instance de la liste si DefaultDOMVendor est également vide.
	Pas de fournisseur DOM correspondant : "<identificateur du fournisseur>"	Aucun TDOMVendor n'est recensé dans la liste des fournisseurs DOM avec VendorDesc comme identificateur (ou DefaultDOMVendor si VendorDesc est vide). Si vous voulez utiliser un fournisseur XML intégré, utilisez une variable globale de la liste des fournisseurs XML intégrés en tant que VendorDesc.

Voir aussi

• Xml.xmldom.TDOMVendor
• Xml.xmldom.TDOMVendor.Description
• Xml.xmldom.TDOMVendor.DOMImplementation

• Xml.xmldom.CurrentDOMVendor
• Xml.xmldom.DefaultDOMVendor
• Xml.xmldom.DOMVendors
• Xml.xmldom.RegisterDOMVendor

• Xml.XMLDoc.TXMLDocument
• Xml.XMLDoc.TXMLDocument.DOMVendor

• Xml.xmldom.IDOMImplementation

• Routines de support XML
• Utilisation du modèle DOM