Compartilhar via


AppDomain.SetData Método

Definição

Atribui um valor a uma propriedade de domínio do aplicativo.

Sobrecargas

SetData(String, Object)

Atribui o valor especificado para a propriedade de domínio do aplicativo especificado.

SetData(String, Object, IPermission)

Atribui o valor especificado à propriedade de domínio de aplicativo especificada, com uma permissão especificada para exigir do chamador quando a propriedade for recuperada.

SetData(String, Object)

Origem:
AppDomain.cs
Origem:
AppDomain.cs
Origem:
AppDomain.cs

Atribui o valor especificado para a propriedade de domínio do aplicativo especificado.

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

Parâmetros

name
String

O nome de uma propriedade de domínio de aplicativo definida pelo usuário a ser criada ou alterada.

data
Object

O valor da propriedade.

Implementações

Atributos

Exceções

A operação é tentada em um domínio de aplicativo descarregado.

Exemplos

O exemplo a seguir demonstra como usar o SetData(String, Object) método para criar um novo par de valores. Em seguida, o exemplo usa o GetData método para recuperar o valor e o exibe no 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
 */
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

Comentários

Use esse método para inserir uma entrada ou modificar o valor de uma entrada em um cache interno de pares nome-dados que descrevem as propriedades dessa instância do AppDomain.

O cache contém automaticamente entradas predefinidas do sistema que são inseridas quando o domínio do aplicativo é criado. Não é possível inserir ou modificar entradas do sistema com esse método. Uma chamada de método que tenta modificar uma entrada do sistema não tem efeito; o método não gera uma exceção. Você pode inspecionar os valores das entradas do sistema com o GetData método ou as propriedades equivalentes AppDomainSetup descritas em GetData.

Você pode chamar esse método para definir o valor do intervalo de tempo limite padrão para avaliar padrões de expressão regular fornecendo "REGEX_DEFAULT_MATCH_TIMEOUT" como o valor do name argumento e um TimeSpan valor que representa o intervalo de tempo limite como o valor do data argumento. Você também pode inserir ou modificar seus próprios pares nome-dados definidos pelo usuário com esse método e inspecionar seus valores com o GetData método .

Confira também

Aplica-se a

SetData(String, Object, IPermission)

Atribui o valor especificado à propriedade de domínio de aplicativo especificada, com uma permissão especificada para exigir do 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 aplicativo definida pelo usuário a ser criada ou alterada.

data
Object

O valor da propriedade.

permission
IPermission

A permissão para exigir do chamador quando a propriedade é recuperada.

Atributos

Exceções

name é null.

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

Comentários

Use esse método para inserir ou modificar suas próprias entradas definidas pelo usuário em um cache interno de pares de nomes/dados que descrevem as propriedades do domínio do aplicativo. Ao inserir uma entrada, você pode especificar uma demanda de permissão a ser imposta quando a entrada for recuperada. Além disso, você pode chamar esse método para definir o valor do intervalo de tempo limite padrão para avaliar padrões de expressão regular fornecendo "REGEX_DEFAULT_MATCH_TIMEOUT" como o valor do name argumento e um TimeSpan valor que representa o intervalo de tempo limite como o valor do data argumento.

Você não pode usar esse método para atribuir uma demanda de segurança a uma cadeia de caracteres de propriedade definida pelo sistema.

O cache contém automaticamente entradas predefinidas do sistema que são inseridas quando o domínio do aplicativo é criado. Não é possível inserir ou modificar entradas do sistema com esse método. Uma chamada de método que tenta modificar uma entrada do sistema não tem efeito; o método não gera uma exceção. Você pode inspecionar os valores das entradas do sistema com o GetData método ou as propriedades equivalentes AppDomainSetup descritas na seção Comentários para o GetData método .

Aplica-se a