AppDomain.GetData(String) 메서드

정의

지정한 이름에 대해 현재 애플리케이션 도메인에 저장된 값을 가져옵니다.Gets the value stored in the current application domain for the specified name.

public:
 virtual System::Object ^ GetData(System::String ^ name);
public object GetData (string name);
abstract member GetData : string -> obj
override this.GetData : string -> obj
Public Function GetData (name As String) As Object

매개 변수

name
String

미리 정의된 애플리케이션 도메인 속성의 이름 또는 사용자가 정의한 애플리케이션 도메인 속성의 이름입니다.The name of a predefined application domain property, or the name of an application domain property you have defined.

반환

name 속성의 값이거나, 속성이 없을 경우 null입니다.The value of the name property, or null if the property does not exist.

구현

예외

namenull인 경우name is null.

언로드된 애플리케이션 도메인에서 작업이 시도됩니다.The operation is attempted on an unloaded application domain.

예제

다음 예제에서는 새 애플리케이션 도메인을 만들고, 도메인에 대해 시스템이 제공한 값을 설정 및 도메인에 대 한 새 값 쌍을 추가 합니다.The following example creates a new application domain, sets a system-provided value for the domain, and adds a new value pair for the domain. 그런 다음이 예제에서는 GetData 메서드를 사용 하 여 이러한 값 쌍에서 데이터를 검색 하 고 콘솔에 표시 하는 방법을 보여 줍니다.The example then demonstrates how to use the GetData method to retrieve the data from these value pairs and display them 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

설명

이 메서드를 사용 하 여이 AppDomain인스턴스의 속성을 설명 하는 이름-데이터 쌍의 내부 캐시에 있는 항목의 값을 검색 합니다.Use this method to retrieve the value of an entry in an internal cache of name-data pairs that describe properties of this instance of AppDomain. 키-값 쌍의 이름과 name 비교는 대/소문자를 구분 합니다.Note that the comparison of name with the name of key-value pairs is case-sensitive.

캐시는 자동으로 애플리케이션 도메인이 만들어질 때 삽입 되는 미리 정의 된 시스템 항목을 포함 합니다.The cache automatically contains predefined system entries that are inserted when the application domain is created. GetData 메서드 또는 이와 동등한 AppDomainSetup 속성을 사용 하 여 해당 값을 검사할 수 있습니다.You can inspect their values with the GetData method, or the equivalent AppDomainSetup properties.

SetData 메서드를 사용 하 여 사용자 정의 이름-데이터 쌍을 삽입 하거나 수정 하 고 GetData 메서드를 사용 하 여 해당 값을 검사할 수 있습니다.You can insert or modify your own user defined name-data pairs with the SetData method and inspect their values with the GetData method.

다음 표에서는 미리 정의 된 각 시스템 항목 및 해당 AppDomainSetup 속성의 name에 대해 설명 합니다.The following table describes the name of each predefined system entry and its corresponding AppDomainSetup property.

' Name '의 값Value of 'name' 속성Property
APPBASE"APPBASE" AppDomainSetup.ApplicationBase
"APP_CONFIG_FILE""APP_CONFIG_FILE" AppDomainSetup.ConfigurationFile
"APP_LAUNCH_URL""APP_LAUNCH_URL" (속성 없음)(no property)

"APP_LAUNCH_URL"은 리디렉션 전에 사용자가 원래 요청한 URL을 나타냅니다."APP_LAUNCH_URL" represents the URL originally requested by the user, before any redirection. Internet Explorer와 같은 브라우저를 사용 하 여 애플리케이션 시작 되었습니다 하는 경우에 제공 됩니다.It is available only when the application has been launched with a browser such as Internet Explorer. 모든 브라우저에서이 값을 제공 하는 것은 아닙니다.Not all browsers provide this value.
"APP_NAME""APP_NAME" AppDomainSetup.ApplicationName
"BINPATH_PROBE_ONLY""BINPATH_PROBE_ONLY" AppDomainSetup.PrivateBinPathProbe
"CACHE_BASE""CACHE_BASE" AppDomainSetup.CachePath
"CODE_DOWNLOAD_DISABLED""CODE_DOWNLOAD_DISABLED" AppDomainSetup.DisallowCodeDownload
"DEV_PATH""DEV_PATH" (속성 없음)(no property)
"DISALLOW_APP""DISALLOW_APP" AppDomainSetup.DisallowPublisherPolicy
"DISALLOW_APP_BASE_PROBING""DISALLOW_APP_BASE_PROBING" AppDomainSetup.DisallowApplicationBaseProbing
"DISALLOW_APP_REDIRECTS""DISALLOW_APP_REDIRECTS" AppDomainSetup.DisallowBindingRedirects
"DYNAMIC_BASE""DYNAMIC_BASE" AppDomainSetup.DynamicBase
"FORCE_CACHE_INSTALL""FORCE_CACHE_INSTALL" AppDomainSetup.ShadowCopyFiles
"LICENSE_FILE" 또는 애플리케이션별 문자열"LICENSE_FILE", or an application-specific string AppDomainSetup.LicenseFile
"LOADER_OPTIMIZATION""LOADER_OPTIMIZATION" AppDomainSetup.LoaderOptimization
"LOCATION_URI""LOCATION_URI" (속성 없음)(no property)
"PRIVATE_BINPATH""PRIVATE_BINPATH" AppDomainSetup.PrivateBinPath
"REGEX_DEFAULT_MATCH_TIMEOUT""REGEX_DEFAULT_MATCH_TIMEOUT" Regex.MatchTimeout

"REGEX_DEFAULT_MATCH_TIMEOUT"는 시스템 항목이 아니므로 SetData 메서드를 호출 하 여 해당 값을 설정할 수 있습니다."REGEX_DEFAULT_MATCH_TIMEOUT" is not a system entry, and its value can be set by calling the SetData method.
"SHADOW_COPY_DIRS""SHADOW_COPY_DIRS" AppDomainSetup.ShadowCopyDirectories

보안

FileIOPermission
속성이 경로에 적용 되는 경우 경로 자체의 정보에 액세스 하는 데 사용 됩니다.for access to the information in the path itself, if the property applies to a path. 연관된 열거형: PathDiscoveryAssociated enumeration: PathDiscovery.

적용 대상

추가 정보