IsolatedStorageFile クラス

定義

名前空間:

System.IO.IsolatedStorage

アセンブリ:

System.IO.IsolatedStorage.dll

ソース:

IsolatedStorageFile.cs

ファイルとディレクトリが含まれている分離ストレージ域を表します。

public ref class IsolatedStorageFile sealed : System::IO::IsolatedStorage::IsolatedStorage, IDisposable

public sealed class IsolatedStorageFile : System.IO.IsolatedStorage.IsolatedStorage, IDisposable

type IsolatedStorageFile = class
    inherit IsolatedStorage
    interface IDisposable

Public NotInheritable Class IsolatedStorageFile
Inherits IsolatedStorage
Implements IDisposable

継承

Object

MarshalByRefObject

IsolatedStorage

IsolatedStorageFile

実装

IDisposable

例

分離ストア内にファイルおよびディレクトリを作成する方法を次のコード例で示します。 まず、ユーザー、ドメイン、およびアセンブリによって分離されたストアが取得され、変数に isoStore 配置されます。 CreateDirectoryその後、 メソッドが呼び出されてディレクトリが作成され、クラスの 2 つのインスタンスによって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 対応します。 アプリケーションでは、分離ストレージを使用して、ファイル システム内の特定のパスを指定しなくても、ファイル システムの独自の分離部分にデータを保存できます。 分離ストアは特定のアセンブリにスコープが設定されているため、他のほとんどのマネージド コードはコードのデータにアクセスできません (高度に信頼されたマネージド コードと管理ツールは、他のアセンブリからストアにアクセスできます)。 アンマネージド コードは、任意の分離ストアにアクセスできます。

詳細については、「 分離ストレージ」を参照してください。

この型は IDisposable インターフェイスを実装します。 型の使用が完了したら、直接的または間接的に型を破棄する必要があります。 直接的に型を破棄するには、try/catch ブロック内で Dispose メソッドを呼び出します。 間接的に型を破棄するには、using (C# の場合) または Using (Visual Basic 言語) などの言語構成要素を使用します。 詳細については、IDisposable インターフェイスに関するトピック内の「IDisposable を実装するオブジェクトの使用」セクションを参照してください。

重要

分離ストレージは Windows 8.x Store アプリでは使用できません。 代わりに、Windows ランタイム API に含まれる Windows.Storage 名前空間内のアプリケーション データ クラスを使用して、ローカル データとローカル ファイルを格納します。 詳細については、Windows デベロッパー センターの アプリケーション データ に関する説明を参照してください。

プロパティ

ApplicationIdentity	分離ストレージのスコープを指定するアプリケーション ID を取得します。 (継承元 IsolatedStorage)
AssemblyIdentity	分離ストレージのスコープを指定するために使用するアセンブリ ID を取得します。 (継承元 IsolatedStorage)
AvailableFreeSpace	分離ストレージに使用できる空き容量を表す値を取得します。
CurrentSize	古い. 分離ストレージの現在のサイズを取得します。
DomainIdentity	分離ストレージのスコープを指定するドメイン ID を取得します。 (継承元 IsolatedStorage)
IsEnabled	分離ストレージが有効かどうかを示す値を取得します。
MaximumSize	古い. クォータによる制限内で、分離ストレージとして確保できる領域の最大容量を表す値を取得します。
Quota	分離ストレージに使用できる最大容量を表す値を取得します。
Scope	ストアを分離するためのスコープを指定する IsolatedStorageScope 列挙値を取得します。 (継承元 IsolatedStorage)
SeparatorExternal	ディレクトリ文字列に使用できる円記号を取得します。 派生クラスでオーバーライドするときに、別の文字を返すことができます。 (継承元 IsolatedStorage)
SeparatorInternal	ディレクトリ文字列に使用できるピリオド文字を取得します。 派生クラスでオーバーライドするときに、別の文字を返すことができます。 (継承元 IsolatedStorage)
UsedSize	分離ストレージに使用されている領域のサイズを表す値を取得します。

メソッド

Close()	以前に GetStore(IsolatedStorageScope, Type, Type)、GetUserStoreForAssembly()、または GetUserStoreForDomain() で開いたストアを閉じます。
CopyFile(String, String)	既存のファイルを新しいファイルにコピーします。
CopyFile(String, String, Boolean)	既存のファイルに新しいファイルをコピーし、オプションで既存のファイルを上書きします。
CreateDirectory(String)	分離ストレージのスコープ内にディレクトリを作成します。
CreateFile(String)	分離ストア内にファイルを作成します。
CreateObjRef(Type)	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject)
DeleteDirectory(String)	分離ストレージのスコープ内にあるディレクトリを削除します。
DeleteFile(String)	分離ストレージのスコープ内にあるファイルを削除します。
DirectoryExists(String)	指定したパスが分離ストア内の既存のディレクトリを参照しているかどうかを確認します。
Dispose()	IsolatedStorageFile によって使用されているすべてのリソースを解放します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
FileExists(String)	指定したパスが分離ストア内の既存のファイルを参照しているかどうかを確認します。
GetCreationTime(String)	指定したファイルまたはディレクトリの作成日時を返します。
GetDirectoryNames()	分離ストアのルートにあるディレクトリを列挙します。
GetDirectoryNames(String)	分離ストレージのスコープ内にあり、指定した検索パターンと一致するディレクトリを列挙します。
GetEnumerator(IsolatedStorageScope)	分離ストレージのスコープ内にある IsolatedStorageFile ストアの列挙子を取得します。
GetFileNames()	分離ストアのルートにあるファイルの名前を列挙します。
GetFileNames(String)	検索パターンと一致するファイル名を取得します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetLastAccessTime(String)	指定したファイルまたはディレクトリに最後にアクセスした日付と時刻を返します。
GetLastWriteTime(String)	指定したファイルまたはディレクトリに最後に書き込んだ日付と時刻を返します。
GetLifetimeService()	古い. 対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject)
GetMachineStoreForApplication()	呼び出し元のコードのアプリケーション ID に対応するマシン スコープの分離ストレージを取得します。
GetMachineStoreForAssembly()	呼び出し元のコードのアセンブリ ID に対応するマシン スコープの分離ストレージを取得します。
GetMachineStoreForDomain()	アプリケーション ドメイン ID とアセンブリ ID に対応するマシン スコープの分離ストレージを取得します。
GetPermission(PermissionSet)	派生クラスによって実装された場合は、アクセス許可セットの中から、分離ストレージへのアクセスを表すアクセス許可を返します。 (継承元 IsolatedStorage)
GetStore(IsolatedStorageScope, Object)	特定のアプリケーション ID に対応する分離ストレージを取得します。
GetStore(IsolatedStorageScope, Object, Object)	指定したアプリケーション ドメインとアセンブリの証拠オブジェクトに対応する分離ストレージを取得します。
GetStore(IsolatedStorageScope, Type)	分離スコープおよびアプリケーション ID オブジェクトに対応する分離ストレージを取得します。
GetStore(IsolatedStorageScope, Type, Type)	指定したアプリケーション ドメインとアセンブリの証拠型で指定される分離ストレージ スコープに対応する分離ストレージを取得します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetUserStoreForApplication()	呼び出し元のコードのアプリケーション ID に対応するユーザー スコープの分離ストレージを取得します。
GetUserStoreForAssembly()	呼び出し元のコードのアセンブリ ID に対応するユーザー スコープの分離ストレージを取得します。
GetUserStoreForDomain()	アプリケーション ドメイン ID とアセンブリ ID に対応するユーザー スコープの分離ストレージを取得します。
GetUserStoreForSite()	仮想ホスト ドメインのアプリケーションによって使用されるユーザー スコープの分離ストアを取得します。
IncreaseQuotaTo(Int64)	アプリケーションが大きなクォータ サイズをバイト単位で明示的に要求できるようにします。
InitializeLifetimeService()	古い. このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject)
InitStore(IsolatedStorageScope, Type)	新しい IsolatedStorage オブジェクトを初期化します。 (継承元 IsolatedStorage)
InitStore(IsolatedStorageScope, Type, Type)	新しい IsolatedStorage オブジェクトを初期化します。 (継承元 IsolatedStorage)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
MemberwiseClone(Boolean)	現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject)
MoveDirectory(String, String)	指定されたディレクトリとその内容を新しい場所に移動します。
MoveFile(String, String)	指定したファイルを新しい場所に移動します。オプションで新しいファイル名を指定することもできます。
OpenFile(String, FileMode)	指定したモードでファイルを開きます。
OpenFile(String, FileMode, FileAccess)	読み取り/書き込みのアクセス権を指定し、指定したモードでファイルを開きます。
OpenFile(String, FileMode, FileAccess, FileShare)	読み取り/書き込みアクセス権と共有アクセス許可を指定し、指定したモードでファイルを開きます。
Remove()	分離ストレージ スコープとそのスコープ内のすべての内容を削除します。
Remove(IsolatedStorageScope)	すべての ID に対して指定した分離ストレージ スコープを削除します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

こちらもご覧ください

• 分離ストレージ