ComUdtElement 클래스

정의

네임스페이스:

System.ServiceModel.Configuration

어셈블리:

System.ServiceModel.dll

서비스 계약에 포함될 UDT(사용자 정의 형식)를 나타냅니다. 이 클래스는 상속될 수 없습니다.

public ref class ComUdtElement sealed : System::Configuration::ConfigurationElement

public sealed class ComUdtElement : System.Configuration.ConfigurationElement

type ComUdtElement = class
    inherit ConfigurationElement

Public NotInheritable Class ComUdtElement
Inherits ConfigurationElement

상속

Object

ConfigurationElement

ComUdtElement

예제

다음 예제에서는 <userDefinedTypes> 이 목적을 위해 구성 파일의 섹션에 두 개의 특정 UDT를 추가하는 방법을 보여 줍니다.

설명

COM+ 통합 런타임에서는 형식 라이브러리를 검사하여 서비스를 생성합니다. COM+ 구성 요소에 VARIANT를 전달하는 메서드가 포함될 경우 시스템에서 런타임 전에 전달될 실제 형식을 확인할 수 없습니다. 따라서 VARIANT 내에서 UDT(사용자 정의 형식)를 전달하려고 시도하면 알려진 serialization 형식이 아니므로 실패합니다.

이 문제를 방지하기 위해 UDT를 구성 파일에 추가함으로써 적절한 서비스 계약에 알려진 형식으로 포함되게 할 수 있습니다. 그러기 위해서는 UDT와 계약, 즉 이를 사용하는 원래 COM 인터페이스를 고유하게 식별해야 합니다.

다음 예제에서는 <userDefinedTypes> 이 목적을 위해 구성 파일의 섹션에 두 개의 특정 UDT를 추가하는 방법을 보여 줍니다.

<userDefinedType>요소의 특성은 다음과 같이 정의됩니다.

• typeName: 읽을 수 있는 형식 이름을 제공하는 선택적 특성입니다. 이 특성은 런타임에서 사용되지 않지만, 판독기에서 형식을 구별할 때 도움이 됩니다.

• typeLibID: 형식을 정의하는 등록된 형식 라이브러리를 지정하는 GUID 문자열입니다.

• typeLibVersion: 형식을 정의하는 형식 라이브러리 버전을 지정하는 문자열입니다.

• typeDefID: 등록된 형식 라이브러리에 있는 특정 UDT 형식을 지정하는 GUID 문자열입니다.

서비스가 초기화될 때 COM+ 통합 런타임은 지정된 형식을 찾아 지정된 계약에 대해 알려진 형식 컬렉션에 이를 추가합니다.

생성자

ComUdtElement()	ComUdtElement 클래스의 새 인스턴스를 초기화합니다.
ComUdtElement(String)	지정된 GUID 문자열을 사용하여 ComUdtElement 클래스의 새 인스턴스를 초기화합니다.

속성

CurrentConfiguration	현재 Configuration 인스턴스가 속해 있는 구성 계층 구조를 나타내는 최상위 ConfigurationElement 인스턴스에 대한 참조를 가져옵니다. (다음에서 상속됨 ConfigurationElement)
ElementInformation	ElementInformation 개체의 사용자 지정할 수 없는 정보와 기능을 포함하는 ConfigurationElement 개체를 가져옵니다. (다음에서 상속됨 ConfigurationElement)
ElementProperty	ConfigurationElementProperty 개체 자체를 나타내는 ConfigurationElement 개체를 가져옵니다. (다음에서 상속됨 ConfigurationElement)
EvaluationContext	ContextInformation 개체의 ConfigurationElement 개체를 가져옵니다. (다음에서 상속됨 ConfigurationElement)
HasContext	CurrentConfiguration 속성이 null인지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
Item[ConfigurationProperty]	이 구성 요소의 속성이나 특성을 가져오거나 설정합니다. (다음에서 상속됨 ConfigurationElement)
Item[String]	이 구성 요소의 속성, 특성 또는 자식 요소를 가져오거나 설정합니다. (다음에서 상속됨 ConfigurationElement)
LockAllAttributesExcept	잠긴 특성의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
LockAllElementsExcept	잠긴 요소의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
LockAttributes	잠긴 특성의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
LockElements	잠긴 요소의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
LockItem	요소가 잠겨 있는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 ConfigurationElement)
Name	읽을 수 있는 형식 이름을 가져오거나 설정합니다.
Properties	속성 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
TypeDefID	등록된 형식 라이브러리에 있는 특정 UDT 형식을 식별하는 GUID 문자열을 가져오거나 설정합니다.
TypeLibID	형식을 정의하는 등록된 형식 라이브러리를 식별하는 GUID 문자열을 가져오거나 설정합니다.
TypeLibVersion	형식을 정의하는 형식 라이브러리 버전을 식별하는 문자열을 가져오거나 설정합니다.

메서드

DeserializeElement(XmlReader, Boolean)	구성 파일에서 XML을 읽습니다. (다음에서 상속됨 ConfigurationElement)
Equals(Object)	현재 ConfigurationElement 인스턴스를 지정된 개체와 비교합니다. (다음에서 상속됨 ConfigurationElement)
GetHashCode()	현재 ConfigurationElement 인스턴스를 나타내는 고유 값을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
GetTransformedAssemblyString(String)	지정된 어셈블리 이름의 변환된 버전을 반환합니다. (다음에서 상속됨 ConfigurationElement)
GetTransformedTypeString(String)	지정된 형식 이름의 변환된 버전을 반환합니다. (다음에서 상속됨 ConfigurationElement)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
Init()	ConfigurationElement 개체를 초기 상태로 설정합니다. (다음에서 상속됨 ConfigurationElement)
InitializeDefault()	ConfigurationElement 개체 값의 기본 집합을 초기화하는 데 사용됩니다. (다음에서 상속됨 ConfigurationElement)
IsModified()	파생 클래스에서 구현될 때 이 구성 요소가 마지막으로 저장되거나 로드된 이후 수정되었는지 여부를 나타냅니다. (다음에서 상속됨 ConfigurationElement)
IsReadOnly()	ConfigurationElement 개체가 읽기 전용인지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
ListErrors(IList)	이 ConfigurationElement 개체와 모든 하위 요소의 잘못된 속성 오류를 전달된 목록에 추가합니다. (다음에서 상속됨 ConfigurationElement)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
OnDeserializeUnrecognizedAttribute(String, String)	역직렬화하는 동안 알 수 없는 특성을 발견했는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	역직렬화하는 동안 알 수 없는 요소를 발견했는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
OnRequiredPropertyNotFound(String)	필수 속성이 없으면 예외를 throw합니다. (다음에서 상속됨 ConfigurationElement)
PostDeserialize()	deserialization 후에 호출됩니다. (다음에서 상속됨 ConfigurationElement)
PreSerialize(XmlWriter)	serialization 전에 호출됩니다. (다음에서 상속됨 ConfigurationElement)
Reset(ConfigurationElement)	잠금 및 속성 컬렉션을 비롯하여 ConfigurationElement 개체의 내부 상태를 다시 설정합니다. (다음에서 상속됨 ConfigurationElement)
ResetModified()	파생 클래스에서 구현되는 경우 IsModified() 메서드의 값을 false로 다시 설정합니다. (다음에서 상속됨 ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	파생 클래스에서 구현될 때 구성 요소의 내용을 구성 파일에 씁니다. (다음에서 상속됨 ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	파생 클래스에서 구현될 때 구성 요소의 외부 태그를 구성 파일에 씁니다. (다음에서 상속됨 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	속성을 지정된 값으로 설정합니다. (다음에서 상속됨 ConfigurationElement)
SetReadOnly()	IsReadOnly() 개체와 모든 하위 요소에 대한 ConfigurationElement 속성을 설정합니다. (다음에서 상속됨 ConfigurationElement)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	ConfigurationElement 개체를 수정하여 저장되지 않아야 하는 값을 모두 제거합니다. (다음에서 상속됨 ConfigurationElement)

추가 정보

• 구성에서 ComUdtElements