AppDomain.SetData Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přiřadí hodnotu vlastnosti domény aplikace.
Přetížení
SetData(String, Object) |
Přiřadí zadanou hodnotu vlastnosti zadané domény aplikace. |
SetData(String, Object, IPermission) |
Přiřadí zadanou hodnotu k zadané vlastnosti domény aplikace se zadaným oprávněním k vyžádání volajícího při načtení vlastnosti. |
SetData(String, Object)
- Zdroj:
- AppDomain.cs
- Zdroj:
- AppDomain.cs
- Zdroj:
- AppDomain.cs
Přiřadí zadanou hodnotu vlastnosti zadané domény aplikace.
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)
Parametry
- name
- String
Název vlastnosti domény aplikace definované uživatelem, která se má vytvořit nebo změnit.
- data
- Object
Hodnota vlastnosti.
Implementuje
- Atributy
Výjimky
Dojde k pokusu o operaci na uvolněné doméně aplikace.
Příklady
Následující příklad ukazuje, jak použít metodu SetData(String, Object) k vytvoření nového páru hodnot. Příklad pak použije metodu GetData k načtení hodnoty a zobrazí ji v konzole.
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
Poznámky
Pomocí této metody můžete vložit položku nebo upravit hodnotu položky v interní mezipaměti párů jmen a dat, které popisují vlastnosti této instance nástroje AppDomain.
Mezipaměť automaticky obsahuje předdefinované systémové položky, které se vloží při vytvoření domény aplikace. Pomocí této metody nelze vkládat ani upravovat systémové položky. Volání metody, která se pokusí upravit položku systému nemá žádný účinek; metoda nevyvolá výjimku. Hodnoty systémových položek můžete zkontrolovat pomocí GetData metody nebo ekvivalentních AppDomainSetup vlastností popsaných v GetDatatématu .
Tuto metodu můžete volat k nastavení hodnoty výchozího intervalu časového limitu pro vyhodnocení vzorů regulárních výrazů tak, že zadáte "REGEX_DEFAULT_MATCH_TIMEOUT" jako hodnotu argumentu name
a TimeSpan hodnotu, která představuje interval časového limitu jako hodnotu argumentu data
. Pomocí této metody můžete také vložit nebo upravit vlastní dvojice jmen a dat definovaných uživatelem a zkontrolovat jejich hodnoty pomocí GetData metody .
Viz také
Platí pro
SetData(String, Object, IPermission)
Přiřadí zadanou hodnotu k zadané vlastnosti domény aplikace se zadaným oprávněním k vyžádání volajícího při načtení vlastnosti.
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)
Parametry
- name
- String
Název vlastnosti domény aplikace definované uživatelem, která se má vytvořit nebo změnit.
- data
- Object
Hodnota vlastnosti.
- permission
- IPermission
Oprávnění k vyžádání volajícího při načtení vlastnosti
- Atributy
Výjimky
name
je null
.
name
určuje systémově definovaný řetězec vlastnosti a permission
není null
.
Poznámky
Tato metoda slouží k vložení nebo úpravě vlastních uživatelem definovaných položek v interní mezipaměti párů název/data, které popisují vlastnosti domény aplikace. Když vložíte položku, můžete zadat požadavek na oprávnění, který se má vynutit při načtení položky. Kromě toho můžete volat tuto metodu k nastavení hodnoty výchozího intervalu časového limitu pro vyhodnocení vzorů regulárních výrazů zadáním "REGEX_DEFAULT_MATCH_TIMEOUT" jako hodnoty argumentu name
a TimeSpan hodnoty, která představuje interval časového limitu jako hodnotu argumentu data
.
Tuto metodu nelze použít k přiřazení požadavků na zabezpečení k řetězci vlastnosti definovanému systémem.
Mezipaměť automaticky obsahuje předdefinované systémové položky, které se vloží při vytvoření domény aplikace. Pomocí této metody nelze vkládat ani upravovat systémové položky. Volání metody, která se pokusí upravit položku systému nemá žádný účinek; metoda nevyvolá výjimku. Hodnoty systémových položek můžete zkontrolovat pomocí GetData metody nebo ekvivalentních AppDomainSetup vlastností popsaných v části Poznámky pro metodu GetData .