Xml.xmldom.GetDOMVendor

• 親: Xml.xmldom

Delphi

function GetDOMVendor(const VendorDesc: string = ''): TDOMVendor;

C++

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

プロパティ

種類	可視性	ソース	ユニット	親
function	public	Xml.Xmldom.pas Xml.xmldom.hpp	Xml.xmldom	Xml.xmldom

説明

指定された DOM ベンダの TDOMVendor オブジェクトを返します。

GetDOMVendor を呼び出すと、登録済みの DOM 実装を表す TDOMVendor オブジェクトを取得できます。その後は、この戻り値を TXMLDocument の DOMVendor プロパティとして割り当てたり、このオブジェクトの DOMImplementation メソッドを呼び出して DOM 実装の IDOMImplementation インターフェイスにアクセスしたりすることができます。

VendorDesc は、目的とする DOM 実装を特定するための説明文字列です。これは、TDOMVendor オブジェクトの Description メソッドで返される値です。「組み込み XML ベンダの一覧」では、組み込み XML ベンダ実装の 1 つを取得するために GetDOMVendor に VendorDesc として渡すことができるグローバル変数を示しています。

VendorDesc として空文字列を指定した場合、GetDOMVendor は、DefaultDOMVendor の値に一致する TDOMVendor インスタンスを代わりに返します。DefaultDOMVendor が未定義の場合、GetDOMVendor は、登録済み DOM ベンダのリストに含まれている最初の TDOMVendor インスタンスを返します。

GetDOMVendor では、TDOMVendor のインスタンスを返す前に、CurrentDOMVendor の値をその TDOMVendor インスタンスの Description に変更します。

例外

GetDOMVendor を呼び出すと、次の例外のいずれかが発生する可能性があります。

例外	Exception.Message	シナリオ
Exception	DOM ベンダが選択されていません	DOM ベンダのリストに TDOMVendor が登録されていません。使用するユニットに XML ベンダのユニットへの参照を追加するのを忘れた場合に、この例外が発生する可能性があります。詳細については、「ドキュメント オブジェクト モデル（DOM）の使用」を参照してください。 この場合、GetDOMVendor で返される TDOMVendor インスタンスの DOMImplementation プロパティの値は nil になっています。GetDOMVendor で返される TDOMVendor インスタンスは、DOM ベンダのリストに含まれているインスタンスのうち、VendorDesc と一致するもの、VendorDesc が空の場合は DefaultDOMVendor と一致するもの、DefaultDOMVendor も空の場合はリスト内の最初のインスタンスです。
	一致する DOM ベンダがありません: "<ベンダ識別子>"	VendorDesc（VendorDesc が空の場合は DefaultDOMVendor）を識別子とする TDOMVendor が DOM ベンダのリストに登録されていません。組み込み XML ベンダを使用する場合は、「組み込み XML ベンダの一覧」に記載されているグローバル変数を VendorDesc として使用します。

関連項目

• 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 サポート ルーチン
• ドキュメント オブジェクト モデル（DOM）の使用