SettingsPropertyValue.PropertyValue 속성

정의

네임스페이스:

System.Configuration

어셈블리:

System.Configuration.ConfigurationManager.dll

패키지:

System.Configuration.ConfigurationManager v8.0.0

Source:

SettingsPropertyValue.cs

SettingsProperty 개체의 값을 가져오거나 설정합니다.

public:
 property System::Object ^ PropertyValue { System::Object ^ get(); void set(System::Object ^ value); };

public object PropertyValue { get; set; }

member this.PropertyValue : obj with get, set

Public Property PropertyValue As Object

속성 값

Object

SettingsProperty 개체의 값입니다. 이 값이 설정되면 IsDirty 속성이 true로 설정되고 UsingDefaultValue가 false로 설정됩니다.

값이 PropertyValue 속성에서 처음으로 액세스되는 경우 값이 처음에 SettingsPropertyValue 속성을 사용하여 serialize된 표현으로 SerializedValue 개체에 저장되었으면 PropertyValue 속성은 내부 값의 deserialization을 발생시킵니다. 파생 작업으로 Deserialized 속성이 true로 설정됩니다.

이 이벤트 체인이 ASP.NET에서 발생하고 deserialization 프로세스 중에 오류가 발생하면 ASP.NET의 상태 모니터링 기능을 사용하여 오류가 기록됩니다. 즉, 기본적으로 ASP.NET에서 실행할 경우 deserialization 오류가 애플리케이션 이벤트 로그에 표시됩니다. 이 프로세스가 ASP.NET 외부에서 발생하고 deserialization 중에 오류가 발생하면 오류가 표시되지 않으며 deserialization 중에 논리의 나머지 부분이 수행됩니다. 역직렬화하려고 할 때 역직렬화할 직렬화된 값이 없는 경우 연결된 SettingsPropertyValue 인스턴스에 정의된 것처럼 기본값이 구성되어 있으면 SettingsProperty 개체가 기본값을 대신 반환하려고 합니다. 이 경우 DefaultValue 속성이 null이나 "[null]" 문자열로 설정되어 있으면 SettingsPropertyValue 개체가 PropertyValue 속성을 참조 형식의 경우 null로 초기화하고 연결된 값 형식의 경우 기본값으로 초기화합니다. 번면에 DefaultValue 속성이 유효한 개체 참조나 "[null]"이 아닌 문자열 값을 보유하고 있으면 DefaultValue 속성이 대신 반환됩니다.

역직렬화하려고 할 때 역직렬화할 직렬화된 값이 없는 경우 기본값이 지정되어 있지 않으면 문자열 형식에 대해 빈 문자열이 반환됩니다. 다른 모든 형식의 경우 를 호출 CreateInstance(Type) 하여 기본 instance 반환됩니다. 참조 형식의 경우 매개 변수가 없는 생성자를 사용하여 개체 instance 만들려는 시도가 수행됩니다. 기본 인스턴스 반환에 실패하면 null이 반환됩니다.

예외

ArgumentException

DefaultValue 속성에서 기본값을 사용하려고 하는 동안 오류가 발생한 경우. DefaultValue 속성을 유효한 형식으로 변환하지 못했거나 결과 값이 PropertyType에서 정의하는 형식과 호환되지 않습니다.