ネーム・スペース宣言

ネーム・スペース宣言 は、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 が付いたインスタンスです。