ネーム・スペース宣言
ネーム・スペース宣言 は、XQuery 式プロローグにおけるオプションの宣言で、ネーム・スペース接頭部を宣言し、その接頭部をネーム・スペース URI と関連付けます。
宣言は、接頭部と URI のペアを式の静的に既知のネーム・スペースのセットに追加します。
静的に既知のネーム・スペース には、
式の静的処理中に認識されるすべてのネーム・スペースが含まれます。
ネーム・スペース宣言は、宣言されている XQuery 式全体で有効です。
照会プロローグにおいて同じネーム・スペース接頭部を
複数回宣言すると、結果はエラーになります。
制約事項: 接頭部 xmlns および xml は予約済みであり、ネーム・スペース宣言で接頭部として指定することはできません。
構文
namespace-declaration |--declare--namespace--prefix--=--stringLiteral--;--------------|
- prefix
- URI にバインドするネーム・スペース接頭部を指定します。ネーム・スペース接頭部は、 エレメント、属性、データ・タイプ、または関数のネーム・スペースを識別するために、 修飾名 (QName) で使用されます。
- stringLiteral
- 接頭部をバインドする URI を表すストリング・リテラル指定します。ストリング・リテラル値は、
有効な URI でなければならず、ゼロ長ストリングにすることはできません。
これらの接頭部のネーム・スペース宣言を指定することにより、事前宣言されたネーム・スペース接頭部を指定変更できます。ただし、接頭部 xml に 関連付けられた URI は指定変更できません。
ストリング・リテラルは、http://www.w3.org/XML/1998/namespace または http://www.w3.org/2000/xmlns/ であってはなりません。
例
以下のネーム・スペース宣言は、 ネーム・スペース接頭部 ns1 を宣言し、これをネーム・スペース URI http://posample.org に関連付けます。
declare namespace ns1 = "http://posample.org";
/ns1:purchaseOrder[shipTo/name = "Jane" and billTo/name = "Jason"]
この例の式が実行されると、ネーム・スペース接頭部 ns1 はネーム・スペース URI http://posample.org に関連付けられます。式が参照する purchaseOrder 文書のインスタンスは、ネーム・スペース http://posample.org が付いたインスタンスです。
