PathIO Class

提供 Helper 方法,以使用絕對檔案路徑或 URI 來讀取和寫入檔案。

語法


var pathIO = Windows.Storage.PathIO;

屬性

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

成員

PathIO類別 有這些類型的成員:

方法

The PathIO 類別 有這些方法。 使用 C#、Visual Basic 和 C++,也會繼承來自以下項目的方法 Object 類別.

方法說明
AppendLinesAsync(String, IIterable(String)) Appends lines of text to the file at the specified path or Uniform Resource Identifier (URI).
AppendLinesAsync(String, IIterable(String), UnicodeEncoding) Appends lines of text to the file at the specified path or Uniform Resource Identifier (URI) using the specified character encoding.
AppendTextAsync(String, String) Appends text to the file at the specified path or Uniform Resource Identifier (URI).
AppendTextAsync(String, String, UnicodeEncoding) Appends text to the file at the specified path or Uniform Resource Identifier (URI) using the specified character encoding.
ReadBufferAsync Reads the contents of the file at the specified path or Uniform Resource Identifier (URI) and returns a buffer.
ReadLinesAsync(String) Reads the contents of the file at the specified path or Uniform Resource Identifier (URI) and returns lines of text.
ReadLinesAsync(String, UnicodeEncoding) Reads the contents of the file at the specified path or Uniform Resource Identifier (URI) using the specified character encoding and returns lines of text.
ReadTextAsync(String) Reads the contents of the file at the specified path or Uniform Resource Identifier (URI) and returns text.
ReadTextAsync(String, UnicodeEncoding) Reads the contents of the file at the specified path or Uniform Resource Identifier (URI) using the specified character encoding and returns text.
WriteBufferAsync Writes data from a buffer to the file at the specified path or Uniform Resource Identifier (URI).
WriteBytesAsync Writes a single byte of data to the file at the specified path or Uniform Resource Identifier (URI).
WriteLinesAsync(String, IIterable(String)) Writes lines of text to the file at the specified path or Uniform Resource Identifier (URI).
WriteLinesAsync(String, IIterable(String), UnicodeEncoding) Writes lines of text to the file at the specified path or Uniform Resource Identifier (URI) using the specified character encoding.
WriteTextAsync(String, String) Writes text to the file at the specified path or Uniform Resource Identifier (URI).
WriteTextAsync(String, String, UnicodeEncoding) Writes text to the file at the specified path or Uniform Resource Identifier (URI) using the specified character encoding.

 

備註

這個類別是靜態的,而且無法具現化。請改為直接呼叫方法。

附註  若要使用路徑或 URI 讀取或寫入檔案,您必須擁有存取檔案位置的權限。若要深入了解您的應用程式對哪些位置具有存取權限,請參閱 Windows 市集應用程式中的檔案存取和權限

您可以指定應用程式 URI 以讀取或寫入應用程式專屬位置中的檔案,像是您的應用程式資料的資料夾 ("ms-appdata://")。若要進一步了解應用程式 URI,請參閱如何參考內容

範例

您可以使用 writeTextAsync(filePathOrURI, contents) 將文字寫入檔案,像這樣:



if (file !== null) {
    Windows.Storage.PathIO.writeTextAsync(filePathOrURI, "Swift as a shadow").done(function () {
        // Perform additional tasks after file is written
    },
    // Handle errors with an error function
    function (error) {
        // Handle errors encountered during write
    });
}

在範例中,filePathOrURI 是區域變數,其包含要讀取之檔案的 URI (例如應用程式 URI "ms-appdata://sampleFile.dat") 或檔案系統路徑 (例如 C:\examplepath\sampleFile.dat)。

雖然 writeTextAsync 方法沒有傳回值,您仍然可以在文字寫入檔案之後執行其他工作,如範例所示。

您可以使用 readTextAsync(filePathOrURI) 從檔案讀取文字,像這樣:


if (file !== null) {
    Windows.Storage.PathIO.readTextAsync(filePathOrURI).done(function (fileContent) {
        // Process content read from the file
    },
    // Handle errors with an error function
    function (error) {
        // Handle errors encountered during read
    });
}

在範例中,filePathOrURI 是區域變數,其包含要讀取之檔案的 URI (例如應用程式 URI "ms-appdata://sampleFile.dat") 或檔案系統路徑 (例如 C:\examplepath\sampleFile.dat)。

readTextAsync 完成之後,fileContent 變數會取得檔案的內容做為文字字串。接著您可以依適合的情況處理內容。

如需其他相關的範例,請參閱檔案存取範例FileIO

需求

最低支援的用戶端

Windows 8 [僅限 Windows 市集應用程式]

最低支援的伺服器

Windows Server 2012 [僅限 Windows 市集應用程式]

命名空間

Windows.Storage
Windows::Storage [C++]

中繼資料

Windows.winmd

另請參閱

檔案存取範例
FileIO

 

 

顯示:
© 2014 Microsoft