ComUdtElement Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente un type défini par l’utilisateur (UDT) qui doit être inclus dans le contrat de service. Cette classe ne peut pas être héritée.
public ref class ComUdtElement sealed : System::Configuration::ConfigurationElementpublic sealed class ComUdtElement : System.Configuration.ConfigurationElementtype ComUdtElement = class
inherit ConfigurationElementPublic NotInheritable Class ComUdtElement
Inherits ConfigurationElement- Héritage
Exemples
L’exemple suivant illustre l’ajout de deux UDT spécifiques à la <userDefinedTypes> section du fichier de configuration à cet effet.
Remarques
Le runtime d’intégration COM+ crée des services en inspectant la bibliothèque de types. Lorsqu’un composant COM+ contient des méthodes qui passent un VARIANT, le système ne peut pas déterminer les types réels à passer avant l’exécution. Par conséquent, lorsque vous tentez de passer un type défini par l’utilisateur (UDT) au sein d’un VARIANT, il échoue car il n’est pas un type connu pour la sérialisation.
Pour contourner ce problème, vous pouvez ajouter les UDT au fichier de configuration afin qu’ils puissent être inclus en tant que types connus sur le contrat de service approprié. Pour ce faire, vous devez identifier de manière unique l’UDT et le ou les contrats, autrement dit l’interface COM d’origine qui l’utilise.
L’exemple suivant illustre l’ajout de deux UDT spécifiques à la <userDefinedTypes> section du fichier de configuration à cet effet.
Les attributs de l’élément <userDefinedType> sont définis comme suit :
typeName: attribut facultatif qui fournit le nom de type lisible. Cela n’est pas utilisé par le runtime, mais permet à un lecteur de distinguer les types.typeLibID: chaîne GUID qui spécifie la bibliothèque de types inscrite qui définit le type.typeLibVersion: chaîne qui spécifie la version de la bibliothèque de types qui définit le type.typeDefID: chaîne GUID qui spécifie le type UDT spécifique dans la bibliothèque de types inscrite.
Lorsque le service est initialisé, le runtime d’intégration COM+ recherche les types spécifiés et les ajoute à la collection de types connus pour les contrats spécifiés.
Constructeurs
| Nom | Description |
|---|---|
| ComUdtElement() |
Initialise une nouvelle instance de la classe ComUdtElement. |
| ComUdtElement(String) |
Initialise une nouvelle instance de la ComUdtElement classe avec la chaîne GUID spécifiée. |
Propriétés
| Nom | Description |
|---|---|
| CurrentConfiguration |
Obtient une référence à l’instance de niveau supérieur Configuration qui représente la hiérarchie de configuration à laquelle appartient l’instance ConfigurationElement actuelle. (Hérité de ConfigurationElement) |
| ElementInformation |
Obtient un objet ElementInformation qui contient les informations et fonctionnalités non personnalisables de l’objet ConfigurationElement. (Hérité de ConfigurationElement) |
| ElementProperty |
Obtient l’objet ConfigurationElementProperty qui représente l’objet ConfigurationElement lui-même. (Hérité de ConfigurationElement) |
| EvaluationContext |
Obtient l'objet ContextInformation pour l'objet ConfigurationElement. (Hérité de ConfigurationElement) |
| HasContext |
Obtient une valeur qui indique si la propriété CurrentConfiguration est |
| Item[ConfigurationProperty] |
Obtient ou définit une propriété ou un attribut de cet élément de configuration. (Hérité de ConfigurationElement) |
| Item[String] |
Obtient ou définit une propriété, un attribut ou un élément enfant de cet élément de configuration. (Hérité de ConfigurationElement) |
| LockAllAttributesExcept |
Obtient la collection d’attributs verrouillés. (Hérité de ConfigurationElement) |
| LockAllElementsExcept |
Obtient la collection d’éléments verrouillés. (Hérité de ConfigurationElement) |
| LockAttributes |
Obtient la collection d’attributs verrouillés. (Hérité de ConfigurationElement) |
| LockElements |
Obtient la collection d’éléments verrouillés. (Hérité de ConfigurationElement) |
| LockItem |
Obtient ou définit une valeur indiquant si l’élément est verrouillé. (Hérité de ConfigurationElement) |
| Name |
Obtient ou définit le nom de type lisible. |
| Properties |
Obtient la collection de propriétés. (Hérité de ConfigurationElement) |
| TypeDefID |
Obtient ou définit une chaîne GUID qui identifie le type UDT spécifique dans la bibliothèque de types inscrite. |
| TypeLibID |
Obtient ou définit une chaîne GUID qui identifie la bibliothèque de types inscrite qui définit le type. |
| TypeLibVersion |
Obtient ou définit une chaîne qui identifie la version de la bibliothèque de types qui définit le type. |
Méthodes
| Nom | Description |
|---|---|
| DeserializeElement(XmlReader, Boolean) |
Lit le code XML à partir du fichier de configuration. (Hérité de ConfigurationElement) |
| Equals(Object) |
Compare l’instance actuelle ConfigurationElement à l’objet spécifié. (Hérité de ConfigurationElement) |
| GetHashCode() |
Obtient une valeur unique représentant l’instance actuelle ConfigurationElement . (Hérité de ConfigurationElement) |
| GetTransformedAssemblyString(String) |
Retourne la version transformée du nom d’assembly spécifié. (Hérité de ConfigurationElement) |
| GetTransformedTypeString(String) |
Retourne la version transformée du nom de type spécifié. (Hérité de ConfigurationElement) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| Init() |
Définit l’objet ConfigurationElement à son état initial. (Hérité de ConfigurationElement) |
| InitializeDefault() |
Permet d’initialiser un jeu de valeurs par défaut pour l’objet ConfigurationElement. (Hérité de ConfigurationElement) |
| IsModified() |
Indique si cet élément de configuration a été modifié depuis son dernier enregistrement ou chargement, lorsqu’il est implémenté dans une classe dérivée. (Hérité de ConfigurationElement) |
| IsReadOnly() |
Obtient une valeur indiquant si l’objet ConfigurationElement est en lecture seule. (Hérité de ConfigurationElement) |
| ListErrors(IList) |
Ajoute les erreurs de propriété non valides dans cet objet ConfigurationElement et, dans tous les sous-éléments, à la liste passée. (Hérité de ConfigurationElement) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Obtient une valeur indiquant si un attribut inconnu est rencontré lors de la désérialisation. (Hérité de ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Obtient une valeur indiquant si un élément inconnu est rencontré lors de la désérialisation. (Hérité de ConfigurationElement) |
| OnRequiredPropertyNotFound(String) |
Lève une exception lorsqu’une propriété requise est introuvable. (Hérité de ConfigurationElement) |
| PostDeserialize() |
Appelé après la désérialisation. (Hérité de ConfigurationElement) |
| PreSerialize(XmlWriter) |
Appelé avant la sérialisation. (Hérité de ConfigurationElement) |
| Reset(ConfigurationElement) |
Réinitialise l’état interne de l’objet ConfigurationElement , y compris les verrous et les collections de propriétés. (Hérité de ConfigurationElement) |
| ResetModified() |
Réinitialise la valeur de la IsModified() méthode |
| SerializeElement(XmlWriter, Boolean) |
Écrit le contenu de cet élément de configuration dans le fichier de configuration en cas d’implémentation dans une classe dérivée. (Hérité de ConfigurationElement) |
| SerializeToXmlElement(XmlWriter, String) |
Écrit les balises externes de cet élément de configuration dans le fichier de configuration en cas d’implémentation dans une classe dérivée. (Hérité de ConfigurationElement) |
| SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Définit une propriété sur la valeur spécifiée. (Hérité de ConfigurationElement) |
| SetReadOnly() |
Définit la IsReadOnly() propriété de l’objet ConfigurationElement et de tous les sous-éléments. (Hérité de ConfigurationElement) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
| Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Modifie l’objet ConfigurationElement pour supprimer toutes les valeurs qui ne doivent pas être enregistrées. (Hérité de ConfigurationElement) |
