uTools-Manuals/docs/java/org/w3c/dom/CDATASection.html

<div class="header">
<div class="subTitle">
     compact2, compact3 
   </div>
<div class="subTitle">
     org.w3c.dom 
   </div>
<h2 class="title" title="Interface CDATASection">Interface CDATASection</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
         All Superinterfaces: 
       </dt>
<dd>
<span><a href="../../../org/w3c/dom/CharacterData.html" title="界面在org.w3c.dom">CharacterData</a> ， <a href="../../../org/w3c/dom/Node.html" title="界面在org.w3c.dom">Node</a> ， <a href="../../../org/w3c/dom/Text.html" title="界面在org.w3c.dom">Text</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">CDATASection</span>
extends <a href="../../../org/w3c/dom/Text.html" title="interface in org.w3c.dom">Text</a></pre>
<div class="block">
<span>CDATA部分用于转义包含否则将被视为标记的字符的文本块。</span>
<span>在CDATA部分中识别的唯一分隔符是“]]&gt;”结束CDATA部分的字符串。</span>
<span>CDATA节无法嵌套。</span>
<span>它们的主要目的是用于包括XML片段等素材，而不需要转义所有的分隔符。</span>
<p> <span><code>CharacterData.data</code>属性保存由CDATA部分包含的文本。</span> <span>请注意，这<em>可能</em>包含需要在CDATA部分之外转义的字符，并且根据为序列化选择的字符编码（“charset”），可能无法将一些字符作为CDATA部分的一部分。</span> </p>
<p> <span><code>CharacterData</code>接口通过<code>CDATASection</code>接口继承自<code>Text</code>接口。</span> <span>相邻<code>CDATASection</code>节点不被使用的合并<code>normalize</code>的方法<code>Node</code>接口。</span> </p>
<p> <span>没有对CDATA部分的内容进行词法检查，因此可以将字符序列<code>"]]&gt;"</code>在[ <a href="http://www.w3.org/TR/2004/REC-xml-20040204">XML 1.0</a> ]的第2.7节的CDATA部分中是非法的。</span> <span>在串行化期间，此字符序列的存在必须产生致命错误，或者在序列化之前必须拆分cdata部分（参见DOMConfiguration <code>"split-cdata-sections"</code>中的<code>DOMConfiguration</code> "split-cdata-sections"）。</span> </p>
<p> <span><b>注意：</b>由于在<code>CDATASection</code>中未识别出任何标记，因此当<code>CDATASection</code>时，字符数字引用不能用作转义机制。</span> <span>因此，当使用字符编码<code>CDATASection</code>时，需要采取措施，其中一些包含的字符不能被表示。</span> <span>否则不会产生格式良好的XML。</span> </p>
<p> <span><b>注意：</b>串行化过程中的一个潜在解决方案是在字符之前结束CDATA部分，使用字符引用或实体引用输出字符，并为文本节点中的任何其他字符打开一个新的CDATA部分。</span> <span>但是请注意，在编写时，某些代码转换库在编码中缺少字符时不会返回错误或异常，从而确保数据在序列化时不会损坏的任务更加困难。</span> </p>
<p> <span>另见<a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407">Document Object Model (DOM) Level 3 Core Specification</a> 。</span> </p>
</div> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- --> </a> <h3>Field Summary</h3>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.org.w3c.dom.Node">
<!-- --> </a> <h3>Fields inherited from interface org.w3c.dom.<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></h3> <code><a href="../../../org/w3c/dom/Node.html#ATTRIBUTE_NODE">ATTRIBUTE_NODE</a>, <a href="../../../org/w3c/dom/Node.html#CDATA_SECTION_NODE">CDATA_SECTION_NODE</a>, <a href="../../../org/w3c/dom/Node.html#COMMENT_NODE">COMMENT_NODE</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_FRAGMENT_NODE">DOCUMENT_FRAGMENT_NODE</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_NODE">DOCUMENT_NODE</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_CONTAINED_BY">DOCUMENT_POSITION_CONTAINED_BY</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_CONTAINS">DOCUMENT_POSITION_CONTAINS</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_DISCONNECTED">DOCUMENT_POSITION_DISCONNECTED</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_FOLLOWING">DOCUMENT_POSITION_FOLLOWING</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC">DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_PRECEDING">DOCUMENT_POSITION_PRECEDING</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_TYPE_NODE">DOCUMENT_TYPE_NODE</a>, <a href="../../../org/w3c/dom/Node.html#ELEMENT_NODE">ELEMENT_NODE</a>, <a href="../../../org/w3c/dom/Node.html#ENTITY_NODE">ENTITY_NODE</a>, <a href="../../../org/w3c/dom/Node.html#ENTITY_REFERENCE_NODE">ENTITY_REFERENCE_NODE</a>, <a href="../../../org/w3c/dom/Node.html#NOTATION_NODE">NOTATION_NODE</a>, <a href="../../../org/w3c/dom/Node.html#PROCESSING_INSTRUCTION_NODE">PROCESSING_INSTRUCTION_NODE</a>, <a href="../../../org/w3c/dom/Node.html#TEXT_NODE">TEXT_NODE</a></code></li>
</ul> </li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.w3c.dom.Text">
<!-- --> </a> <h3>Methods inherited from interface org.w3c.dom.<a href="../../../org/w3c/dom/Text.html" title="interface in org.w3c.dom">Text</a></h3> <code><a href="../../../org/w3c/dom/Text.html#getWholeText--">getWholeText</a>, <a href="../../../org/w3c/dom/Text.html#isElementContentWhitespace--">isElementContentWhitespace</a>, <a href="../../../org/w3c/dom/Text.html#replaceWholeText-java.lang.String-">replaceWholeText</a>, <a href="../../../org/w3c/dom/Text.html#splitText-int-">splitText</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.w3c.dom.CharacterData">
<!-- --> </a> <h3>Methods inherited from interface org.w3c.dom.<a href="../../../org/w3c/dom/CharacterData.html" title="interface in org.w3c.dom">CharacterData</a></h3> <code><a href="../../../org/w3c/dom/CharacterData.html#appendData-java.lang.String-">appendData</a>, <a href="../../../org/w3c/dom/CharacterData.html#deleteData-int-int-">deleteData</a>, <a href="../../../org/w3c/dom/CharacterData.html#getData--">getData</a>, <a href="../../../org/w3c/dom/CharacterData.html#getLength--">getLength</a>, <a href="../../../org/w3c/dom/CharacterData.html#insertData-int-java.lang.String-">insertData</a>, <a href="../../../org/w3c/dom/CharacterData.html#replaceData-int-int-java.lang.String-">replaceData</a>, <a href="../../../org/w3c/dom/CharacterData.html#setData-java.lang.String-">setData</a>, <a href="../../../org/w3c/dom/CharacterData.html#substringData-int-int-">substringData</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.w3c.dom.Node">
<!-- --> </a> <h3>Methods inherited from interface org.w3c.dom.<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></h3> <code><a href="../../../org/w3c/dom/Node.html#appendChild-org.w3c.dom.Node-">appendChild</a>, <a href="../../../org/w3c/dom/Node.html#cloneNode-boolean-">cloneNode</a>, <a href="../../../org/w3c/dom/Node.html#compareDocumentPosition-org.w3c.dom.Node-">compareDocumentPosition</a>, <a href="../../../org/w3c/dom/Node.html#getAttributes--">getAttributes</a>, <a href="../../../org/w3c/dom/Node.html#getBaseURI--">getBaseURI</a>, <a href="../../../org/w3c/dom/Node.html#getChildNodes--">getChildNodes</a>, <a href="../../../org/w3c/dom/Node.html#getFeature-java.lang.String-java.lang.String-">getFeature</a>, <a href="../../../org/w3c/dom/Node.html#getFirstChild--">getFirstChild</a>, <a href="../../../org/w3c/dom/Node.html#getLastChild--">getLastChild</a>, <a href="../../../org/w3c/dom/Node.html#getLocalName--">getLocalName</a>, <a href="../../../org/w3c/dom/Node.html#getNamespaceURI--">getNamespaceURI</a>, <a href="../../../org/w3c/dom/Node.html#getNextSibling--">getNextSibling</a>, <a href="../../../org/w3c/dom/Node.html#getNodeName--">getNodeName</a>, <a href="../../../org/w3c/dom/Node.html#getNodeType--">getNodeType</a>, <a href="../../../org/w3c/dom/Node.html#getNodeValue--">getNodeValue</a>, <a href="../../../org/w3c/dom/Node.html#getOwnerDocument--">getOwnerDocument</a>, <a href="../../../org/w3c/dom/Node.html#getParentNode--">getParentNode</a>, <a href="../../../org/w3c/dom/Node.html#getPrefix--">getPrefix</a>, <a href="../../../org/w3c/dom/Node.html#getPreviousSibling--">getPreviousSibling</a>, <a href="../../../org/w3c/dom/Node.html#getTextContent--">getTextContent</a>, <a href="../../../org/w3c/dom/Node.html#getUserData-java.lang.String-">getUserData</a>, <a href="../../../org/w3c/dom/Node.html#hasAttributes--">hasAttributes</a>, <a href="../../../org/w3c/dom/Node.html#hasChildNodes--">hasChildNodes</a>, <a href="../../../org/w3c/dom/Node.html#insertBefore-org.w3c.dom.Node-org.w3c.dom.Node-">insertBefore</a>, <a href="../../../org/w3c/dom/Node.html#isDefaultNamespace-java.lang.String-">isDefaultNamespace</a>, <a href="../../../org/w3c/dom/Node.html#isEqualNode-org.w3c.dom.Node-">isEqualNode</a>, <a href="../../../org/w3c/dom/Node.html#isSameNode-org.w3c.dom.Node-">isSameNode</a>, <a href="../../../org/w3c/dom/Node.html#isSupported-java.lang.String-java.lang.String-">isSupported</a>, <a href="../../../org/w3c/dom/Node.html#lookupNamespaceURI-java.lang.String-">lookupNamespaceURI</a>, <a href="../../../org/w3c/dom/Node.html#lookupPrefix-java.lang.String-">lookupPrefix</a>, <a href="../../../org/w3c/dom/Node.html#normalize--">normalize</a>, <a href="../../../org/w3c/dom/Node.html#removeChild-org.w3c.dom.Node-">removeChild</a>, <a href="../../../org/w3c/dom/Node.html#replaceChild-org.w3c.dom.Node-org.w3c.dom.Node-">replaceChild</a>, <a href="../../../org/w3c/dom/Node.html#setNodeValue-java.lang.String-">setNodeValue</a>, <a href="../../../org/w3c/dom/Node.html#setPrefix-java.lang.String-">setPrefix</a>, <a href="../../../org/w3c/dom/Node.html#setTextContent-java.lang.String-">setTextContent</a>, <a href="../../../org/w3c/dom/Node.html#setUserData-java.lang.String-java.lang.Object-org.w3c.dom.UserDataHandler-">setUserData</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>