共用方式為

<xsl:message> 項目

  • 發行項

<xsl:message> 項目會將文字訊息傳送到訊息緩衝區或訊息對話方塊中，根據發出項目呼叫所在的環境而定。它也會透過一般錯誤處理機制，發出可被截取的系統層級錯誤訊息。

<xsl:message
  terminate = "yes" | "no" >
</xsl:message>

屬性

  • terminate
    指定是否要在執行此指令時終止轉換。這個屬性可以具有下列兩個字串值的其中一個："yes"或 "no"。當 terminate 屬性設為 "yes" 時，項目的內容就會顯示為系統層級錯誤訊息的一部分，且轉換會終止。若設為 "no"，轉換就會繼續，且忽略錯誤訊息。預設值為 "no"。

項目資訊

發生次數

無限制

父項目

xsl:attribute、xsl:comment、xsl:copy、xsl:element、xsl:fallback、xsl:for-each、xsl:if、xsl:message、xsl:otherwise、xsl:param、xsl:processing-instruction、xsl:template、xsl:variable、xsl:when、xsl:with-param、輸出項目

項目子系

xsl:apply-templates、xsl:attribute、xsl:call-template、xsl:choose、xsl:comment、xsl:copy、xsl:copy-of、xsl:element、xsl:for-each、xsl:if、xsl:processing-instruction、xsl:text、xsl:value-of、xsl:variable、輸出項目

備註

<xsl:message> 項目可以提供對進行中之 XSLT 樣式表進行偵錯的機制。在遇到 <xsl:message> 項目時，若 terminate 旗標設為 "yes"，則 XSLT 處理器會結束，並傳送系統層級的錯誤訊息。<xsl:message> 項目內所含的運算式會針對目前節點進行評估，使 <xsl:message> 成為監看個別項目的理想方式。

範例

下列主題提供 <xsl:message> 項目的範例。