AppDomain.SetData Methode

Referenz

Definition

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Weist einer Anwendungsdomäneneigenschaft einen Wert zu.

Überlädt

SetData(String, Object)	Weist der angegebenen Anwendungsdomäneneigenschaft den angegebenen Wert zu.
SetData(String, Object, IPermission)	Weist der angegebenen Anwendungsdomäneneigenschaft den angegebenen Wert mit einer angegebenen Berechtigung zu, die der Aufrufer beim Abrufen der Eigenschaft besitzen muss.

SetData(String, Object)

Weist der angegebenen Anwendungsdomäneneigenschaft den angegebenen Wert zu.

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)

Parameter

name: String

Der Name einer zu erstellenden oder zu ändernden benutzerdefinierten Anwendungsdomäneneigenschaft.

data: Object

Der Wert der Eigenschaft.

Implementiert

SetData(String, Object)

Attribute: SecurityCriticalAttribute

Ausnahmen

AppDomainUnloadedException

Der Vorgang wird für eine entladene Anwendungsdomäne ausgeführt.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Die SetData(String, Object) Methode zum Erstellen eines neuen Wertpaars verwendet wird. Im Beispiel wird dann die GetData Methode zum Abrufen des Werts verwendet und in der Konsole angezeigt.

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

Hinweise

Verwenden Sie diese Methode, um einen Eintrag einzufügen oder den Wert eines Eintrags in einem internen Cache von Namensdatenpaaren zu ändern, die Eigenschaften dieser Instanz AppDomainbeschreiben.

Der Cache enthält automatisch vordefinierte Systemeinträge, die beim Erstellen der Anwendungsdomäne eingefügt werden. Sie können keine Systemeinträge mit dieser Methode einfügen oder ändern. Ein Methodenaufruf, der versucht, einen Systemeintrag zu ändern, hat keine Auswirkung; Die Methode löst keine Ausnahme aus. Sie können die Werte von Systemeinträgen mit der GetData Methode oder die entsprechenden AppDomainSetup Eigenschaften überprüfen, die in GetData.

Sie können diese Methode aufrufen, um den Wert des Standardtimeoutintervalls für die Auswertung regulärer Ausdrucksmuster festzulegen, indem Sie "REGEX_DEFAULT_MATCH_TIMEOUT" als Wert des name Arguments und einen TimeSpan Wert angeben, der das Timeoutintervall als Wert des data Arguments darstellt. Sie können auch ihre eigenen benutzerdefinierten Namensdatenpaare mit dieser Methode einfügen oder ändern und deren Werte mit der GetData Methode überprüfen.

Siehe auch

GetData(String)

Gilt für

SetData(String, Object, IPermission)

Weist der angegebenen Anwendungsdomäneneigenschaft den angegebenen Wert mit einer angegebenen Berechtigung zu, die der Aufrufer beim Abrufen der Eigenschaft besitzen muss.

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)

Parameter

name: String

Der Name einer zu erstellenden oder zu ändernden benutzerdefinierten Anwendungsdomäneneigenschaft.

data: Object

Der Wert der Eigenschaft.

permission: IPermission

Die vom Aufrufer beim Abrufen der Eigenschaft verlangte Berechtigung.

Attribute: SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

name ist null.

InvalidOperationException

name gibt eine systemdefinierte Eigenschaftenzeichenfolge an, und permission ist nicht null.

Hinweise

Verwenden Sie diese Methode, um ihre eigenen benutzerdefinierten Einträge in einen internen Cache mit Namen-/Datenpaaren einzufügen oder zu ändern, die Eigenschaften der Anwendungsdomäne beschreiben. Wenn Sie einen Eintrag einfügen, können Sie eine Berechtigungsnachfrage angeben, um zu erzwingen, wenn der Eintrag abgerufen wird. Darüber hinaus können Sie diese Methode aufrufen, um den Wert des Standardtimeoutintervalls für die Auswertung regulärer Ausdrucksmuster festzulegen, indem Sie "REGEX_DEFAULT_MATCH_TIMEOUT" als Wert des name Arguments und einen TimeSpan Wert angeben, der das Timeoutintervall als Wert des data Arguments darstellt.

Sie können diese Methode nicht verwenden, um eine Sicherheitsnachfrage einer systemdefinierten Eigenschaftszeichenfolge zuzuweisen.

Der Cache enthält automatisch vordefinierte Systemeinträge, die beim Erstellen der Anwendungsdomäne eingefügt werden. Sie können keine Systemeinträge mit dieser Methode einfügen oder ändern. Ein Methodenaufruf, der versucht, einen Systemeintrag zu ändern, hat keine Auswirkung; Die Methode löst keine Ausnahme aus. Sie können die Werte von Systemeinträgen mit der GetData Methode oder den entsprechenden AppDomainSetup Eigenschaften überprüfen, die im Abschnitt "Hinweise" für die GetData Methode beschrieben sind.

Gilt für

AppDomain.SetData Methode

Definition

Überlädt

SetData(String, Object)

Parameter

Implementiert

Ausnahmen

Beispiele

Hinweise

Siehe auch

Gilt für

SetData(String, Object, IPermission)

Parameter

Ausnahmen

Hinweise

Gilt für

Zusätzliche Ressourcen