AppDomain.GetData(String) Metodo

Definizione

Ottiene il valore archiviato nel dominio applicazione attuale per il nome specificato.Gets the value stored in the current application domain for the specified name.

public:
 System::Object ^ GetData(System::String ^ name);
public:
 virtual System::Object ^ GetData(System::String ^ name);
public object? GetData (string name);
public object GetData (string name);
member this.GetData : string -> obj
abstract member GetData : string -> obj
override this.GetData : string -> obj
Public Function GetData (name As String) As Object

Parametri

name
String

Nome di una proprietà del dominio applicazione predefinita o nome della proprietà di un dominio applicazione definito.The name of a predefined application domain property, or the name of an application domain property you have defined.

Restituisce

Object

Valore della proprietà name oppure null se la proprietà non esiste.The value of the name property, or null if the property does not exist.

Implementazioni

Eccezioni

name è null.name is null.

L'operazione viene tentata in un dominio dell'applicazione non caricato.The operation is attempted on an unloaded application domain.

Esempio

Nell'esempio seguente viene creato un nuovo dominio applicazione, viene impostato un valore fornito dal sistema per il dominio e viene aggiunta una nuova coppia valore per il dominio.The following example creates a new application domain, sets a system-provided value for the domain, and adds a new value pair for the domain. Nell'esempio viene quindi illustrato come utilizzare il GetData metodo per recuperare i dati da queste coppie valore e visualizzarli nella console.The example then demonstrates how to use the GetData method to retrieve the data from these value pairs and display them to the console.

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
 */

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

Commenti

Utilizzare questo metodo per recuperare il valore di una voce in una cache interna delle coppie nome-dati che descrivono le proprietà di questa istanza di AppDomain .Use this method to retrieve the value of an entry in an internal cache of name-data pairs that describe properties of this instance of AppDomain. Si noti che il confronto tra name con il nome delle coppie chiave-valore fa distinzione tra maiuscole e minuscole.Note that the comparison of name with the name of key-value pairs is case-sensitive.

La cache contiene automaticamente le voci di sistema predefinite che vengono inserite quando viene creato il dominio dell'applicazione.The cache automatically contains predefined system entries that are inserted when the application domain is created. È possibile controllare i relativi valori con il GetData metodo o con le AppDomainSetup proprietà equivalenti.You can inspect their values with the GetData method, or the equivalent AppDomainSetup properties.

È possibile inserire o modificare le coppie nome-dati definite dall'utente con il SetData Metodo ed esaminare i relativi valori con il GetData metodo.You can insert or modify your own user defined name-data pairs with the SetData method and inspect their values with the GetData method.

Nella tabella seguente viene descritto il name di ogni voce di sistema predefinita e la relativa AppDomainSetup proprietà corrispondente.The following table describes the name of each predefined system entry and its corresponding AppDomainSetup property.

Valore di ' name 'Value of 'name' ProprietàProperty
APPBASE"APPBASE" AppDomainSetup.ApplicationBase
"APP_CONFIG_FILE""APP_CONFIG_FILE" AppDomainSetup.ConfigurationFile
"APP_LAUNCH_URL""APP_LAUNCH_URL" (nessuna proprietà)(no property)

"APP_LAUNCH_URL" rappresenta l'URL richiesto originariamente dall'utente, prima di qualsiasi reindirizzamento."APP_LAUNCH_URL" represents the URL originally requested by the user, before any redirection. È disponibile solo quando l'applicazione è stata avviata con un browser, ad esempio Internet Explorer.It is available only when the application has been launched with a browser such as Internet Explorer. Non tutti i browser forniscono questo valore.Not all browsers provide this value.
"APP_NAME""APP_NAME" AppDomainSetup.ApplicationName
"BINPATH_PROBE_ONLY""BINPATH_PROBE_ONLY" AppDomainSetup.PrivateBinPathProbe
"CACHE_BASE""CACHE_BASE" AppDomainSetup.CachePath
"CODE_DOWNLOAD_DISABLED""CODE_DOWNLOAD_DISABLED" AppDomainSetup.DisallowCodeDownload
"DEV_PATH""DEV_PATH" (nessuna proprietà)(no property)
"DISALLOW_APP""DISALLOW_APP" AppDomainSetup.DisallowPublisherPolicy
"DISALLOW_APP_BASE_PROBING""DISALLOW_APP_BASE_PROBING" AppDomainSetup.DisallowApplicationBaseProbing
"DISALLOW_APP_REDIRECTS""DISALLOW_APP_REDIRECTS" AppDomainSetup.DisallowBindingRedirects
"DYNAMIC_BASE""DYNAMIC_BASE" AppDomainSetup.DynamicBase
"FORCE_CACHE_INSTALL""FORCE_CACHE_INSTALL" AppDomainSetup.ShadowCopyFiles
"LICENSE_FILE" o stringa specifica dell'applicazione"LICENSE_FILE", or an application-specific string AppDomainSetup.LicenseFile
"LOADER_OPTIMIZATION""LOADER_OPTIMIZATION" AppDomainSetup.LoaderOptimization
"LOCATION_URI""LOCATION_URI" (nessuna proprietà)(no property)
"PRIVATE_BINPATH""PRIVATE_BINPATH" AppDomainSetup.PrivateBinPath
"REGEX_DEFAULT_MATCH_TIMEOUT""REGEX_DEFAULT_MATCH_TIMEOUT" Regex.MatchTimeout

"REGEX_DEFAULT_MATCH_TIMEOUT" non è una voce di sistema e il relativo valore può essere impostato chiamando il SetData metodo."REGEX_DEFAULT_MATCH_TIMEOUT" is not a system entry, and its value can be set by calling the SetData method.
"SHADOW_COPY_DIRS""SHADOW_COPY_DIRS" AppDomainSetup.ShadowCopyDirectories

Si applica a

Vedi anche