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> раздел файла конфигурации для этой цели.

Среда выполнения интеграции СОМ+ создает службы путем проверки библиотеки типов. Если в компоненте СОМ+ содержатся методы, которые служат для передачи VARIANT, система не в состоянии определить фактические типы для передачи до среды выполнения. Поэтому при попытке передать пользовательский тип (UDT) в рамках VARIANT происходит сбой, поскольку данный тип не является известным типом для сериализации.

Для решения этой проблемы можно добавить пользовательские типы в файл конфигурации, чтобы их можно было включить как известные типы в соответствующий контракт службы. Для этого необходимо однозначно определить пользовательский тип и контракты, то есть исходные интерфейсы СОМ, которые его используют.

Атрибуты <userDefinedType> элемента определяются следующим образом:

typeName: необязательный атрибут, предоставляющий доступное для чтения имя типа. Не используется средой выполнения, но помогает читателю различать типы.
typeLibID: строка идентификатора GUID, в которой указывается зарегистрированная библиотека типов, в которой задан тип.
typeLibVersion: строка, в которой указывается версия библиотеки типов, в которой задан тип.
typeDefID: строка идентификатора GUID, в которой указывается пользовательский тип в зарегистрированной библиотеке типов.

При запуске службы среда выполнения интеграции COM+ выполняет поиск по указанным типам и добавляет их в коллекции известных типов для заданных контрактов.

Конструкторы

ComUdtElement()	Инициализирует новый экземпляр класса ComUdtElement.
ComUdtElement(String)	Инициализирует новый экземпляр класса ComUdtElement с помощью указанной строки идентификатора GUID.

Свойства

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	Возвращает или задает строку идентификатора GUID, которая идентифицирует конкретный пользовательский тип (UDT) в зарегистрированной библиотеке типов.
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)	Выдает исключение, если требуемое свойство не найдено. (Унаследовано от ConfigurationElement)
PostDeserialize()	Вызывается после десериализации. (Унаследовано от ConfigurationElement)
PreSerialize(XmlWriter)	Вызывается до сериализации. (Унаследовано от 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 в конфигурации