Formatter 建構函式
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| 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();- 屬性
備註
建立一個新的格式化器。
格式化輸出的目的地為 a StringBuilder ，可透過調用 #out out() 取得，且其當前內容可透過調用 #toString toString()轉換成字串。 所使用的 locale 是 Locale#getDefault（Locale.Category） 預設 Locale，適用於此 Java 虛擬機實例的 Locale.Category#FORMAT 格式。
Java 文件 java.util.Formatter.Formatter()。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
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 在格式化時套用。 若 l 是 null ，則不需局部化。
- 屬性
例外狀況
如果檔名不代表正常且可寫的檔案，或無法建立新檔案，或開啟或建立檔案時出現錯誤。
如果指定名稱的字元集不被支援。
備註
建立一個包含指定檔名、字元集與區域的新格式化器。
Java 文件 java.util.Formatter.Formatter(java.lang.String, java.lang.String, java.util.Locale)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
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 字元集
- l
- Locale
java.util.Locale 在格式化時套用。 若 l 是 null ，則不需局部化。
- 屬性
備註
建立一個包含指定檔名、字元集與區域的新格式化器。
Java 文件 java.util.Formatter.Formatter(java.lang.String, java.nio.charset.Charset, java.util.Locale)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
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 在格式化時套用。 若 l 是 null ，則不需局部化。
- 屬性
例外狀況
如果指定名稱的字元集不被支援。
備註
建立一個新的格式化器，包含指定的輸出串流、字元集和位置。
Java 文件 java.util.Formatter.Formatter(java.io.OutputStream, java.lang.String, java.util.Locale)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
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 在格式化時套用。 若 l 是 null ，則不需局部化。
- 屬性
例外狀況
若 不是 File 正常且可 File寫的 ，或無法建立新 File ，或開啟或建立 時 File出現錯誤。
如果指定名稱的字元集不被支援。
備註
建立一個包含指定檔案、字元集和位置的新格式化器。
Java 文件 java.util.Formatter.Formatter(java.io.File, java.lang.String, java.util.Locale)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
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 字元集
- l
- Locale
java.util.Locale 在格式化時套用。 若 l 是 null ，則不需局部化。
- 屬性
備註
建立一個包含指定檔案、字元集和位置的新格式化器。
Java 文件 java.util.Formatter.Formatter(java.io.File, java.nio.charset.Charset, java.util.Locale)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
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 字元集名稱
- 屬性
例外狀況
如果檔名不代表正常且可寫的檔案，或無法建立新檔案，或開啟或建立檔案時出現錯誤。
如果指定名稱的字元集不被支援。
備註
建立一個包含指定檔案名稱與字元集的新格式化器。
所使用的 locale 是 Locale#getDefault（Locale.Category） 預設 Locale，適用於此 Java 虛擬機實例的 Locale.Category#FORMAT 格式。
Java 文件 java.util.Formatter.Formatter(java.lang.String, java.lang.String)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
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 字元集名稱
- 屬性
例外狀況
如果指定名稱的字元集不被支援。
備註
建立一個新的格式化器，包含指定的輸出串流與字元集。
所使用的 locale 是 Locale#getDefault（Locale.Category） 預設 Locale，適用於此 Java 虛擬機實例的 Locale.Category#FORMAT 格式。
Java 文件 java.util.Formatter.Formatter(java.io.OutputStream, java.lang.String)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
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 字元集
- l
- Locale
java.util.Locale 在格式化時套用。 若 l 是 null ，則不需局部化。
- 屬性
備註
建立一個新的格式化器，包含指定的輸出串流、字元集和位置。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
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出現錯誤。
如果指定名稱的字元集不被支援。
備註
用指定的檔案和字元集建構一個新的格式化器。
所使用的 locale 是 Locale#getDefault（Locale.Category） 預設 Locale，適用於此 Java 虛擬機實例的 Locale.Category#FORMAT 格式。
Java 文件 java.util.Formatter.Formatter(java.io.File, java.lang.String)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
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（） 預設字元集。
所使用的 locale 是 Locale#getDefault（Locale.Category） 預設 Locale，適用於此 Java 虛擬機實例的 Locale.Category#FORMAT 格式。
Java 文件 java.util.Formatter.Formatter(java.lang.String)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
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（） 預設字元集。
所使用的 locale 是 Locale#getDefault（Locale.Category） 預設 Locale，適用於此 Java 虛擬機實例的 Locale.Category#FORMAT 格式。
Java 文件 java.util.Formatter.Formatter(java.io.OutputStream)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
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 在格式化時套用。 若 l 是 null ，則不需局部化。
- 屬性
備註
用指定的地點建立一個新的格式化器。
格式化輸出的目的地為 a StringBuilder ，可透過調用 #out out() 取得，且其當前內容可透過調用 #toString toString()轉換成字串。
Java 文件 java.util.Formatter.Formatter(java.util.Locale)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
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參數
格式化輸出的目的地。 如果 a 是， null 則會產生一個 StringBuilder 。
- l
- Locale
java.util.Locale 在格式化時套用。 若 l 是 null ，則不需局部化。
- 屬性
備註
建立一個包含指定目的地與地點的新格式化器。
Java 文件 java.util.Formatter.Formatter(java.lang.Appendable, java.util.Locale)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
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參數
格式化輸出的目的地。 如果 a 是， null 則會產生一個 StringBuilder 。
- 屬性
備註
建立一個新的格式化器，並指定目的地。
所使用的 locale 是 Locale#getDefault（Locale.Category） 預設 Locale，適用於此 Java 虛擬機實例的 Locale.Category#FORMAT 格式。
Java 文件 java.util.Formatter.Formatter(java.lang.Appendable)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
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
串流作為此格式化器的目的地。
- 屬性
備註
用指定的列印串流建立一個新的格式化器。
所使用的 locale 是 Locale#getDefault（Locale.Category） 預設 Locale，適用於此 Java 虛擬機實例的 Locale.Category#FORMAT 格式。
字元會寫入給定 java.io.PrintStream PrintStream 物件，因此會使用該物件的字元集來編碼。
Java 文件 java.util.Formatter.Formatter(java.io.PrintStream)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
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（） 預設字元集。
所使用的 locale 是 Locale#getDefault（Locale.Category） 預設 Locale，適用於此 Java 虛擬機實例的 Locale.Category#FORMAT 格式。
Java 文件 java.util.Formatter.Formatter(java.io.File)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。