用過 elementFormDefault 這個屬性的人,多半都被它搞得一头霧水:驗證時老是莫名其妙地報錯,對照文件又覺得自己沒寫錯,可換個寫法或設定就能通過,卻始終說不出個所以然。官方文件的描述語焉不詳,網路上的討論也莫衷一是。本文就整理筆者做過大量實驗、對照 MSDN 說法後的心得。
MSDN 對 elementFormDefault 的解釋是:指定該架構目標命名空間中所宣告元素的形式,值必須是 qualified 或 unqualified,預設為 unqualified。若為 unqualified,目標命名空間的元素無須以命名空間前綴限定;若為 qualified,則必須以前綴限定。
這段描述其實並不完整,完整的說法應該是:當值為 unqualified 時,實例 XML 的根元素必須有命名空間限定,且該命名空間須為 schema 中定義的 targetNamespace,但其下的子元素無須、也不允許用前綴限定,子元素的命名空間為空。當值為 qualified 時,實例 XML 的根元素及其下所有子元素都必須以命名空間前綴限定該目標命名空間。
先看用前綴定義命名空間的寫法,透過 xmlns:xxx="url" 語法宣告前綴 xxx,再在需要限定的元素前加上前綴與冒號:
<?XML version="1.0" encoding="UTF-8"?>
<n:c XMLns:n="aaaa">
<n:c1>3.141593E0 </n:c1>
<n:c2>String</n:c2>
<c3>0</c3>
</n:c>
這裡定義了一個叫「aaaa」的前綴,加上「n:」的元素都擁有該命名空間,而沒加前綴的 c3 則沒有命名空間限定,其命名空間屬性為空字串。
再看用預設命名空間一次限定全部元素的寫法,根元素單獨的 xmlns 屬性定義預設命名空間,其下元素除非另外設了前綴,否則都被預設命名空間限定:
<?XML version="1.0" encoding="UTF-8"?>
<c XMLns="aaaa">
<c1>3.141593E0 </c1>
<c2>String</c2>
<c3>0</c3>
</c>
這個實例中所有元素(c、c1、c2、c3)的命名空間都是「aaaa」。
elementFormDefault 屬性只用來設定實例子元素是否「一定」需要命名空間限定,它並不決定各元素歸屬哪個命名空間——元素究竟屬於哪個命名空間,是由 XML 實例本身的設定決定的。