IsolatedStorageFile.GetMachineStoreForDomain メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

IsolatedStorageFile.GetMachineStoreForDomain メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

アプリケーションドメイン ID とアセンブリ ID に対応するマシンスコープの分離ストレージを取得します。

名前空間: System.IO.IsolatedStorage
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Function GetMachineStoreForDomain
 As IsolatedStorageFile

Visual Basic (使用法)

Dim returnValue As IsolatedStorageFile

returnValue = IsolatedStorageFile.GetMachineStoreForDomain

public static IsolatedStorageFile GetMachineStoreForDomain
 ()

C++

public:
static IsolatedStorageFile^ GetMachineStoreForDomain ()

public static IsolatedStorageFile GetMachineStoreForDomain
 ()

JScript

public static function GetMachineStoreForDomain
 () : IsolatedStorageFile

戻り値
アプリケーションドメイン ID とアセンブリ ID の組み合わせに基づく IsolatedStorageScope に対応する IsolatedStorageFile オブジェクト。

例外

例外の種類	条件
SecurityException	分離ストレージに対して必要なアクセス許可が与えられていません。
IsolatedStorageException	ストアを開くことができません。または指定したアセンブリには、分離ストアを作成するためのアクセス許可が不足しています。

例外の種類

条件

SecurityException

分離ストレージに対して必要なアクセス許可が与えられていません。

IsolatedStorageException

ストアを開くことができません。

または

指定したアセンブリには、分離ストアを作成するためのアクセス許可が不足しています。

解説

異なるアプリケーションのコンテキストで使用される場合、同じアセンブリコードであっても異なる分離ストアを使用します。

GetUserStoreForDomain は、次のコードと機能的に同等です。

Visual Basic

GetStore(IsolatedStorageScope.Machine Or IsolatedStorageScope.Assembly
 Or IsolatedStorageScope.Domain, Nothing,
 Nothing)
GetStore(IsolatedStorageScope.Assembly | IsolatedStorageScope.Domain | IsolatedStorageScope.Machine,
 null, null);

同じアプリケーションドメイン内で実行されている異なるアセンブリは、必ず個別の分離ストアを保有します。

メモ
アセンブリがインストールされているアプリケーションドメインに IsolatedStorageFilePermission がない場合、GetUserStoreForDomain は、クォータなしで IsolatedStorageFile オブジェクトを返します。クォータを持たない IsolatedStorageFile オブジェクトを使用して IsolatedStorageFile オブジェクトを後で作成しようとすると、IsolatedStorageException が発生して失敗します。

メモ

アセンブリがインストールされているアプリケーションドメインに IsolatedStorageFilePermission がない場合、GetUserStoreForDomain は、クォータなしで IsolatedStorageFile オブジェクトを返します。クォータを持たない IsolatedStorageFile オブジェクトを使用して IsolatedStorageFile オブジェクトを後で作成しようとすると、IsolatedStorageException が発生して失敗します。

使用例

GetUserStoreForDomain メソッドのコード例を次に示します。この例のコンテキスト全体については、IsolatedStorageFile の概要を参照してください。

Visual Basic

Dim isoFile As IsolatedStorageFile
isoFile = IsolatedStorageFile.GetUserStoreForDomain()

' Open or create a writable file.
Dim isoStream As New IsolatedStorageFileStream(Me.userName,
 FileMode.OpenOrCreate, _
    FileAccess.Write, isoFile)

Dim writer As New StreamWriter(isoStream)
writer.WriteLine(Me.NewsUrl)
writer.WriteLine(Me.SportsUrl)
' Calculate the amount of space used to record the user's preferences.
Dim d As Double = Convert.ToDouble(isoFile.CurrentSize)
 / Convert.ToDouble(isoFile.MaximumSize)
Console.WriteLine(("CurrentSize = " & isoFile.CurrentSize.ToString()))
Console.WriteLine(("MaximumSize = " & isoFile.MaximumSize.ToString()))
' StreamWriter.Close implicitly closes isoStream.
writer.Close()
isoFile.Dispose()
isoFile.Close()
Return d

IsolatedStorageFile isoFile;
isoFile = IsolatedStorageFile.GetUserStoreForDomain();

// Open or create a writable file.
IsolatedStorageFileStream isoStream =
    new IsolatedStorageFileStream(this.userName
,
    FileMode.OpenOrCreate,
    FileAccess.Write,
    isoFile);

StreamWriter writer = new StreamWriter(isoStream);
writer.WriteLine(this.NewsUrl);
writer.WriteLine(this.SportsUrl);
// Calculate the amount of space used to record the user's preferences.
double d = isoFile.CurrentSize / isoFile.MaximumSize;
Console.WriteLine("CurrentSize = " + isoFile.CurrentSize.ToString());
Console.WriteLine("MaximumSize = " + isoFile.MaximumSize.ToString());
// StreamWriter.Close implicitly closes isoStream.
writer.Close();
isoFile.Dispose();
isoFile.Close();
return d;

C++

IsolatedStorageFile^ isoFile;
isoFile = IsolatedStorageFile::GetUserStoreForDomain();

// Open or create a writable file.
IsolatedStorageFileStream^ isoStream = gcnew IsolatedStorageFileStream( this->userName,FileMode::OpenOrCreate,FileAccess::Write,isoFile
 );
StreamWriter^ writer = gcnew StreamWriter( isoStream );
writer->WriteLine( this->NewsUrl );
writer->WriteLine( this->SportsUrl );

// Calculate the amount of space used to record the user's preferences.
double d = isoFile->CurrentSize / isoFile->MaximumSize;
Console::WriteLine( "CurrentSize = {0}", isoFile->CurrentSize.ToString()
 );
Console::WriteLine( "MaximumSize = {0}", isoFile->MaximumSize.ToString()
 );
writer->Close();
isoFile->Close();
isoStream->Close();
return d;