NSData.FromFile 方法

定義

命名空間:

Foundation

組件:

Xamarin.iOS.dll

多載

FromFile(String)	藉由將指定檔案的內容載入記憶體中，以建立 NSData。
FromFile(String, NSDataReadingOptions, NSError)	藉由將指定檔案的內容載入記憶體中，以建立 NSData。

FromFile(String)

藉由將指定檔案的內容載入記憶體中，以建立 NSData。

[Foundation.Export("dataWithContentsOfFile:")]
public static Foundation.NSData FromFile (string path);

static member FromFile : string -> Foundation.NSData

參數

path

String

要包裝為 NSData 之檔案名的路徑。

傳回

NSData

新建立的 NSData 物件會公開檔案的內容，或發生錯誤時為 null。

屬性

ExportAttribute

備註

這個版本的 FromFile 會在啟動時將檔案的內容載入記憶體中，請使用 、Foundation.Error) 來使用 mmap。

FromFile(String, NSDataReadingOptions, NSError)

藉由將指定檔案的內容載入記憶體中，以建立 NSData。

[Foundation.Export("dataWithContentsOfFile:options:error:")]
public static Foundation.NSData FromFile (string path, Foundation.NSDataReadingOptions mask, out Foundation.NSError error);

static member FromFile : string * Foundation.NSDataReadingOptions *  -> Foundation.NSData

參數

path

String

要包裝為 NSData 之檔案名的路徑。

mask

NSDataReadingOptions

選項可用來控制檔案載入，可用來強制檔案對應至 VM，而不是藉由讀取內容來載入。

error

NSError

傳回失敗時的錯誤。

傳回

NSData

新建立的 NSData 物件會公開檔案的內容，或發生錯誤時為 null。

屬性

ExportAttribute

備註

根據預設，NSData 會藉由配置記憶體區塊，然後將檔案的內容讀入記憶體中，以載入記憶體中的檔案內容。

Mapped 和 MappedAlways 參數會指示 NSData 使用核心的 介面，將檔案對應至進程位址空間。 這有幾個優點：而不是為進程配置讀取/寫入記憶體，這會變成實際的記憶體使用量，對應的版本會將檔案對應到記憶體中，這表示資料會視需要載入，而不是預先載入。 這也可讓核心在系統記憶體不足時捨棄從記憶體載入的資料。