ComUdtElement Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa un tipo definido por el usuario (UDT) que se va a incluir en el contrato de servicio. Esta clase no puede heredarse.
public ref class ComUdtElement sealed : System::Configuration::ConfigurationElementpublic sealed class ComUdtElement : System.Configuration.ConfigurationElementtype ComUdtElement = class
inherit ConfigurationElementPublic NotInheritable Class ComUdtElement
Inherits ConfigurationElement- Herencia
Ejemplos
En el ejemplo siguiente se muestra cómo agregar dos UDT específicos a la <userDefinedTypes> sección del archivo de configuración para este propósito.
Comentarios
El entorno de ejecución de integración com+ crea servicios inspeccionando la biblioteca de tipos. Cuando un componente COM+ contiene métodos que pasan un VARIANT, el sistema no puede determinar los tipos reales que se van a pasar antes del tiempo de ejecución. Por lo tanto, cuando se intenta pasar un tipo definido por el usuario (UDT) dentro de , VARIANTse produce un error porque no es un tipo conocido para la serialización.
Para evitar este problema, puede agregar los UDT al archivo de configuración para que se puedan incluir como tipos conocidos en el contrato de servicio adecuado. Para ello, debe identificar de forma única el UDT y los contratos, es decir, las interfaces COM originales que lo usan.
En el ejemplo siguiente se muestra cómo agregar dos UDT específicos a la <userDefinedTypes> sección del archivo de configuración para este propósito.
Los atributos del elemento se definen de la <userDefinedType> siguiente manera:
typeName: un atributo opcional que proporciona el nombre de tipo legible. El tiempo de ejecución no lo usa, pero ayuda a un lector a distinguir los tipos.typeLibID: una cadena GUID que especifica la biblioteca de tipos registrada que define el tipo.typeLibVersion: una cadena que especifica la versión de la biblioteca de tipos que define el tipo.typeDefID: una cadena GUID que especifica el tipo UDT específico dentro de la biblioteca de tipos registrada.
Cuando se inicializa el servicio, com+ integration runtime busca los tipos especificados y los agrega a la colección de tipos conocidos para los contratos especificados.
Constructores
| Nombre | Description |
|---|---|
| ComUdtElement() |
Inicializa una nueva instancia de la clase ComUdtElement. |
| ComUdtElement(String) |
Inicializa una nueva instancia de la ComUdtElement clase con la cadena GUID especificada. |
Propiedades
| Nombre | Description |
|---|---|
| CurrentConfiguration |
Obtiene una referencia a la instancia de nivel Configuration superior que representa la jerarquía de configuración a la que pertenece la instancia actual ConfigurationElement . (Heredado de ConfigurationElement) |
| ElementInformation |
Obtiene un ElementInformation objeto que contiene la información y la funcionalidad no personalizables del ConfigurationElement objeto . (Heredado de ConfigurationElement) |
| ElementProperty |
Obtiene el ConfigurationElementProperty objeto que representa el ConfigurationElement propio objeto. (Heredado de ConfigurationElement) |
| EvaluationContext |
Obtiene el objeto ContextInformation para el objeto ConfigurationElement. (Heredado de ConfigurationElement) |
| HasContext |
Obtiene un valor que indica si la CurrentConfiguration propiedad es |
| Item[ConfigurationProperty] |
Obtiene o establece una propiedad o atributo de este elemento de configuración. (Heredado de ConfigurationElement) |
| Item[String] |
Obtiene o establece una propiedad, un atributo o un elemento secundario de este elemento de configuración. (Heredado de ConfigurationElement) |
| LockAllAttributesExcept |
Obtiene la colección de atributos bloqueados. (Heredado de ConfigurationElement) |
| LockAllElementsExcept |
Obtiene la colección de elementos bloqueados. (Heredado de ConfigurationElement) |
| LockAttributes |
Obtiene la colección de atributos bloqueados. (Heredado de ConfigurationElement) |
| LockElements |
Obtiene la colección de elementos bloqueados. (Heredado de ConfigurationElement) |
| LockItem |
Obtiene o establece un valor que indica si el elemento está bloqueado. (Heredado de ConfigurationElement) |
| Name |
Obtiene o establece el nombre de tipo legible. |
| Properties |
Obtiene la colección de propiedades. (Heredado de ConfigurationElement) |
| TypeDefID |
Obtiene o establece una cadena GUID que identifica el tipo UDT específico dentro de la biblioteca de tipos registrada. |
| TypeLibID |
Obtiene o establece una cadena GUID que identifica la biblioteca de tipos registrada que define el tipo. |
| TypeLibVersion |
Obtiene o establece una cadena que identifica la versión de la biblioteca de tipos que define el tipo. |
Métodos
| Nombre | Description |
|---|---|
| DeserializeElement(XmlReader, Boolean) |
Lee XML del archivo de configuración. (Heredado de ConfigurationElement) |
| Equals(Object) |
Compara la instancia de ConfigurationElement actual con el objeto especificado. (Heredado de ConfigurationElement) |
| GetHashCode() |
Obtiene un valor único que representa la instancia de ConfigurationElement actual. (Heredado de ConfigurationElement) |
| GetTransformedAssemblyString(String) |
Devuelve la versión transformada del nombre de ensamblado especificado. (Heredado de ConfigurationElement) |
| GetTransformedTypeString(String) |
Devuelve la versión transformada del nombre de tipo especificado. (Heredado de ConfigurationElement) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| Init() |
Establece el ConfigurationElement objeto en su estado inicial. (Heredado de ConfigurationElement) |
| InitializeDefault() |
Se usa para inicializar un conjunto predeterminado de valores para el ConfigurationElement objeto . (Heredado de ConfigurationElement) |
| IsModified() |
Indica si este elemento de configuración se ha modificado desde que se guardó o cargó por última vez, cuando se implementó en una clase derivada. (Heredado de ConfigurationElement) |
| IsReadOnly() |
Obtiene un valor que indica si el objeto ConfigurationElement es de solo lectura. (Heredado de ConfigurationElement) |
| ListErrors(IList) |
Agrega los errores de propiedad no válida en este ConfigurationElement objeto y, en todos los subelementos, a la lista pasada. (Heredado de ConfigurationElement) |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Obtiene un valor que indica si se encuentra un atributo desconocido durante la deserialización. (Heredado de ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Obtiene un valor que indica si se encuentra un elemento desconocido durante la deserialización. (Heredado de ConfigurationElement) |
| OnRequiredPropertyNotFound(String) |
Produce una excepción cuando no se encuentra una propiedad necesaria. (Heredado de ConfigurationElement) |
| PostDeserialize() |
Se llama después de la deserialización. (Heredado de ConfigurationElement) |
| PreSerialize(XmlWriter) |
Se llama antes de la serialización. (Heredado de ConfigurationElement) |
| Reset(ConfigurationElement) |
Restablece el estado interno del objeto ConfigurationElement, incluidos los bloqueos y las colecciones de propiedades. (Heredado de ConfigurationElement) |
| ResetModified() |
Restablece el valor del método IsModified() a |
| SerializeElement(XmlWriter, Boolean) |
Escribe el contenido de este elemento de configuración en el archivo de configuración cuando se implementa en una clase derivada. (Heredado de ConfigurationElement) |
| SerializeToXmlElement(XmlWriter, String) |
Escribe las etiquetas externas de este elemento de configuración en el archivo de configuración cuando se implementa en una clase derivada. (Heredado de ConfigurationElement) |
| SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Establece una propiedad en el valor especificado. (Heredado de ConfigurationElement) |
| SetReadOnly() |
Establece la propiedad IsReadOnly() para el objeto ConfigurationElement y todos los subelementos. (Heredado de ConfigurationElement) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
| Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Modifica el objeto ConfigurationElement para quitar todos los valores que no se deben guardar. (Heredado de ConfigurationElement) |
