Formatter 构造函数
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| Formatter() |
构造新的格式化程序。 |
| Formatter(String, String, Locale) |
使用指定的文件名、字符集和区域设置构造新的格式化程序。 |
| Formatter(String, Charset, Locale) |
使用指定的文件名、字符集和区域设置构造新的格式化程序。 |
| Formatter(Stream, String, Locale) |
使用指定的输出流、字符集和区域设置构造新的格式化程序。 |
| Formatter(File, String, Locale) |
使用指定的文件、字符集和区域设置构造新的格式化程序。 |
| Formatter(File, Charset, Locale) |
使用指定的文件、字符集和区域设置构造新的格式化程序。 |
| Formatter(String, String) |
使用指定的文件名和字符集构造新的格式化程序。 |
| Formatter(Stream, String) |
使用指定的输出流和字符集构造新的格式化程序。 |
| Formatter(Stream, Charset, Locale) |
使用指定的输出流、字符集和区域设置构造新的格式化程序。 |
| Formatter(File, String) |
使用指定的文件和字符集构造新的格式化程序。 |
| Formatter(String) |
构造具有指定文件名的新格式化程序。 |
| Formatter(Stream) |
使用指定的输出流构造新的格式化程序。 |
| Formatter(Locale) |
使用指定的区域设置构造新的格式化程序。 |
| Formatter(IAppendable, Locale) |
使用指定的目标和区域设置构造新的格式化程序。 |
| Formatter(IAppendable) |
构造具有指定目标的新格式化程序。 |
| Formatter(PrintStream) |
使用指定的打印流构造新的格式化程序。 |
| Formatter(File) |
使用指定的文件构造新的格式化程序。 |
Formatter()
构造新的格式化程序。
[Android.Runtime.Register(".ctor", "()V", "")]
public Formatter();- 属性
注解
构造新的格式化程序。
格式化输出的目标是通过 StringBuilder 调用 #out out() 检索的，其当前内容可以通过调用 #toString toString()将其转换为字符串。 使用的区域设置是此Java虚拟机实例的区域设置（Locale#getDefault（Locale.Category）默认区域设置。Category#FORMAT 格式。
Java文档java.util.Formatter.Formatter()。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。
适用于
Formatter(String, String, Locale)
使用指定的文件名、字符集和区域设置构造新的格式化程序。
[Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;Ljava/util/Locale;)V", "")]
public Formatter(string? fileName, string? csn, Java.Util.Locale? l);[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;Ljava/util/Locale;)V", "")>]
new Java.Util.Formatter : string * string * Java.Util.Locale -> Java.Util.Formatter参数
- fileName
- String
要用作此格式化程序目标的文件的名称。 如果文件存在，则会将其截断为零大小;否则，将创建一个新文件。 输出将写入文件并缓冲。
- csn
- String
支持的 java.nio.charset.Charset 字符集的名称
- l
- Locale
在格式设置期间要应用的 java.util.Locale 区域设置。
null如果未l应用本地化，则不会应用本地化。
- 属性
例外
如果文件名不表示正常且可写的文件，或者无法打开或创建文件时出现任何错误，则为 。
如果不支持具有指定名称的字符集，则为 。
注解
使用指定的文件名、字符集和区域设置构造新的格式化程序。
Java文档java.util.Formatter.Formatter(java.lang.String, java.lang.String, java.util.Locale)。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。
适用于
Formatter(String, Charset, Locale)
使用指定的文件名、字符集和区域设置构造新的格式化程序。
[Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/nio/charset/Charset;Ljava/util/Locale;)V", "", ApiSince=34)]
public Formatter(string? fileName, Java.Nio.Charset.Charset? charset, Java.Util.Locale? l);[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/nio/charset/Charset;Ljava/util/Locale;)V", "", ApiSince=34)>]
new Java.Util.Formatter : string * Java.Nio.Charset.Charset * Java.Util.Locale -> Java.Util.Formatter参数
- fileName
- String
要用作此格式化程序目标的文件的名称。 如果文件存在，则会将其截断为零大小;否则，将创建一个新文件。 输出将写入文件并缓冲。
- charset
- Charset
java.nio.charset.Charset charset
- l
- Locale
在格式设置期间要应用的 java.util.Locale 区域设置。
null如果未l应用本地化，则不会应用本地化。
- 属性
注解
使用指定的文件名、字符集和区域设置构造新的格式化程序。
Java文档java.util.Formatter.Formatter(java.lang.String, java.nio.charset.Charset, java.util.Locale)。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。
适用于
Formatter(Stream, String, Locale)
使用指定的输出流、字符集和区域设置构造新的格式化程序。
[Android.Runtime.Register(".ctor", "(Ljava/io/OutputStream;Ljava/lang/String;Ljava/util/Locale;)V", "")]
public Formatter(System.IO.Stream? os, string? csn, Java.Util.Locale? l);[<Android.Runtime.Register(".ctor", "(Ljava/io/OutputStream;Ljava/lang/String;Ljava/util/Locale;)V", "")>]
new Java.Util.Formatter : System.IO.Stream * string * Java.Util.Locale -> Java.Util.Formatter参数
- os
- Stream
要用作此格式化程序目标的输出流。 输出将缓冲。
- csn
- String
支持的 java.nio.charset.Charset 字符集的名称
- l
- Locale
在格式设置期间要应用的 java.util.Locale 区域设置。
null如果未l应用本地化，则不会应用本地化。
- 属性
例外
如果不支持具有指定名称的字符集，则为 。
注解
使用指定的输出流、字符集和区域设置构造新的格式化程序。
Java文档java.util.Formatter.Formatter(java.io.OutputStream, java.lang.String, java.util.Locale)。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。
适用于
Formatter(File, String, Locale)
使用指定的文件、字符集和区域设置构造新的格式化程序。
[Android.Runtime.Register(".ctor", "(Ljava/io/File;Ljava/lang/String;Ljava/util/Locale;)V", "")]
public Formatter(Java.IO.File? file, string? csn, Java.Util.Locale? l);[<Android.Runtime.Register(".ctor", "(Ljava/io/File;Ljava/lang/String;Ljava/util/Locale;)V", "")>]
new Java.Util.Formatter : Java.IO.File * string * Java.Util.Locale -> Java.Util.Formatter参数
- file
- File
要用作此格式化程序目标的文件。 如果文件存在，则会将其截断为零大小;否则，将创建一个新文件。 输出将写入文件并缓冲。
- csn
- String
支持的 java.nio.charset.Charset 字符集的名称
- l
- Locale
在格式设置期间要应用的 java.util.Locale 区域设置。
null如果未l应用本地化，则不会应用本地化。
- 属性
例外
File如果不是正常值且可File写，或者File无法创建新项，或者打开或创建时出现任何错误，则为 File。
如果不支持具有指定名称的字符集，则为 。
注解
使用指定的文件、字符集和区域设置构造新的格式化程序。
Java文档java.util.Formatter.Formatter(java.io.File, java.lang.String, java.util.Locale)。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。
适用于
Formatter(File, Charset, Locale)
使用指定的文件、字符集和区域设置构造新的格式化程序。
[Android.Runtime.Register(".ctor", "(Ljava/io/File;Ljava/nio/charset/Charset;Ljava/util/Locale;)V", "", ApiSince=34)]
public Formatter(Java.IO.File? file, Java.Nio.Charset.Charset? charset, Java.Util.Locale? l);[<Android.Runtime.Register(".ctor", "(Ljava/io/File;Ljava/nio/charset/Charset;Ljava/util/Locale;)V", "", ApiSince=34)>]
new Java.Util.Formatter : Java.IO.File * Java.Nio.Charset.Charset * Java.Util.Locale -> Java.Util.Formatter参数
- file
- File
要用作此格式化程序目标的文件。 如果文件存在，则会将其截断为零大小;否则，将创建一个新文件。 输出将写入文件并缓冲。
- charset
- Charset
java.nio.charset.Charset charset
- l
- Locale
在格式设置期间要应用的 java.util.Locale 区域设置。
null如果未l应用本地化，则不会应用本地化。
- 属性
注解
使用指定的文件、字符集和区域设置构造新的格式化程序。
Java文档java.util.Formatter.Formatter(java.io.File, java.nio.charset.Charset, java.util.Locale)。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。
适用于
Formatter(String, String)
使用指定的文件名和字符集构造新的格式化程序。
[Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;)V", "")]
public Formatter(string? fileName, string? csn);[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;)V", "")>]
new Java.Util.Formatter : string * string -> Java.Util.Formatter参数
- fileName
- String
要用作此格式化程序目标的文件的名称。 如果文件存在，则会将其截断为零大小;否则，将创建一个新文件。 输出将写入文件并缓冲。
- csn
- String
支持的 java.nio.charset.Charset 字符集的名称
- 属性
例外
如果文件名不表示正常且可写的文件，或者无法打开或创建文件时出现任何错误，则为 。
如果不支持具有指定名称的字符集，则为 。
注解
使用指定的文件名和字符集构造新的格式化程序。
使用的区域设置是此Java虚拟机实例的区域设置（Locale#getDefault（Locale.Category）默认区域设置。Category#FORMAT 格式。
Java文档java.util.Formatter.Formatter(java.lang.String, java.lang.String)。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。
适用于
Formatter(Stream, String)
使用指定的输出流和字符集构造新的格式化程序。
[Android.Runtime.Register(".ctor", "(Ljava/io/OutputStream;Ljava/lang/String;)V", "")]
public Formatter(System.IO.Stream? os, string? csn);[<Android.Runtime.Register(".ctor", "(Ljava/io/OutputStream;Ljava/lang/String;)V", "")>]
new Java.Util.Formatter : System.IO.Stream * string -> Java.Util.Formatter参数
- os
- Stream
要用作此格式化程序目标的输出流。 输出将缓冲。
- csn
- String
支持的 java.nio.charset.Charset 字符集的名称
- 属性
例外
如果不支持具有指定名称的字符集，则为 。
注解
使用指定的输出流和字符集构造新的格式化程序。
使用的区域设置是此Java虚拟机实例的区域设置（Locale#getDefault（Locale.Category）默认区域设置。Category#FORMAT 格式。
Java文档java.util.Formatter.Formatter(java.io.OutputStream, java.lang.String)。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。
适用于
Formatter(Stream, Charset, Locale)
使用指定的输出流、字符集和区域设置构造新的格式化程序。
[Android.Runtime.Register(".ctor", "(Ljava/io/OutputStream;Ljava/nio/charset/Charset;Ljava/util/Locale;)V", "", ApiSince=34)]
public Formatter(System.IO.Stream? os, Java.Nio.Charset.Charset? charset, Java.Util.Locale? l);[<Android.Runtime.Register(".ctor", "(Ljava/io/OutputStream;Ljava/nio/charset/Charset;Ljava/util/Locale;)V", "", ApiSince=34)>]
new Java.Util.Formatter : System.IO.Stream * Java.Nio.Charset.Charset * Java.Util.Locale -> Java.Util.Formatter参数
- os
- Stream
要用作此格式化程序目标的输出流。 输出将缓冲。
- charset
- Charset
java.nio.charset.Charset charset
- l
- Locale
在格式设置期间要应用的 java.util.Locale 区域设置。
null如果未l应用本地化，则不会应用本地化。
- 属性
注解
使用指定的输出流、字符集和区域设置构造新的格式化程序。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。
适用于
Formatter(File, String)
使用指定的文件和字符集构造新的格式化程序。
[Android.Runtime.Register(".ctor", "(Ljava/io/File;Ljava/lang/String;)V", "")]
public Formatter(Java.IO.File? file, string? csn);[<Android.Runtime.Register(".ctor", "(Ljava/io/File;Ljava/lang/String;)V", "")>]
new Java.Util.Formatter : Java.IO.File * string -> Java.Util.Formatter参数
- file
- File
要用作此格式化程序目标的文件。 如果文件存在，则会将其截断为零大小;否则，将创建一个新文件。 输出将写入文件并缓冲。
- csn
- String
支持的 java.nio.charset.Charset 字符集的名称
- 属性
例外
File如果不是正常值且可File写，或者File无法创建新项，或者打开或创建时出现任何错误，则为 File。
如果不支持具有指定名称的字符集，则为 。
注解
使用指定的文件和字符集构造新的格式化程序。
使用的区域设置是此Java虚拟机实例的区域设置（Locale#getDefault（Locale.Category）默认区域设置。Category#FORMAT 格式。
Java文档java.util.Formatter.Formatter(java.io.File, java.lang.String)。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。
适用于
Formatter(String)
构造具有指定文件名的新格式化程序。
[Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "")]
public Formatter(string? fileName);[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "")>]
new Java.Util.Formatter : string -> Java.Util.Formatter参数
- fileName
- String
要用作此格式化程序目标的文件的名称。 如果文件存在，则会将其截断为零大小;否则，将创建一个新文件。 输出将写入文件并缓冲。
- 属性
例外
如果文件名不表示正常且可写的文件，或者无法打开或创建文件时出现任何错误，则为 。
注解
构造具有指定文件名的新格式化程序。
使用的字符集是Java虚拟机实例的 java.nio.charset.Charset#defaultCharset（） 默认字符集。
使用的区域设置是此Java虚拟机实例的区域设置（Locale#getDefault（Locale.Category）默认区域设置。Category#FORMAT 格式。
Java文档java.util.Formatter.Formatter(java.lang.String)。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。
适用于
Formatter(Stream)
使用指定的输出流构造新的格式化程序。
[Android.Runtime.Register(".ctor", "(Ljava/io/OutputStream;)V", "")]
public Formatter(System.IO.Stream? os);[<Android.Runtime.Register(".ctor", "(Ljava/io/OutputStream;)V", "")>]
new Java.Util.Formatter : System.IO.Stream -> Java.Util.Formatter参数
- os
- Stream
要用作此格式化程序目标的输出流。 输出将缓冲。
- 属性
注解
使用指定的输出流构造新的格式化程序。
使用的字符集是Java虚拟机实例的 java.nio.charset.Charset#defaultCharset（） 默认字符集。
使用的区域设置是此Java虚拟机实例的区域设置（Locale#getDefault（Locale.Category）默认区域设置。Category#FORMAT 格式。
Java文档java.util.Formatter.Formatter(java.io.OutputStream)。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。
适用于
Formatter(Locale)
使用指定的区域设置构造新的格式化程序。
[Android.Runtime.Register(".ctor", "(Ljava/util/Locale;)V", "")]
public Formatter(Java.Util.Locale? l);[<Android.Runtime.Register(".ctor", "(Ljava/util/Locale;)V", "")>]
new Java.Util.Formatter : Java.Util.Locale -> Java.Util.Formatter参数
- l
- Locale
在格式设置期间要应用的 java.util.Locale 区域设置。
null如果未l应用本地化，则不会应用本地化。
- 属性
注解
使用指定的区域设置构造新的格式化程序。
格式化输出的目标是通过 StringBuilder 调用 #out out() 检索的，其当前内容可以通过调用 #toString toString()将其转换为字符串。
Java文档java.util.Formatter.Formatter(java.util.Locale)。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。
适用于
Formatter(IAppendable, Locale)
使用指定的目标和区域设置构造新的格式化程序。
[Android.Runtime.Register(".ctor", "(Ljava/lang/Appendable;Ljava/util/Locale;)V", "")]
public Formatter(Java.Lang.IAppendable? a, Java.Util.Locale? l);[<Android.Runtime.Register(".ctor", "(Ljava/lang/Appendable;Ljava/util/Locale;)V", "")>]
new Java.Util.Formatter : Java.Lang.IAppendable * Java.Util.Locale -> Java.Util.Formatter参数
格式化输出的目标。
null如果是a，则将创建一个StringBuilder。
- l
- Locale
在格式设置期间要应用的 java.util.Locale 区域设置。
null如果未l应用本地化，则不会应用本地化。
- 属性
注解
使用指定的目标和区域设置构造新的格式化程序。
Java文档java.util.Formatter.Formatter(java.lang.Appendable, java.util.Locale)。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。
适用于
Formatter(IAppendable)
构造具有指定目标的新格式化程序。
[Android.Runtime.Register(".ctor", "(Ljava/lang/Appendable;)V", "")]
public Formatter(Java.Lang.IAppendable? a);[<Android.Runtime.Register(".ctor", "(Ljava/lang/Appendable;)V", "")>]
new Java.Util.Formatter : Java.Lang.IAppendable -> Java.Util.Formatter参数
格式化输出的目标。
null如果是a，则将创建一个StringBuilder。
- 属性
注解
构造具有指定目标的新格式化程序。
使用的区域设置是此Java虚拟机实例的区域设置（Locale#getDefault（Locale.Category）默认区域设置。Category#FORMAT 格式。
Java文档java.util.Formatter.Formatter(java.lang.Appendable)。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。
适用于
Formatter(PrintStream)
使用指定的打印流构造新的格式化程序。
[Android.Runtime.Register(".ctor", "(Ljava/io/PrintStream;)V", "")]
public Formatter(Java.IO.PrintStream? ps);[<Android.Runtime.Register(".ctor", "(Ljava/io/PrintStream;)V", "")>]
new Java.Util.Formatter : Java.IO.PrintStream -> Java.Util.Formatter参数
- ps
- PrintStream
要用作此格式化程序目标的流。
- 属性
注解
使用指定的打印流构造新的格式化程序。
使用的区域设置是此Java虚拟机实例的区域设置（Locale#getDefault（Locale.Category）默认区域设置。Category#FORMAT 格式。
字符将写入给定 java.io.PrintStream PrintStream 对象，因此使用该对象的字符集进行编码。
Java文档java.util.Formatter.Formatter(java.io.PrintStream)。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。
适用于
Formatter(File)
使用指定的文件构造新的格式化程序。
[Android.Runtime.Register(".ctor", "(Ljava/io/File;)V", "")]
public Formatter(Java.IO.File? file);[<Android.Runtime.Register(".ctor", "(Ljava/io/File;)V", "")>]
new Java.Util.Formatter : Java.IO.File -> Java.Util.Formatter参数
- file
- File
要用作此格式化程序目标的文件。 如果文件存在，则会将其截断为零大小;否则，将创建一个新文件。 输出将写入文件并缓冲。
- 属性
例外
File如果不是正常值且可File写，或者File无法创建新项，或者打开或创建时出现任何错误，则为 File。
注解
使用指定的文件构造新的格式化程序。
使用的字符集是Java虚拟机实例的 java.nio.charset.Charset#defaultCharset（） 默认字符集。
使用的区域设置是此Java虚拟机实例的区域设置（Locale#getDefault（Locale.Category）默认区域设置。Category#FORMAT 格式。
Java文档java.util.Formatter.Formatter(java.io.File)。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。