IsolatedStorageFile.GetUserStoreForDomain-Methode

Ruft benutzerbezogenen isolierten Speicher für die Anwendungsdomänen- und Assemblyidentität ab.

Namespace: System.IO.IsolatedStorage
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Shared Function GetUserStoreForDomain As IsolatedStorageFile
'Usage
Dim returnValue As IsolatedStorageFile

returnValue = IsolatedStorageFile.GetUserStoreForDomain

public static IsolatedStorageFile GetUserStoreForDomain ()

public:
static IsolatedStorageFile^ GetUserStoreForDomain ()

public static IsolatedStorageFile GetUserStoreForDomain ()

public static function GetUserStoreForDomain () : IsolatedStorageFile

Rückgabewert

Ein IsolatedStorageFile-Objekt, das dem IsolatedStorageScope entspricht, der auf einer Kombination der Identitäten von Anwendungsdomäne und Assembly basiert.

Ausnahmen

Ausnahmetyp	Bedingung
SecurityException	Es wurde keine ausreichende Berechtigung für den isolierten Speicher gewährt.
IsolatedStorageException	Der Speicher konnte nicht geöffnet werden. – oder – Die angegebene Assembly verfügt nicht über ausreichende Berechtigungen für das Erstellen isolierter Speicher.

Hinweise

Derselbe Assemblycode verwendet verschiedene isolierte Speicher, wenn er im Kontext unterschiedlicher Anwendungen verwendet wird.

GetUserStoreForDomain entspricht hinsichtlich ihrer Funktion dem folgenden Code:

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

Unterschiedliche Assemblys, die in derselben Anwendungsdomäne ausgeführt werden, verwenden stets unterschiedliche isolierte Speicher.

Hinweis

GetUserStoreForDomain gibt ein IsolatedStorageFile-Objekt ohne Kontingent zurück, wenn die Anwendungsdomäne, in der die Assembly installiert ist, nicht über eine IsolatedStorageFilePermission verfügt. Bei nachfolgenden Versuchen, ein IsolatedStorageFile-Objekt unter Verwendung des IsolatedStorageFile-Objekts zu erstellen, das nicht über ein Kontingent verfügt, tritt ein Fehler mit einer IsolatedStorageException auf.

Beispiel

Im folgenden Codebeispiel wird die GetUserStoreForDomain-Methode veranschaulicht. Den vollständigen Kontext dieses Beispiels finden Sie in der Übersicht über IsolatedStorageFile.

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;

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;

.NET Framework-Sicherheit

• IsolatedStorageFilePermission  zum Verwenden von isoliertem Speicher. Zugeordnete Enumeration: DomainIsolationByUser
• ReflectionPermission  beim Laden mit später Bindung durch Mechanismen, z. B. Type.InvokeMember. Zugeordnete Enumeration: ReflectionPermissionFlag.MemberAccess.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

IsolatedStorageFile-Klasse
IsolatedStorageFile-Member
System.IO.IsolatedStorage-Namespace