AppDomain.SetData Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Назначает значение свойству домена приложения.
Перегрузки
| Имя | Описание |
|---|---|
| SetData(String, Object) |
Назначает указанное значение указанному свойству домена приложения. |
| SetData(String, Object, IPermission) |
Назначает указанное значение указанному свойству домена приложения с указанным разрешением на запрос вызывающего объекта при получении свойства. |
SetData(String, Object)
- Исходный код:
- AppDomain.cs
- Исходный код:
- AppDomain.cs
- Исходный код:
- AppDomain.cs
- Исходный код:
- AppDomain.cs
- Исходный код:
- AppDomain.cs
Назначает указанное значение указанному свойству домена приложения.
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)
Параметры
- name
- String
Имя определяемого пользователем доменного свойства приложения для создания или изменения.
- data
- Object
Значение свойства.
Реализации
- Атрибуты
Исключения
Операция выполняется в выгруженном домене приложения.
Примеры
В следующем примере показано, как использовать SetData(String, Object) метод для создания новой пары значений. Затем в примере используется GetData метод для получения значения и его отображение в консоли.
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
Комментарии
Используйте этот метод для вставки записи или изменения значения записи во внутреннем кэше пар данных имен, описывающих свойства данного экземпляра AppDomain.
Кэш автоматически содержит предопределенные системные записи, вставленные при создании домена приложения. Невозможно вставить или изменить системные записи с помощью этого метода. Вызов метода, который пытается изменить системную запись, не действует; Метод не создает исключение. Вы можете проверить значения системных записей с GetData помощью метода или эквивалентные AppDomainSetup свойства, описанные в GetDataразделе .
Этот метод можно вызвать, чтобы задать значение интервала времени ожидания по умолчанию для оценки шаблонов регулярных выражений, указав "REGEX_DEFAULT_MATCH_TIMEOUT" в качестве значения name аргумента и TimeSpan значение, представляющее интервал времени ожидания в качестве значения аргумента data . Вы также можете вставить или изменить собственные пользовательские пары name-data с этим методом GetData и проверить их значения с помощью метода.
См. также раздел
Применяется к
SetData(String, Object, IPermission)
Назначает указанное значение указанному свойству домена приложения с указанным разрешением на запрос вызывающего объекта при получении свойства.
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)
Параметры
- name
- String
Имя определяемого пользователем доменного свойства приложения для создания или изменения.
- data
- Object
Значение свойства.
- permission
- IPermission
Разрешение на запрос вызывающего объекта при извлечении свойства.
- Атрибуты
Исключения
name равно null.
name указывает строку определяемого системой свойства и permission не nullявляется.
Комментарии
Используйте этот метод для вставки или изменения собственных пользовательских записей во внутреннем кэше пар имен и данных, описывающих свойства домена приложения. При вставке записи можно указать требование разрешения для принудительного применения при извлечении записи. Кроме того, этот метод можно вызвать, чтобы задать значение интервала времени ожидания по умолчанию для оценки шаблонов регулярных выражений, указав "REGEX_DEFAULT_MATCH_TIMEOUT" в качестве значения name аргумента и TimeSpan значение, представляющее интервал времени ожидания в качестве значения аргумента data .
Этот метод нельзя использовать для назначения требования безопасности строке свойств, определяемой системой.
Кэш автоматически содержит предопределенные системные записи, вставленные при создании домена приложения. Невозможно вставить или изменить системные записи с помощью этого метода. Вызов метода, который пытается изменить системную запись, не действует; Метод не создает исключение. Значения системных записей можно проверить с GetData помощью метода или эквивалентных AppDomainSetup свойств, описанных в разделе "Примечания" для GetData метода.