AppDomain.GetData(String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém o valor armazenado no domínio de aplicação atual para o nome especificado.
public:
virtual System::Object ^ GetData(System::String ^ name);
public:
System::Object ^ GetData(System::String ^ name);
public object GetData(string name);
abstract member GetData : string -> obj
override this.GetData : string -> obj
member this.GetData : string -> obj
Public Function GetData (name As String) As Object
Parâmetros
- name
- String
O nome de uma propriedade de domínio de aplicação pré-definida, ou o nome de uma propriedade de domínio de aplicação que definiste.
Devoluções
O valor da name propriedade, ou null se a propriedade não existir.
Implementações
Exceções
name é null.
A operação é tentada num domínio de aplicação não carregado.
Exemplos
O exemplo seguinte cria um novo domínio de aplicação, define um valor fornecido pelo sistema para o domínio e adiciona um novo par de valores para o domínio. O exemplo demonstra então como usar o GetData método para recuperar os dados destes pares de valores e exibi-los na consola.
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
Observações
Use este método para recuperar o valor de uma entrada numa cache interna de pares nome-dados que descrevem propriedades desta instância de AppDomain. Note que a comparação de name com o nome dos pares-chave-valor é sensível a maiúsculas e maiúsculas.
A cache contém automaticamente entradas de sistema pré-definidas que são inseridas quando o domínio da aplicação é criado. Pode inspecionar os seus valores com o GetData método, ou as propriedades equivalentes AppDomainSetup .
Pode inserir ou modificar os seus próprios pares nome-dados definidos pelo utilizador com o SetData método e inspecionar os seus valores com o GetData método.
A tabela seguinte descreve o name de cada entrada pré-definida do sistema e a sua propriedade correspondente AppDomainSetup .
| Valor de 'nome' | Property |
|---|---|
| "APPBASE" | AppDomainSetup.ApplicationBase |
| "APP_CONFIG_FILE" | AppDomainSetup.ConfigurationFile |
| "APP_LAUNCH_URL" | (sem propriedade) "APP_LAUNCH_URL" representa a URL originalmente solicitada pelo utilizador, antes de qualquer redirecionamento. Está disponível apenas quando a aplicação foi lançada com um navegador. Nem todos os navegadores oferecem este valor. |
| "APP_NAME" | AppDomainSetup.ApplicationName |
| "BINPATH_PROBE_ONLY" | AppDomainSetup.PrivateBinPathProbe |
| "CACHE_BASE" | AppDomainSetup.CachePath |
| "CODE_DOWNLOAD_DISABLED" | AppDomainSetup.DisallowCodeDownload |
| "DEV_PATH" | (sem propriedade) |
| "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", ou uma cadeia específica de aplicação | AppDomainSetup.LicenseFile |
| "LOADER_OPTIMIZATION" | AppDomainSetup.LoaderOptimization |
| "LOCATION_URI" | (sem propriedade) |
| "PRIVATE_BINPATH" | AppDomainSetup.PrivateBinPath |
| "REGEX_DEFAULT_MATCH_TIMEOUT" | Regex.MatchTimeout "REGEX_DEFAULT_MATCH_TIMEOUT" não é uma entrada de sistema, e o seu valor pode ser definido chamando o SetData método. |
| "SHADOW_COPY_DIRS" | AppDomainSetup.ShadowCopyDirectories |