AppDomain.SetData Método

Definição

Espaço de Nomes:
System
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll

Atribui um valor a uma propriedade de domínio de aplicação.

Sobrecargas

Name Description
SetData(String, Object)

Atribui o valor especificado à propriedade de domínio da aplicação especificada.
SetData(String, Object, IPermission)

Atribui o valor especificado à propriedade de domínio da aplicação especificada, com uma permissão específica para exigir ao chamador quando a propriedade for recuperada.

SetData(String, Object)

Atribui o valor especificado à propriedade de domínio da aplicação especificada.

public:
 virtual void SetData(System::String ^ name, System::Object ^ data);
public:
 void SetData(System::String ^ name, System::Object ^ data);
public void SetData(string name, object data);
[System.Security.SecurityCritical]
public void SetData(string name, object data);
abstract member SetData : string * obj -> unit
override this.SetData : string * obj -> unit
[<System.Security.SecurityCritical>]
abstract member SetData : string * obj -> unit
override this.SetData : string * obj -> unit
member this.SetData : string * obj -> unit
Public Sub SetData (name As String, data As Object)

Parâmetros

name
String

O nome de uma propriedade de domínio de aplicação definida pelo utilizador para criar ou alterar.

data
Object

O valor do imóvel.

Implementações

SetData(String, Object)
Atributos
SecurityCriticalAttribute

Exceções

AppDomainUnloadedException

A operação é tentada num domínio de aplicação não carregado.

Exemplos

O exemplo seguinte demonstra como usar o SetData(String, Object) método para criar um novo par de valores. O exemplo usa então o GetData método para recuperar o valor e exibe-o 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 inserir uma entrada, ou modificar o valor de uma entrada numa cache interna de pares nome-dados que descrevam propriedades desta instância de AppDomain.

A cache contém automaticamente entradas de sistema pré-definidas que são inseridas quando o domínio da aplicação é criado. Não pode inserir ou modificar entradas do sistema com este método. Uma chamada de método que tenta modificar uma entrada do sistema não tem efeito; O método não lança exceções. Pode inspecionar os valores das entradas do sistema com o GetData método, ou as propriedades equivalentes AppDomainSetup descritas em GetData.

Pode chamar este método para definir o valor do intervalo de timeout padrão para avaliar padrões de expressão regular, fornecendo "REGEX_DEFAULT_MATCH_TIMEOUT" como valor do name argumento e um TimeSpan valor que represente o intervalo de timeout como o valor do data argumento. Também pode inserir ou modificar os seus próprios pares nome-dados definidos pelo utilizador com este método e inspecionar os seus valores com o GetData método.

Ver também

Aplica-se a

SetData(String, Object, IPermission)

Atribui o valor especificado à propriedade de domínio da aplicação especificada, com uma permissão específica para exigir ao chamador quando a propriedade for recuperada.

public:
 void SetData(System::String ^ name, System::Object ^ data, System::Security::IPermission ^ permission);
public void SetData(string name, object data, System.Security.IPermission permission);
[System.Security.SecurityCritical]
public void SetData(string name, object data, System.Security.IPermission permission);
member this.SetData : string * obj * System.Security.IPermission -> unit
[<System.Security.SecurityCritical>]
member this.SetData : string * obj * System.Security.IPermission -> unit
Public Sub SetData (name As String, data As Object, permission As IPermission)

Parâmetros

name
String

O nome de uma propriedade de domínio de aplicação definida pelo utilizador para criar ou alterar.

data
Object

O valor do imóvel.

permission
IPermission

A permissão para exigir ao chamador quando a propriedade for recuperada.

Atributos
SecurityCriticalAttribute

Exceções

ArgumentNullException

name é null.

InvalidOperationException

name especifica uma cadeia de propriedades definida pelo sistema e permission não nullé .

Observações

Use este método para inserir ou modificar as suas próprias entradas definidas pelo utilizador numa cache interna de pares nome/dados que descrevem propriedades do domínio da aplicação. Ao inserir uma entrada, pode especificar um pedido de permissão para fazer cumprir quando a entrada for recuperada. Além disso, pode chamar este método para definir o valor do intervalo de tempo limite por defeito para avaliar padrões de expressões regulares, fornecendo "REGEX_DEFAULT_MATCH_TIMEOUT" como valor do name argumento e um TimeSpan valor que representa o intervalo de tempo como o valor do data argumento.

Não pode usar este método para atribuir uma exigência de segurança a uma cadeia de propriedades definida pelo sistema.

A cache contém automaticamente entradas de sistema pré-definidas que são inseridas quando o domínio da aplicação é criado. Não pode inserir ou modificar entradas do sistema com este método. Uma chamada de método que tenta modificar uma entrada do sistema não tem efeito; O método não lança exceções. Pode inspecionar os valores das entradas do sistema com o GetData método ou as propriedades equivalentes AppDomainSetup descritas na secção Observações do GetData método.

Aplica-se a