AppDomain.SetData Metodo

Definizione

Assegna un valore a una proprietà del dominio applicazione.Assigns a value to an application domain property.

Overload

SetData(String, Object)

Assegna il valore specificato alla proprietà specificata del dominio applicazione.Assigns the specified value to the specified application domain property.

SetData(String, Object, IPermission)

Assegna il valore specificato alla proprietà del dominio applicazione indicata, con una determinata autorizzazione di richiesta del chiamante quando viene recuperata la proprietà.Assigns the specified value to the specified application domain property, with a specified permission to demand of the caller when the property is retrieved.

SetData(String, Object)

Assegna il valore specificato alla proprietà specificata del dominio applicazione.Assigns the specified value to the specified application domain property.

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)

Parametri

name
String

Nome della proprietà del dominio applicazione definito dall'utente da creare o modificare.The name of a user-defined application domain property to create or change.

data
Object

Valore della proprietà.The value of the property.

Implementazioni

Attributi

Eccezioni

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 illustrato come utilizzare il SetData(String, Object) metodo per creare una nuova coppia di valori.The following example demonstrates how to use the SetData(String, Object) method to create a new value pair. Nell'esempio viene quindi usato il GetData metodo per recuperare il valore e lo Visualizza nella console.The example then uses the GetData method to retrieve the value, and displays it 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 inserire una voce o modificare il valore di una voce in una cache interna di coppie nome-dati che descrivono le proprietà di questa istanza di AppDomain .Use this method to insert an entry, or modify the value of an entry in an internal cache of name-data pairs that describe properties of this instance of AppDomain.

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. Non è possibile inserire o modificare le voci di sistema con questo metodo.You cannot insert or modify system entries with this method. Una chiamata al metodo che tenta di modificare una voce di sistema non ha alcun effetto; il metodo non genera un'eccezione.A method call that attempts to modify a system entry has no effect; the method does not throw an exception. È possibile esaminare i valori delle voci di sistema con il GetData metodo oppure le proprietà equivalenti AppDomainSetup descritte in GetData .You can inspect the values of system entries with the GetData method, or the equivalent AppDomainSetup properties described in GetData.

È possibile chiamare questo metodo per impostare il valore dell'intervallo di timeout predefinito per la valutazione dei modelli di espressione regolare fornendo "REGEX_DEFAULT_MATCH_TIMEOUT" come valore dell' name argomento e un TimeSpan valore che rappresenta l'intervallo di timeout come valore dell' data argomento.You can call this method to set the value of the default timeout interval for evaluating regular expression patterns by supply "REGEX_DEFAULT_MATCH_TIMEOUT" as the value of the name argument and a TimeSpan value that represents the timeout interval as the value of the data argument. È anche possibile inserire o modificare le coppie nome-dati definite dall'utente con questo metodo ed esaminarne i valori con il GetData metodo.You can also insert or modify your own user defined name-data pairs with this method and inspect their values with the GetData method.

Vedi anche

Si applica a

SetData(String, Object, IPermission)

Assegna il valore specificato alla proprietà del dominio applicazione indicata, con una determinata autorizzazione di richiesta del chiamante quando viene recuperata la proprietà.Assigns the specified value to the specified application domain property, with a specified permission to demand of the caller when the property is retrieved.

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)

Parametri

name
String

Nome della proprietà del dominio applicazione definito dall'utente da creare o modificare.The name of a user-defined application domain property to create or change.

data
Object

Valore della proprietà.The value of the property.

permission
IPermission

Autorizzazione di richiesta del chiamante quando viene recuperata la proprietà.The permission to demand of the caller when the property is retrieved.

Attributi

Eccezioni

name è null.name is null.

Il parametro name specifica una stringa di proprietà definita dal sistema e il parametro permission non è null.name specifies a system-defined property string and permission is not null.

Commenti

Utilizzare questo metodo per inserire o modificare le voci definite dall'utente in una cache interna di coppie nome/dati che descrivono le proprietà del dominio applicazione.Use this method to insert or modify your own user-defined entries in an internal cache of name/data pairs that describe properties of the application domain. Quando si inserisce una voce, è possibile specificare una richiesta di autorizzazione da applicare quando viene recuperata la voce. Inoltre, è possibile chiamare questo metodo per impostare il valore dell'intervallo di timeout predefinito per la valutazione dei modelli di espressione regolare fornendo "REGEX_DEFAULT_MATCH_TIMEOUT" come valore dell' name argomento e un TimeSpan valore che rappresenta l'intervallo di timeout come valore dell' data argomento.When you insert an entry, you can specify a permission demand to enforce when the entry is retrieved.In addition, you can call this method to set the value of the default timeout interval for evaluating regular expression patterns by supply "REGEX_DEFAULT_MATCH_TIMEOUT" as the value of the name argument and a TimeSpan value that represents the timeout interval as the value of the data argument.

Non è possibile usare questo metodo per assegnare una richiesta di sicurezza a una stringa di proprietà definita dal sistema.You cannot use this method to assign a security demand to a system-defined property string.

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. Non è possibile inserire o modificare le voci di sistema con questo metodo.You cannot insert or modify system entries with this method. Una chiamata al metodo che tenta di modificare una voce di sistema non ha alcun effetto; il metodo non genera un'eccezione.A method call that attempts to modify a system entry has no effect; the method does not throw an exception. È possibile esaminare i valori delle voci di sistema con il GetData metodo o le AppDomainSetup proprietà equivalenti descritte nella sezione Osservazioni per il GetData metodo.You can inspect the values of system entries with the GetData method or the equivalent AppDomainSetup properties described in the Remarks section for the GetData method.

Si applica a