Xml.xmldom.GetDOMVendor

• Up to Parent: Xml.xmldom

Delphi

function GetDOMVendor(VendorDesc: string): TDOMVendor;

C++

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

Properties

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

Description

Returns the TDOMVendor object for a specified DOM vendor.

Call GetDOMVendor to obtain the TDOMVendor object that represents a registered DOM implementation. You can then assign this return value as the DOMVendor property of TXMLDocument, or call this object's DOMImplementation method to access the IDOMImplementation interface for the DOM implementation.

VendorDesc is the descriptive string that identifies the particular DOM implementation that is desired. This is the value returned by the TDOMVendor object's Description method. The list of built-in XML vendors shows the global variables that you can pass to GetDOMVendor as VendorDesc to get one of the built-in XML implementations.

If you specify an empty string as VendorDesc, GetDOMVendor returns an instance of TDOMVendor that matches the value of DefaultDOMVendor instead. If DefaultDOMVendor is undefined, GetDOMVendor returns the first instance of TDOMVendor in the list of registered DOM vendors.

Before it returns an instance of TDOMVendor, GetDOMVendor changes the value of CurrentDOMVendor to the Description of that instance of TDOMVendor.

Exceptions

A call to GetDOMVendor may raise any of the following exceptions:

Exception	Exception.Message	Scenarios
Exception	No selected DOM Vendor	There is no TDOMVendor registered in the list of DOM vendors. This may happen if you forget to add a reference to the unit of an XML vendor in your unit. See Using the Document Object Model for more information. The DOMImplementation property of the instance of TDOMVendor that GetDOMVendor would return has nil as value. The instance of TDOMVendor that GetDOMVendor returns is the instance from the list of DOM vendors matching VendorDesc, matching DefaultDOMVendor if VendorDesc is empty, or the first instance in the list if DefaultDOMVendor is empty as well.
	No matching DOM Vendor: "<vendor identifier>"	There is no TDOMVendor registered in the list of DOM vendors with VendorDesc as identifier (or DefaultDOMVendor if VendorDesc is empty). If you want to use a built-in XML vendor, use a global variable from the list of built-in XML vendors as VendorDesc.

See Also

• 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

• XML Support Routines
• Using the Document Object Model