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

392 lines
19 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
compact2, compact3
</div>
<div class="subTitle">
org.w3c.dom
</div>
<h2 class="title" title="Interface NamedNodeMap">Interface NamedNodeMap</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public interface <span class="typeNameLabel">NamedNodeMap</span></pre>
<div class="block">
<span>实现<code>NamedNodeMap</code>接口的对象用于表示可以通过名称访问的节点集合。</span>
<span>请注意, <code>NamedNodeMap</code>不继承<code>NodeList</code> ;</span>
<span><code>NamedNodeMaps</code>未按任何特定顺序进行维护。</span>
<span>包含在实现一个对象的对象<code>NamedNodeMap</code>还可以通过一个顺序索引访问,但是这仅仅是允许的内容方便枚举<code>NamedNodeMap</code> 并不意味着DOM指定的顺序对这些节点。</span>
<p> <span><code>NamedNodeMap</code> DOM中的对象是活的。</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">
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/NamedNodeMap.html#getLength--">getLength</a></span>()</code>
<div class="block">
该地图中的节点数。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/NamedNodeMap.html#getNamedItem-java.lang.String-">getNamedItem</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
<div class="block">
检索由name指定的节点。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/NamedNodeMap.html#getNamedItemNS-java.lang.String-java.lang.String-">getNamedItemNS</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> localName)</code>
<div class="block">
检索由本地名称和命名空间URI指定的节点。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/NamedNodeMap.html#item-int-">item</a></span>(int index)</code>
<div class="block">
返回地图中的
<code>index</code>项目。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/NamedNodeMap.html#removeNamedItem-java.lang.String-">removeNamedItem</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
<div class="block">
删除由name指定的节点。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/NamedNodeMap.html#removeNamedItemNS-java.lang.String-java.lang.String-">removeNamedItemNS</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> localName)</code>
<div class="block">
删除由本地名称和命名空间URI指定的节点。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/NamedNodeMap.html#setNamedItem-org.w3c.dom.Node-">setNamedItem</a></span>(<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> arg)</code>
<div class="block">
使用其
<code>nodeName</code>属性添加节点。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/NamedNodeMap.html#setNamedItemNS-org.w3c.dom.Node-">setNamedItemNS</a></span>(<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> arg)</code>
<div class="block">
使用其
<code>namespaceURI</code>
<code>localName</code>添加节点。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getNamedItem-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getNamedItem</h4> <pre><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> getNamedItem(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</pre>
<div class="block">
检索由name指定的节点。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要检索的节点的
<code>nodeName</code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
A
<code>Node</code> (任何类型的),具有指定的
<code>nodeName</code> ,或
<code>null</code>如果它不标识此映射中的任何节点。
</dd>
</dl> </li>
</ul> <a name="setNamedItem-org.w3c.dom.Node-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setNamedItem</h4> <pre><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> setNamedItem(<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> arg)
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>使用其<code>nodeName</code>属性添加节点。</span>
<span>如果具有该名称的节点已经存在于该映射中,则会被新映射替换。</span>
<span>自行替换节点不起作用。</span>
<br/>
<span>由于<code>nodeName</code>属性用于派生节点必须存储的名称,某些类型的多个节点(具有“特殊”字符串值的节点)不能存储,因为这些名称将会冲突。</span>
<span>这被认为优于允许节点被别名。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>arg</code> - 存储在此地图中的节点。</span>
<span>以后可以使用其<code>nodeName</code>属性的值访问该节点。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果新
<code>Node</code>替换替换现有节点
<code>Node</code>返回,否则
<code>null</code>返回。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - WRONG_DOCUMENT_ERR如果<code>arg</code>是从与创建此地图的文档不同的文档创建的。</span>
<br/>
<span>NO_MODIFICATION_ALLOWED_ERR如果此地图是只读的则提高。</span>
<br/>
<span>INUSE_ATTRIBUTE_ERR如果<code>arg</code>是已经是另一个<code>Element</code>对象的属性的<code>Attr</code> ,则<code>Element</code></span>
<span>DOM用户必须明确克隆<code>Attr</code>节点,以便在其他元素中重新使用它们。</span>
<br/>
<span>HIERARCHY_REQUEST_ERR如果尝试添加节点不属于此NamedNodeMap则引发。</span>
<span>示例将包括尝试将Attr节点以外的其他东西插入到元素的属性图中或将非实体节点插入到DocumentType的Entities映射中。</span>
</dd>
</dl> </li>
</ul> <a name="removeNamedItem-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeNamedItem</h4> <pre><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> removeNamedItem(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>删除由name指定的节点。</span>
<span>当此映射包含附加到元素的属性时如果已知已删除的属性具有默认值则属性会立即显示其中包含默认值以及相应的命名空间URI本地名称和前缀如果适用</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要删除的节点的
<code>nodeName</code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果存在具有这种名称的节点,则从该映射中删除该节点。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - NOT_FOUND_ERR如果此映射中没有名为<code>name</code>的节点,则引发。</span>
<br/>
<span>NO_MODIFICATION_ALLOWED_ERR如果此地图是只读的则提高。</span>
</dd>
</dl> </li>
</ul> <a name="item-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>item</h4> <pre><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> item(int index)</pre>
<div class="block">
<span>返回地图中的<code>index</code>项目。</span>
<span>如果<code>index</code>大于或等于此映射中的节点数,则返回<code>null</code></span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>index</code> - 索引到此地图。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
该节点在地图上的
<code>index</code>位置,或
<code>null</code>如果不是有效索引。
</dd>
</dl> </li>
</ul> <a name="getLength--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getLength</h4> <pre>int getLength()</pre>
<div class="block">
<span>该地图中的节点数。</span>
<span>有效子节点索引的范围为<code>0</code><code>length-1</code>含)。</span>
</div> </li>
</ul> <a name="getNamedItemNS-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getNamedItemNS</h4> <pre><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> getNamedItemNS(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> localName)
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>检索由本地名称和命名空间URI指定的节点。</span>
<br/>
<span>按照[ <a href="http://www.w3.org/TR/1999/REC-xml-names-19990114/">XML Namespaces</a> ]应用程序必须使用值null作为方法的namespaceURI参数如果他们希望没有命名空间。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>namespaceURI</code> - 要检索的节点的命名空间URI。
</dd>
<dd>
<code>localName</code> - 要检索的节点的本地名称。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
具有指定的本地名称和命名空间URI的
<code>Node</code> (任何类型的),如果它们不标识此映射中的任何节点,
<code>null</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - NOT_SUPPORTED_ERR如果实现不支持功能“XML”并且通过文档公开的语言不支持XML命名空间例如[
<a href="http://www.w3.org/TR/1999/REC-html401-19991224/">HTML 4.01</a> ]),则可能会被引发。
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
DOM级别2
</dd>
</dl> </li>
</ul> <a name="setNamedItemNS-org.w3c.dom.Node-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setNamedItemNS</h4> <pre><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> setNamedItemNS(<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> arg)
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>使用其<code>namespaceURI</code><code>localName</code>添加节点。</span>
<span>如果具有该名称空间URI和该本地名称的节点已经存在于该映射中则该节点将被新映射替换。</span>
<span>自行替换节点不起作用。</span>
<br/>
<span>Per [ <a href="http://www.w3.org/TR/1999/REC-xml-names-19990114/">XML Namespaces</a> ]应用程序必须使用值null作为方法的namespaceURI参数如果他们希望没有命名空间。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>arg</code> - 存储在此地图中的节点。</span>
<span>稍后可以使用其<code>namespaceURI</code><code>localName</code>属性的值访问该节点。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果新
<code>Node</code>替换替换现有节点
<code>Node</code>返回,否则
<code>null</code>返回。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - WRONG_DOCUMENT_ERR如果<code>arg</code>是从与创建该地图的文档不同的文档创建的。</span>
<br/>
<span>NO_MODIFICATION_ALLOWED_ERR如果此地图是只读的则提高。</span>
<br/>
<span>INUSE_ATTRIBUTE_ERR如果<code>arg</code>是已经是另一个<code>Element</code>对象的属性的<code>Attr</code> ,则<code>Element</code></span>
<span>DOM用户必须明确克隆<code>Attr</code>节点,以便在其他元素中重新使用它们。</span>
<br/>
<span>HIERARCHY_REQUEST_ERR如果尝试添加节点不属于此NamedNodeMap则引发。</span>
<span>示例将包括尝试将Attr节点以外的其他东西插入到元素的属性图中或将非实体节点插入到DocumentType的Entities映射中。</span>
<br/>
<span>NOT_SUPPORTED_ERR如果实现不支持功能“XML”并且通过文档公开的语言不支持XML命名空间例如[ <a href="http://www.w3.org/TR/1999/REC-html401-19991224/">HTML 4.01</a> ]),则可能会被引发。</span>
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
DOM级别2
</dd>
</dl> </li>
</ul> <a name="removeNamedItemNS-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>removeNamedItemNS</h4> <pre><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> removeNamedItemNS(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> localName)
throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>删除由本地名称和命名空间URI指定的节点。</span>
<span>当此映射包含附加到元素的属性如Node接口的<code>Node</code>属性返回)时,已知删除的属性可能具有默认值。</span>
<span>如果是这样属性会立即出现包含默认值以及相应的命名空间URI本地名称和前缀如果适用</span>
<br/>
<span>按照[ <a href="http://www.w3.org/TR/1999/REC-xml-names-19990114/">XML Namespaces</a> ]应用程序必须使用值null作为方法的namespaceURI参数如果他们希望没有命名空间。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>namespaceURI</code> - 要删除的节点的命名空间URI。
</dd>
<dd>
<code>localName</code> - 要删除的节点的本地名称。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果具有这样的本地名称和命名空间URI的节点存在则从该映射中删除该节点。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - NOT_FOUND_ERR如果此地图中没有指定的<code>namespaceURI</code><code>localName</code>节点,则将其提升。</span>
<br/>
<span>NO_MODIFICATION_ALLOWED_ERR如果此地图是只读的则提高。</span>
<br/>
<span>NOT_SUPPORTED_ERR如果实现不支持功能“XML”并且通过文档公开的语言不支持XML命名空间例如[ <a href="http://www.w3.org/TR/1999/REC-html401-19991224/">HTML 4.01</a> ]),则可能会被引发。</span>
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
DOM级别2
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>