AppDomain.GetData-Methode

Ruft den in der aktuellen Anwendungsdomäne gespeicherten Wert für den angegebenen Namen ab.

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

Syntax

'Declaration
Public Function GetData ( _
    name As String _
) As Object
'Usage
Dim instance As AppDomain
Dim name As String
Dim returnValue As Object

returnValue = instance.GetData(name)
public Object GetData (
    string name
)
public:
virtual Object^ GetData (
    String^ name
) sealed
public final Object GetData (
    String name
)
public final function GetData (
    name : String
) : Object

Parameter

  • name
    Der Name einer vordefinierten Anwendungsdomäneneigenschaft oder der Name einer von Ihnen definierten Anwendungsdomäneneigenschaft.

Rückgabewert

Der Wert der name-Eigenschaft.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

name ist NULL (Nothing in Visual Basic).

AppDomainUnloadedException

Es wird versucht, die Operationen für eine entladene Anwendungsdomäne auszuführen.

Hinweise

Mit dieser Methode können Sie den Wert eines Eintrags in einem internen Cache von Name-Daten-Paaren abrufen, durch die die Eigenschaften dieser Instanz von AppDomain beschrieben werden.

Der Cache enthält automatisch vordefinierte Systemeinträge, die beim Erstellen der Anwendungsdomäne eingefügt werden. Sie können diese Werte mit der GetData-Methode oder anhand der äquivalenten AppDomainSetup-Eigenschaften prüfen.

Mit der SetData-Methode können Sie Ihre eigenen benutzerdefinierten Name-Daten-Paare einfügen oder bearbeiten und mit der GetData-Methode die aktuellen Werte überprüfen.

In der folgenden Tabelle werden der name jedes vordefinierten Systemeintrags und die dazugehörige AppDomainSetup-Eigenschaft beschrieben.

Wert von 'name'

Eigenschaft

"APPBASE"

ApplicationBase

"LOADER_OPTIMIZATION"

LoaderOptimization

"APP_CONFIG_FILE"

ConfigurationFile

"DYNAMIC_BASE"

DynamicBase

"DEV_PATH"

(keine Eigenschaft)

"APP_NAME"

ApplicationName

"PRIVATE_BINPATH"

PrivateBinPath

"BINPATH_PROBE_ONLY"

PrivateBinPathProbe

"SHADOW_COPY_DIRS"

ShadowCopyDirectories

"FORCE_CACHE_INSTALL"

ShadowCopyFiles

"CACHE_BASE"

CachePath

(anwendungsspezifisch)

LicenseFile

Beispiel

Imports System
Imports System.Reflection



Class ADGetData
   
   
   Public Shared Sub Main()
      ' appdomain setup information
      Dim currentDomain As AppDomain = AppDomain.CurrentDomain
      
      'set predefined system variable application name
      Dim dataName As [String] = "APP_NAME"
      Dim setappname As [String] = "MyApplication"
      currentDomain.SetData(dataName, setappname)
      
      'Create a new value pair for the appdomain
      Dim dataValue As [String] = "ADVALUE"
      Dim advalue As Int32 = 6
      currentDomain.SetData(dataValue, advalue)
      
      'get the value specified in the setdata method
      Console.WriteLine((" ADVALUE is: " + currentDomain.GetData("ADVALUE")))
      
      'get system value specified at appdomainsetup
      Console.WriteLine(("System value for application name:" + currentDomain.GetData("APP_NAME")))
   End Sub 'Main 
End Class 'ADGetData
using System;
using System.Reflection;

class ADGetData 
{

    public static void Main() 
    {
        // appdomain setup information
        AppDomain currentDomain = AppDomain.CurrentDomain;

        //set predefined system variable application name
        String dataName = "APP_NAME";
        String setappname = "MyApplication";
        currentDomain.SetData(dataName, setappname);

        //Create a new value pair for the appdomain
        String dataValue = "ADVALUE";
        Int32 advalue = 6;
        currentDomain.SetData(dataValue, advalue);

        //get the value specified in the setdata method
        Console.WriteLine(" ADVALUE is: " + currentDomain.GetData("ADVALUE"));

        //get system value specified at appdomainsetup
        Console.WriteLine("System value for application name:" + currentDomain.GetData("APP_NAME"));
        
    }
   
    
}
using namespace System;
using namespace System::Reflection;
int main()
{
   
   // appdomain setup information
   AppDomain^ currentDomain = AppDomain::CurrentDomain;
   
   //set predefined system variable application name
   String^ dataName = "APP_NAME";
   String^ setappname = "MyApplication";
   currentDomain->SetData( dataName, setappname );
   
   //Create a new value pair for the appdomain
   String^ dataValue = "ADVALUE";
   Int32 advalue = 6;
   currentDomain->SetData( dataValue, advalue );
   
   //get the value specified in the setdata method
   Console::WriteLine( " ADVALUE is: {0}", currentDomain->GetData( "ADVALUE" ) );
   
   //get system value specified at appdomainsetup
   Console::WriteLine( "System value for application name: {0}", currentDomain->GetData( "APP_NAME" ) );
}

.NET Framework-Sicherheit

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

AppDomain-Klasse
AppDomain-Member
System-Namespace
SetData