properties.html
来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 744 行 · 第 1/3 页
HTML
744 行
<TD><CODE><B><A HREF="Properties.html#propertyNames()">propertyNames</A></B>()</CODE><BR> 返回属性列表中所有键的枚举，如果在主属性列表中未找到同名的键，则包括默认属性列表中不同的键。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="Properties.html#save(java.io.OutputStream, java.lang.String)">save</A></B>(java.io.OutputStream out, <A HREF="../lang/String.html" title="java.lang 中的类">String</A> comments)</CODE><BR> <B>已过时。</B> <I>如果在保存属性列表时发生 I/O 错误，则此方法不抛出 IOException。保存属性列表的首选方法是通过 <code>store(OutputStream out, String comments)</code> 方法或 <code>storeToXML(OutputStream os, String comment)</code> 方法来进行。</I></TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> <A HREF="../lang/Object.html" title="java.lang 中的类">Object</A></CODE></FONT></TD><TD><CODE><B><A HREF="Properties.html#setProperty(java.lang.String, java.lang.String)">setProperty</A></B>(<A HREF="../lang/String.html" title="java.lang 中的类">String</A> key, <A HREF="../lang/String.html" title="java.lang 中的类">String</A> value)</CODE><BR> 调用 <tt>Hashtable</tt> 的方法 <code>put</code>。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="Properties.html#store(java.io.OutputStream, java.lang.String)">store</A></B>(java.io.OutputStream out, <A HREF="../lang/String.html" title="java.lang 中的类">String</A> comments)</CODE><BR> 以适合使用 <A HREF="Properties.html#load(java.io.InputStream)"><CODE>load</CODE></A> 方法加载到 <code>Properties</code> 表中的格式，将此 <code>Properties</code> 表中的属性列表（键和元素对）写入输出流。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="Properties.html#storeToXML(java.io.OutputStream, java.lang.String)">storeToXML</A></B>(java.io.OutputStream os, <A HREF="../lang/String.html" title="java.lang 中的类">String</A> comment)</CODE><BR> 发出一个表示此表中包含的所有属性的 XML 文档。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="Properties.html#storeToXML(java.io.OutputStream, java.lang.String, java.lang.String)">storeToXML</A></B>(java.io.OutputStream os, <A HREF="../lang/String.html" title="java.lang 中的类">String</A> comment, <A HREF="../lang/String.html" title="java.lang 中的类">String</A> encoding)</CODE><BR> 使用指定的编码发出一个表示此表中包含的所有属性的 XML 文档。</TD></TR></TABLE> <A NAME="methods_inherited_from_class_java.util.Hashtable"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"><TH ALIGN="left"><B>从类 java.util.<A HREF="Hashtable.html" title="java.util 中的类">Hashtable</A> 继承的方法</B></TH></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><A HREF="Hashtable.html#clear()">clear</A>, <A HREF="Hashtable.html#clone()">clone</A>, <A HREF="Hashtable.html#contains(java.lang.Object)">contains</A>, <A HREF="Hashtable.html#containsKey(java.lang.Object)">containsKey</A>, <A HREF="Hashtable.html#containsValue(java.lang.Object)">containsValue</A>, <A HREF="Hashtable.html#elements()">elements</A>, <A HREF="Hashtable.html#entrySet()">entrySet</A>, <A HREF="Hashtable.html#equals(java.lang.Object)">equals</A>, <A HREF="Hashtable.html#get(java.lang.Object)">get</A>, <A HREF="Hashtable.html#hashCode()">hashCode</A>, <A HREF="Hashtable.html#isEmpty()">isEmpty</A>, <A HREF="Hashtable.html#keys()">keys</A>, <A HREF="Hashtable.html#keySet()">keySet</A>, <A HREF="Hashtable.html#put(K, V)">put</A>, <A HREF="Hashtable.html#putAll(java.util.Map)">putAll</A>, <A HREF="Hashtable.html#rehash()">rehash</A>, <A HREF="Hashtable.html#remove(java.lang.Object)">remove</A>, <A HREF="Hashtable.html#size()">size</A>, <A HREF="Hashtable.html#toString()">toString</A>, <A HREF="Hashtable.html#values()">values</A></CODE></TD></TR></TABLE> <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"><TH ALIGN="left"><B>从类 java.lang.<A HREF="../lang/Object.html" title="java.lang 中的类">Object</A> 继承的方法</B></TH></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><A HREF="../lang/Object.html#finalize()">finalize</A>, <A HREF="../lang/Object.html#getClass()">getClass</A>, <A HREF="../lang/Object.html#notify()">notify</A>, <A HREF="../lang/Object.html#notifyAll()">notifyAll</A>, <A HREF="../lang/Object.html#wait()">wait</A>, <A HREF="../lang/Object.html#wait(long)">wait</A>, <A HREF="../lang/Object.html#wait(long, int)">wait</A></CODE></TD></TR></TABLE> <P><!-- ============ FIELD DETAIL =========== --><A NAME="field_detail"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"><B>字段详细信息</B></FONT></TH></TR></TABLE><A NAME="defaults"><!-- --></A><H3>defaults</H3><PRE>protected <A HREF="Properties.html" title="java.util 中的类">Properties</A> <B>defaults</B></PRE><DL><DD>一个属性列表，包含属性列表中所有未找到值的键的默认值。<P><DL></DL></DL><!-- ========= CONSTRUCTOR DETAIL ======== --><A NAME="constructor_detail"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"><B>构造方法详细信息</B></FONT></TH></TR></TABLE><A NAME="Properties()"><!-- --></A><H3>Properties</H3><PRE>public <B>Properties</B>()</PRE><DL><DD>创建一个无默认值的空属性列表。<P></DL><HR><A NAME="Properties(java.util.Properties)"><!-- --></A><H3>Properties</H3><PRE>public <B>Properties</B>(<A HREF="Properties.html" title="java.util 中的类">Properties</A> defaults)</PRE><DL><DD>创建一个带有指定默认值的空属性列表。<P><DL><DT><B>参数：</B><DD><CODE>defaults</CODE> - 默认值。</DL></DL><!-- ============ METHOD DETAIL ========== --><A NAME="method_detail"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"><B>方法详细信息</B></FONT></TH></TR></TABLE><A NAME="setProperty(java.lang.String, java.lang.String)"><!-- --></A><H3>setProperty</H3><PRE>public <A HREF="../lang/Object.html" title="java.lang 中的类">Object</A> <B>setProperty</B>(<A HREF="../lang/String.html" title="java.lang 中的类">String</A> key, <A HREF="../lang/String.html" title="java.lang 中的类">String</A> value)</PRE><DL><DD>调用 <tt>Hashtable</tt> 的方法 <code>put</code>。使用 <tt>getProperty</tt> 方法提供并行性。强制要求为属性的键和值使用字符串。返回值是 <tt>Hashtable</tt> 调用 <code>put</code> 的结果。<P><DD><DL><DT><B>参数：</B><DD><CODE>key</CODE> - 要置于属性列表中的键。<DD><CODE>value</CODE> - 对应于 <tt>key</tt> 的值。<DT><B>返回：</B><DD>属性列表中指定键的旧值，或者如果没有值，则为 <code>null</code>。<DT><B>从以下版本开始：</B></DT> <DD>1.2</DD><DT><B>另请参见：</B><DD><A HREF="Properties.html#getProperty(java.lang.String)"><CODE>getProperty(java.lang.String)</CODE></A></DL></DD></DL><HR><A NAME="load(java.io.InputStream)"><!-- --></A><H3>load</H3><PRE>public void <B>load</B>(java.io.InputStream inStream) throws java.io.IOException</PRE><DL><DD>从输入流中读取属性列表（键和元素对）。假定该流使用 ISO 8859-1 字符编码；也就是每个字节是一个 Latin1 字符。对于非 Latin1 的字符和某些特殊字符，可以使用与字符和字符串字面值所用的类似转义序列，以值和元素的形式来表示它们（参见《<i>Java Language Specification</i>》的第<a href="../../../../../../../../java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#100850"> 3.3</a> 节和第 <a href="../../../../../../../../java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#101089"> 3.10.6</a> 节）。 字符和字符串所用的字符转义序列的差别有：<ul><li> 不识别八进制转义。<li> 字符序列 <code>\b</code><i> 不</i> 表示退格字符。<li> 该方法并不将无效转义字符前的反斜杠字符 <code>\</code> 视为错误；只是将反斜杠丢弃。例如，在 Java 字符串中，序列 <code>"\z"</code> 将导致编译时错误。相反，此方法会丢弃该反斜杠。因此，该方法将两字符序列 <code>"\b"</code> 与单字符 <code>'b'</code> 视为等同。<li> 转义序列对于单引号和双引号而言不是必需的；但是根据上面的规则，前面有反斜杠的单引号和双引号字符仍旧分别生成单引号和双引号字符。</ul>如果输入中出现了错误的 Unicode 转义序列，则抛出 <code>IllegalArgumentException</code>。 <p>此方法根据行来处理输入。通过行结束符字符集（<code>\n</code> 或 <code>\r</code> 或 <code>\r\n</code>），或者通过文件的结尾来终止输入的自然行。一个自然行可能是一个空行、注释行或保存了键-元素对的某些部分。保存所有键-元素对数据的逻辑行可能分散在多个相邻的自然行中，方法是用反斜杠字符 <code>\</code> 转义行结束符序列。注意，不能以此方式扩展注释行；每个内容为注释的自然行必须有其自己的注释指示符，正如下面所描述的。如果一个逻辑行延伸到多个自然行上，那么这些连续的行会接受进一步的处理，这也在下面描述。到达文件结尾前，会一直从输入流中读取各行。 <p>仅包含空白字符的自然行认为是空行并被忽略。注释行以 ASCII 字符 <code>'#'</code> 或 <code>'!'</code> 作为其首个非空白字符；注释行也被忽略并且不将其编码为键-元素信息。除了行结束符，此方法还将空格字符（<code>' '</code>，<code>'\u0020'</code>）、制表符（<code>'\t'</code>，<code>'\u0009'</code>）和换页符（<code>'\f'</code>，<code>'\u000C'</code>）作为空白。 <p>如果一个逻辑行分散在多个自然行中，则转义行结束符序列的反斜杠、行结束符序列和后续行开始处的任何空白，对键或元素的值都没有影响。后面对键和元素分析的讨论将假定移除行继续符后，构成键和元素的所有字符都出现在单个自然行中。注意，仅检查行结束符前面的字符，以便查看行结束符是否已转义是<i>不</i> 够的；对于要转义的行结束符，必须有奇数个相邻的反斜杠。由于是从左到右来处理输入内容的，所以行结束符前（或其他位置）非零、偶数 2<i>n</i> 个相邻的反斜杠在转义处理后会被编码成 <i>n</i> 个反斜杠。 <p>键包含行中下列区间内的所有字符：从首个非空白字符开始，直到（但不包括）首个非转义的 <code>'='</code>、 <code>':'</code> 或非行结束符的空白字符。所有这些键终止字符都可能包含在键中，方法是在其前面用反斜杠字符进行转义，例如：<p> <code>\:\=</code><p>将是两字符的键 <code>":="</code>。可以使用 <code>\r</code> 和 <code>\n</code> 转义序列包括行结束符字符。跳过键后面的所有空白字符；如果键后的首个非空白字符是 <code>'='</code> 或 <code>':'</code>，则忽略该字符并且跳过其后的所有空白字符。行中所有剩余的字符都成为关联元素字符串的一部分；如果没有剩余的字符，则该元素为空字符串 <code>""</code>。一旦标识了组成键和元素的原始字符序列，则如上所述执行转义处理。 <p>作为一个示例，以下三行都指定了键 <code>"Truth"</code> 和关联元素值 <code>"Beauty"</code>： <p> <pre> Truth = Beauty Truth:Beauty Truth :Beauty </pre>另一个示例，以下三行都指定了单个属性： <p> <pre> fruits apple, banana, pear, \ cantaloupe, watermelon, \ kiwi, mango </pre>键是 <code>"fruits"</code>，关联元素是： <p> <pre>"apple, banana, pear, cantaloupe, watermelon, kiwi, mango"</pre>注意，在每个 <code>\</code> 的前面出现了一个空格，这样最后的结果中每个逗号的后面将出现一个空格；会将 <code>\</code>、行结束符和后续行中的前导空白字符简单地丢弃，并且<i>不会</i> 用一个或多个其他字符替换它们。 <p>第三个示例，此行： <p> <pre>cheeses </pre>指定键是 <code>"cheeses"</code> 并且关联元素是空字符串 <code>""</code>。<p><P><DD><DL><DT><B>参数：</B><DD><CODE>inStream</CODE> - 输入流。<DT><B>抛出：</B><DD><CODE>java.io.IOException</CODE> - 如果读取输入流时发生错误。<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果输入流包含错误的 Unicode 转义序列。</DL></DD></DL><HR><A NAME="save(java.io.OutputStream, java.lang.String)"><!-- --></A><H3>save</H3><PRE><FONT SIZE="-1"><A HREF="../lang/Deprecated.html" title="java.lang 中的注释">@Deprecated</A></FONT>public void <B>save</B>(java.io.OutputStream out, <A HREF="../lang/String.html" title="java.lang 中的类">String</A> comments)</PRE><DL><DD><B>已过时。</B> <I>如果在保存属性列表时发生 I/O 错误，则此方法不抛出 IOException。保存属性列表的首选方法是通过 <code>store(OutputStream out, String comments)</code> 方法或 <code>storeToXML(OutputStream os, String comment)</code> 方法来进行。</I><P><DD>调用 <code>store(OutputStream out, String comments)</code> 方法并取消抛出的 IOExceptions。<P><DD><DL><DT><B>参数：</B><DD><CODE>out</CODE> - 输出流。<DD><CODE>comments</CODE> - 属性列表的描述。<DT><B>抛出：</B><DD><CODE><A HREF="../lang/ClassCastException.html" title="java.lang 中的类">ClassCastException</A></CODE> - 如果此 <code>Properties</code> 对象包含任意非 <code>Strings</code> 的键或值。</DL></DD></DL><HR><A NAME="store(java.io.OutputStream, java.lang.String)"><!-- --></A><H3>⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?