NSData.FromFile 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
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 物件會公開檔案的內容,或發生錯誤時為 null。
- 屬性
備註
這個版本的 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 物件會公開檔案的內容,或發生錯誤時為 null。
- 屬性
備註
根據預設,NSData 會藉由配置記憶體區塊,然後將檔案的內容讀入記憶體中,以載入記憶體中的檔案內容。
Mapped 和 MappedAlways 參數會指示 NSData 使用核心的 介面,將檔案對應至進程位址空間。 這有幾個優點:而不是為進程配置讀取/寫入記憶體,這會變成實際的記憶體使用量,對應的版本會將檔案對應到記憶體中,這表示資料會視需要載入,而不是預先載入。 這也可讓核心在系統記憶體不足時捨棄從記憶體載入的資料。