IsolatedStorageFile 類別
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
代表包含檔案和目錄的隔離儲存區 (Isolated Storage) 之區域。
public ref class IsolatedStorageFile sealed : IDisposable
public ref class IsolatedStorageFile sealed : System::IO::IsolatedStorage::IsolatedStorage, IDisposable
public sealed class IsolatedStorageFile : IDisposable
public sealed class IsolatedStorageFile : System.IO.IsolatedStorage.IsolatedStorage, IDisposable
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class IsolatedStorageFile : System.IO.IsolatedStorage.IsolatedStorage, IDisposable
type IsolatedStorageFile = class
interface IDisposable
type IsolatedStorageFile = class
inherit IsolatedStorage
interface IDisposable
[<System.Runtime.InteropServices.ComVisible(true)>]
type IsolatedStorageFile = class
inherit IsolatedStorage
interface IDisposable
Public NotInheritable Class IsolatedStorageFile
Implements IDisposable
Public NotInheritable Class IsolatedStorageFile
Inherits IsolatedStorage
Implements IDisposable
- 繼承
-
IsolatedStorageFile
- 繼承
- 屬性
- 實作
下列程式碼範例說明如何在隔離存放區中建立檔案和目錄。 首先,會擷取使用者、網域和元件隔離的存放區,並將其放在變數中 isoStore
。 接著會 CreateDirectory 呼叫 方法來建立目錄,而 類別的 IsolatedStorageFileStream 兩個實例會在這些目錄中建立檔案。
using System;
using System.IO;
using System.IO.IsolatedStorage;
public class CreatingFilesDirectories
{
public static void Main()
{
using (IsolatedStorageFile isoStore = IsolatedStorageFile.GetStore(IsolatedStorageScope.User | IsolatedStorageScope.Domain | IsolatedStorageScope.Assembly, null, null))
{
isoStore.CreateDirectory("TopLevelDirectory");
isoStore.CreateDirectory("TopLevelDirectory/SecondLevel");
isoStore.CreateDirectory("AnotherTopLevelDirectory/InsideDirectory");
Console.WriteLine("Created directories.");
isoStore.CreateFile("InTheRoot.txt");
Console.WriteLine("Created a new file in the root.");
isoStore.CreateFile("AnotherTopLevelDirectory/InsideDirectory/HereIAm.txt");
Console.WriteLine("Created a new file in the InsideDirectory.");
}
}
}
Imports System.IO
Imports System.IO.IsolatedStorage
Module Module1
Sub Main()
Using isoStore As IsolatedStorageFile = IsolatedStorageFile.GetStore(IsolatedStorageScope.User Or IsolatedStorageScope.Assembly Or IsolatedStorageScope.Domain, Nothing, Nothing)
isoStore.CreateDirectory("TopLevelDirectory")
isoStore.CreateDirectory("TopLevelDirectory/SecondLevel")
isoStore.CreateDirectory("AnotherTopLevelDirectory/InsideDirectory")
Console.WriteLine("Created directories.")
isoStore.CreateFile("InTheRoot.txt")
Console.WriteLine("Created a new file in the root.")
isoStore.CreateFile("AnotherTopLevelDirectory/InsideDirectory/HereIAm.txt")
Console.WriteLine("Created a new file in the InsideDirectory.")
End Using
End Sub
End Module
此物件會對應至特定隔離儲存範圍,其中物件所代表的 IsolatedStorageFileStream 檔案存在。 應用程式可以使用隔離儲存區將資料儲存在檔案系統本身的隔離部分,而不需要在檔案系統內指定特定路徑。 由於隔離存放區的範圍僅限於特定元件,因此大部分的其他 Managed 程式代碼將無法存取程式代碼的數據 (高度信任的 Managed 程式代碼,而管理工具可以從其他元件存取存放區) 。 Unmanaged 程式代碼可以存取任何隔離的存放區。
如需詳細資訊,請參閱 隔離儲存區。
此型別代表 IDisposable 介面。 當您完成使用型別時,您應該直接或間接處置它。 若要直接處置型別,請呼叫其 try
/catch
區塊中的 Dispose 方法。 若要間接處置它,請使用語言建構函式,例如 using
(在 C# 中) 或 Using
(在 Visual Basic 中)。 如需詳細資訊,請參閱 IDisposable 介面文章中的<使用實作 IDisposable 的物件>一節。
重要
隔離儲存區不適用於 Windows 8.x 市集應用程式。 請改用 Windows 執行階段 API 所提供的 Windows.Storage
命名空間來儲存本機資料與檔案。 如需詳細資訊,請參閱 Windows 開發人員中心的應用程式資料。
Application |
取得限定隔離儲存區 (Isolated Storage) 範圍的應用程式識別 (Identity)。 (繼承來源 IsolatedStorage) |
Assembly |
取得用來限定隔離儲存區範圍的組件識別 (Assembly Identity)。 (繼承來源 IsolatedStorage) |
Available |
取得值,這個值表示隔離儲存區的可用空間量。 |
Available |
在衍生類別中覆寫時,取得隔離儲存區的可用空間 (以位元組為單位)。 (繼承來源 IsolatedStorage) |
Current |
已淘汰.
已淘汰.
取得隔離儲存區目前的大小。 |
Domain |
取得限定隔離儲存區範圍的網域識別。 (繼承來源 IsolatedStorage) |
Is |
取得值,這個值表示隔離儲存區是否啟用。 |
Maximum |
已淘汰.
已淘汰.
取得值,表示隔離儲存區在配額建立起來的限制內可以使用的最大空間量。 |
Quota |
取得值,這個值表示隔離儲存區的最大可用空間量。 |
Quota |
在衍生類別中覆寫時取得值,這個值表示隔離儲存區空間的最大可用空間量。 (繼承來源 IsolatedStorage) |
Scope |
取得 IsolatedStorageScope 列舉型別值,指定用來隔離存放區的範圍。 (繼承來源 IsolatedStorage) |
Separator |
取得可以用在目錄字串中的反斜線字元。 當在衍生類別中覆寫時,可能會傳回另一個字元。 (繼承來源 IsolatedStorage) |
Separator |
取得可以用在目錄字串中的句號字元。 當在衍生類別中覆寫時,可能會傳回另一個字元。 (繼承來源 IsolatedStorage) |
Used |
取得值,這個值表示隔離儲存區的已使用空間量。 |
Used |
在衍生類別中覆寫時,取得值,這個值表示隔離儲存區的已使用空間量。 (繼承來源 IsolatedStorage) |
產品 | 版本 |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
UWP | 10.0 |