AppDomain.GetData(String) Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Zdroj:

AppDomain.cs

Získá hodnotu uloženou v aktuální doméně aplikace pro zadaný název.

public:
 System::Object ^ GetData(System::String ^ name);

public object? GetData (string name);

member this.GetData : string -> obj

Public Function GetData (name As String) As Object

Parametry

name

String

Název předdefinované vlastnosti domény aplikace nebo název vlastnosti domény aplikace, kterou jste definovali.

Návraty

Object

Hodnota name vlastnosti nebo null pokud vlastnost neexistuje.

Výjimky

ArgumentNullException

name je null.

AppDomainUnloadedException

Dojde k pokusu o operaci na uvolněné doméně aplikace.

Příklady

Následující příklad vytvoří novou doménu aplikace, nastaví systémovou hodnotu pro doménu a přidá nový pár hodnot pro doménu. Příklad pak ukazuje, jak pomocí GetData metody načíst data z těchto párů hodnot a zobrazit je do konzoly.

using namespace System;
using namespace System::Reflection;

int main()
{
   // appdomain setup information
   AppDomain^ currentDomain = AppDomain::CurrentDomain;
   
   //Create a new value pair for the appdomain
   currentDomain->SetData( "ADVALUE", "Example value" );
   
   //get the value specified in the setdata method
   Console::WriteLine( "ADVALUE is: {0}", currentDomain->GetData( "ADVALUE" ) );
   
   //get a system value specified at appdomainsetup
   Console::WriteLine( "System value for loader optimization: {0}", 
      currentDomain->GetData( "LOADER_OPTIMIZATION" ) );
}

/* This code example produces the following output:

ADVALUE is: Example value
System value for loader optimization: NotSpecified
 */

using System;
using System.Reflection;

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

        //Create a new value pair for the appdomain
        currentDomain.SetData("ADVALUE", "Example value");

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

        //get a system value specified at appdomainsetup
        Console.WriteLine("System value for loader optimization: {0}",
            currentDomain.GetData("LOADER_OPTIMIZATION"));
    }
}

/* This code example produces the following output:

ADVALUE is: Example value
System value for loader optimization: NotSpecified
 */

open System

// appdomain setup information
let currentDomain = AppDomain.CurrentDomain

//Create a new value pair for the appdomain
currentDomain.SetData("ADVALUE", "Example value")

//get the value specified in the setdata method
currentDomain.GetData "ADVALUE"
|> printfn "ADVALUE is: %O"

//get a system value specified at appdomainsetup
currentDomain.GetData "LOADER_OPTIMIZATION"
|> printfn "System value for loader optimization: %O"

(* This code example produces the following output:

ADVALUE is: Example value
System value for loader optimization: NotSpecified
*)

Imports System.Reflection

Class ADGetData   
   
   Public Shared Sub Main()
      ' appdomain setup information
      Dim currentDomain As AppDomain = AppDomain.CurrentDomain
      
      'Create a new value pair for the appdomain
      currentDomain.SetData("ADVALUE", "Example value")
      
      'get the value specified in the setdata method
      Console.WriteLine(("ADVALUE is: " & currentDomain.GetData("ADVALUE")))
      
      'get a system value specified at appdomainsetup
      Console.WriteLine("System value for loader optimization: {0}", _
         currentDomain.GetData("LOADER_OPTIMIZATION"))

   End Sub 
End Class 

' This code example produces the following output:
'
'ADVALUE is: Example value
'System value for loader optimization: NotSpecified

Poznámky

Tato metoda slouží k načtení hodnoty položky v interní mezipaměti párů název-data, které popisují vlastnosti této instance nástroje AppDomain. Všimněte si, že při porovnání name s názvy párů klíč-hodnota se rozlišují velká a malá písmena.

Mezipaměť automaticky obsahuje předdefinované systémové položky, které se vloží při vytvoření domény aplikace. Jejich hodnoty můžete zkontrolovat pomocí GetData metody nebo ekvivalentních AppDomainSetup vlastností.

Pomocí metody můžete vložit nebo upravit vlastní dvojice jmen a dat definovaných uživatelem SetData a zkontrolovat jejich hodnoty pomocí GetData metody .

Následující tabulka popisuje name každou předdefinovanou položku systému a její odpovídající AppDomainSetup vlastnost.

Hodnota "name"	Vlastnost
"APPBASE"	AppDomainSetup.ApplicationBase
"APP_CONFIG_FILE"	AppDomainSetup.ConfigurationFile
"APP_LAUNCH_URL"	(bez vlastnosti) "APP_LAUNCH_URL" představuje adresu URL původně požadovanou uživatelem před jakýmkoli přesměrováním. Je k dispozici, pouze pokud byla aplikace spuštěna v prohlížeči. Ne všechny prohlížeče tuto hodnotu poskytují.
"APP_NAME"	AppDomainSetup.ApplicationName
"BINPATH_PROBE_ONLY"	AppDomainSetup.PrivateBinPathProbe
"CACHE_BASE"	AppDomainSetup.CachePath
"CODE_DOWNLOAD_DISABLED"	AppDomainSetup.DisallowCodeDownload
"DEV_PATH"	(bez vlastnosti)
"DISALLOW_APP"	AppDomainSetup.DisallowPublisherPolicy
"DISALLOW_APP_BASE_PROBING"	AppDomainSetup.DisallowApplicationBaseProbing
"DISALLOW_APP_REDIRECTS"	AppDomainSetup.DisallowBindingRedirects
"DYNAMIC_BASE"	AppDomainSetup.DynamicBase
"FORCE_CACHE_INSTALL"	AppDomainSetup.ShadowCopyFiles
"LICENSE_FILE" neboli řetězec specifický pro aplikaci	AppDomainSetup.LicenseFile
"LOADER_OPTIMIZATION"	AppDomainSetup.LoaderOptimization
"LOCATION_URI"	(bez vlastnosti)
"PRIVATE_BINPATH"	AppDomainSetup.PrivateBinPath
"REGEX_DEFAULT_MATCH_TIMEOUT"	Regex.MatchTimeout "REGEX_DEFAULT_MATCH_TIMEOUT" není systémová položka a její hodnota může být nastavena voláním SetData metody.
"SHADOW_COPY_DIRS"	AppDomainSetup.ShadowCopyDirectories

Viz také

• SetData(String, Object)