AppDomain.SetData Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 .