FileOutputStream 建構函式

定義

命名空間:: Java.IO

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
FileOutputStream(File)	建立一個檔案輸出串流，以寫入由指定 `File` 物件所代表的檔案。
FileOutputStream(FileDescriptor)	建立一個檔案輸出串流，寫入指定的檔案描述符，該描述符代表與檔案系統中實際檔案的現有連線。
FileOutputStream(String)	建立一個檔案輸出串流，以寫入指定名稱的檔案。
FileOutputStream(File, Boolean)	建立一個檔案輸出串流，以寫入由指定 `File` 物件所代表的檔案。
FileOutputStream(IntPtr, JniHandleOwnership)	建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。
FileOutputStream(String, Boolean)	建立一個檔案輸出串流，以寫入指定名稱的檔案。

FileOutputStream(File)

建立一個檔案輸出串流，以寫入由指定 File 物件所代表的檔案。

[Android.Runtime.Register(".ctor", "(Ljava/io/File;)V", "")]
public FileOutputStream(Java.IO.File? file);

[<Android.Runtime.Register(".ctor", "(Ljava/io/File;)V", "")>]
new Java.IO.FileOutputStream : Java.IO.File -> Java.IO.FileOutputStream

參數

file: File

該檔案將被開啟以供撰寫。

屬性: RegisterAttribute

例外狀況

FileNotFoundException

如果檔案無法開啟以進行寫入。

備註

建立一個檔案輸出串流，以寫入由指定 File 物件所代表的檔案。會建立一個新 FileDescriptor 物件來表示這個檔案連線。

首先，若存在安全管理器，其 checkWrite 方法會以參數所代表 file 的路徑作為參數來呼叫。

如果檔案存在但是目錄而非一般檔案，或不存在但無法建立，或因其他原因無法開啟，則會拋出 a FileNotFoundException 。

Java 文件 java.io.FileOutputStream.FileOutputStream(java.io.File)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

FileOutputStream(FileDescriptor)

建立一個檔案輸出串流，寫入指定的檔案描述符，該描述符代表與檔案系統中實際檔案的現有連線。

[Android.Runtime.Register(".ctor", "(Ljava/io/FileDescriptor;)V", "")]
public FileOutputStream(Java.IO.FileDescriptor? fdObj);

[<Android.Runtime.Register(".ctor", "(Ljava/io/FileDescriptor;)V", "")>]
new Java.IO.FileOutputStream : Java.IO.FileDescriptor -> Java.IO.FileOutputStream

參數

fdObj: FileDescriptor

要開啟以進行寫入的檔案描述符

屬性: RegisterAttribute

例外狀況

NullPointerException

若 fd 為零。

備註

建立一個檔案輸出串流，寫入指定的檔案描述符，該描述符代表與檔案系統中實際檔案的現有連線。

首先，如果存在安全管理器，其 checkWrite 方法會以檔案描述符 fdObj 參數作為參數來呼叫。

若 fdObj 為零，則拋出 a NullPointerException 。

若 fdObj 為， java.io.FileDescriptor#valid() invalid此構造子不會拋出例外。然而，如果在結果串流上呼叫這些方法來嘗試對串流進行 I/O，則會拋出 an IOException 。

Android 專屬警告： #close() 方法無法關閉所提供的， fdObj 因為這個物件不擁有檔案描述符，但呼叫者擁有。來電者可以打電話 android.system.Os#close(FileDescriptor) 關閉 FD。

Java 文件 java.io.FileOutputStream.FileOutputStream(java.io.FileDescriptor)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

FileOutputStream(String)

建立一個檔案輸出串流，以寫入指定名稱的檔案。

[Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "")]
public FileOutputStream(string? name);

[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "")>]
new Java.IO.FileOutputStream : string -> Java.IO.FileOutputStream

參數

name: String

系統依賴的檔名

屬性: RegisterAttribute

例外狀況

FileNotFoundException

如果檔案無法開啟以進行寫入。

備註

建立一個檔案輸出串流，以寫入指定名稱的檔案。會建立一個新 FileDescriptor 物件來表示這個檔案連線。

首先，如果存在安全管理器，其 checkWrite 方法會以參數作為 name 呼叫。

如果檔案存在但是目錄而非一般檔案，或不存在但無法建立，或因其他原因無法開啟，則會拋出 a FileNotFoundException 。

Java 文件 java.io.FileOutputStream.FileOutputStream(java.lang.String)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

FileOutputStream(File, Boolean)

建立一個檔案輸出串流，以寫入由指定 File 物件所代表的檔案。

[Android.Runtime.Register(".ctor", "(Ljava/io/File;Z)V", "")]
public FileOutputStream(Java.IO.File? file, bool append);

[<Android.Runtime.Register(".ctor", "(Ljava/io/File;Z)V", "")>]
new Java.IO.FileOutputStream : Java.IO.File * bool -> Java.IO.FileOutputStream

參數

file: File

該檔案將被開啟以供撰寫。

append: Boolean

若 true，則位元組會寫入檔案的末尾，而非起始

屬性: RegisterAttribute

例外狀況

FileNotFoundException

如果檔案無法開啟寫入。

備註

建立一個檔案輸出串流，以寫入由指定 File 物件所代表的檔案。若第二個參數為 true，則位元組會寫入檔案末尾而非開頭。會建立一個新 FileDescriptor 物件來表示這個檔案連線。

首先，若存在安全管理器，其 checkWrite 方法會以參數所代表 file 的路徑作為參數來呼叫。

如果檔案存在但是目錄而非一般檔案，或不存在但無法建立，或因其他原因無法開啟，則會拋出 a FileNotFoundException 。

在 1.4 版本加入。

Java 文件 java.io.FileOutputStream.FileOutputStream(java.io.File, boolean)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

FileOutputStream(IntPtr, JniHandleOwnership)

建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。

protected FileOutputStream(IntPtr javaReference, Android.Runtime.JniHandleOwnership transfer);

new Java.IO.FileOutputStream : nativeint * Android.Runtime.JniHandleOwnership -> Java.IO.FileOutputStream

參數

javaReference: IntPtr
nativeint

IntPtrA 包含一個 Java 原生介面（JNI）物件參考。

transfer: JniHandleOwnership

JniHandleOwnershipA 指示如何處理javaReference

備註

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

FileOutputStream(String, Boolean)

建立一個檔案輸出串流，以寫入指定名稱的檔案。

[Android.Runtime.Register(".ctor", "(Ljava/lang/String;Z)V", "")]
public FileOutputStream(string? name, bool append);

[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;Z)V", "")>]
new Java.IO.FileOutputStream : string * bool -> Java.IO.FileOutputStream

參數

name: String

系統依賴的檔案名稱

append: Boolean

若 true，則位元組會寫入檔案的末尾，而非起始

屬性: RegisterAttribute

例外狀況

FileNotFoundException

如果檔案無法開啟寫入。

備註

建立一個檔案輸出串流，以寫入指定名稱的檔案。若第二個參數為 true，則位元組會寫入檔案末尾而非開頭。會建立一個新 FileDescriptor 物件來表示這個檔案連線。

首先，如果存在安全管理器，其 checkWrite 方法會以參數作為 name 呼叫。

如果檔案存在但是目錄而非一般檔案，或不存在但無法建立，或因其他原因無法開啟，則會拋出 a FileNotFoundException 。

在 1.1 版本中加入。

Java 文件 java.io.FileOutputStream.FileOutputStream(java.lang.String, boolean)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於