FileRandomAccessStream 類別

定義

命名空間:

Windows.Storage.Streams

支援在指定位置讀取和寫入檔案。

public ref class FileRandomAccessStream sealed : IClosable, IRandomAccessStream

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FileRandomAccessStream final : IClosable, IRandomAccessStream

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FileRandomAccessStream : System.IDisposable, IRandomAccessStream

Public NotInheritable Class FileRandomAccessStream
Implements IDisposable, IRandomAccessStream

繼承

Object Platform::Object IInspectable FileRandomAccessStream

屬性

ContractVersionAttribute MarshalingBehaviorAttribute

實作

IClosable IDisposable IInputStream IOutputStream IRandomAccessStream

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

版本歷程記錄

Windows 版本	SDK 版本	已新增值
1709	16299	OpenAsync (String，FileAccessMode)
1709	16299	OpenAsync (String，FileAccessMode，StorageOpenOptions，FileOpenDisposition)
1709	16299	OpenForUserAsync (User，String，FileAccessMode)
1709	16299	OpenForUserAsync (User，String，FileAccessMode，StorageOpenOptions，FileOpenDisposition)
1709	16299	OpenTransactedWriteAsync (String)
1709	16299	OpenTransactedWriteAsync (String，StorageOpenOptions，FileOpenDisposition)
1709	16299	OpenTransactedWriteForUserAsync (User，String)
1709	16299	OpenTransactedWriteForUserAsync (User，String，StorageOpenOptions，FileOpenDisposition)

屬性

CanRead	取得值，這個值表示是否可以讀取資料流程。
CanWrite	取得值，這個值表示是否可以寫入檔案。
Position	取得資料流程的位元組位移。
Size	取得或設定隨機存取資料流程的大小。

方法

CloneStream()	透過與目前資料流程相同的資源，建立 IRandomAccessStream 的新實例。
Close()	關閉目前的資料流程並釋放系統資源。
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。
FlushAsync()	在循序資料流程中以非同步方式排清資料。
GetInputStreamAt(UInt64)	傳回資料流程中指定位置的輸入資料流程。
GetOutputStreamAt(UInt64)	傳回資料流程中指定位置的輸出資料流程。
OpenAsync(String, FileAccessMode)	根據檔案的路徑，開啟現有檔案的資料流程。
OpenAsync(String, FileAccessMode, StorageOpenOptions, FileOpenDisposition)	將資料流程開啟至指定檔案路徑的檔案。 如果檔案不存在，可以使用 FileOpenDisposition 來建立它。
OpenForUserAsync(User, String, FileAccessMode)	根據檔案路徑和使用者的資訊，開啟使用者至現有檔案的資料流程。
OpenForUserAsync(User, String, FileAccessMode, StorageOpenOptions, FileOpenDisposition)	將使用者的資料流程開啟至指定檔案路徑和使用者資訊的檔案。 如果檔案不存在，可以使用 FileOpenDisposition 來建立它。
OpenTransactedWriteAsync(String)	開啟資料流程，以在檔案的路徑下寫入現有檔案。
OpenTransactedWriteAsync(String, StorageOpenOptions, FileOpenDisposition)	開啟資料流程以寫入指定的檔案路徑。 如果檔案不存在，可以使用 FileOpenDisposition 來建立它。
OpenTransactedWriteForUserAsync(User, String)	根據檔案的路徑和使用者的資訊，開啟使用者至現有檔案的可寫入資料流程。
OpenTransactedWriteForUserAsync(User, String, StorageOpenOptions, FileOpenDisposition)	為使用者開啟可寫入的資料流程，以指定檔案路徑和使用者的資訊。 如果檔案不存在，可以使用 FileOpenDisposition 來建立它。
ReadAsync(IBuffer, UInt32, InputStreamOptions)	傳回非同步位元組讀取器物件。
Seek(UInt64)	將資料流程的位置設定為指定的值。
WriteAsync(IBuffer)	以非同步方式將資料寫入檔案。

另請參閱

• FileInputStream
• FileOutputStream
• InMemoryRandomAccessStream
• RandomAccessStream