ComContractElement.UserDefinedTypes Propriété

Référence

Définition

Espace de noms:: System.ServiceModel.Configuration

Assembly:: System.ServiceModel.dll

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.

Obtient une collection de types définis par l’utilisateur (UDT) à inclure dans le contrat de service. Cette classe ne peut pas être héritée.

public:
 property System::ServiceModel::Configuration::ComUdtElementCollection ^ UserDefinedTypes { System::ServiceModel::Configuration::ComUdtElementCollection ^ get(); };

[System.Configuration.ConfigurationProperty("userDefinedTypes")]
public System.ServiceModel.Configuration.ComUdtElementCollection UserDefinedTypes { get; }

[<System.Configuration.ConfigurationProperty("userDefinedTypes")>]
member this.UserDefinedTypes : System.ServiceModel.Configuration.ComUdtElementCollection

Public ReadOnly Property UserDefinedTypes As ComUdtElementCollection

Valeur de propriété

ComUdtElementCollection

Collection de types définis par l'utilisateur (UDT).

Attributs: ConfigurationPropertyAttribute

Exemples

L’exemple suivant illustre l’ajout de deux UDT spécifiques à la section <userDefinedTypes> du fichier de configuration à cet effet.

<comContracts>
  <comContract contract="{5163B1E7-F0CF-4B6A-9A02-4AB654F34284}"
   namespace="http://tempuri.org/5163B1E7-F0CF-4B6A-9A02-4AB654F34284"
   name="_Broker" requiresSession="true">
    <userDefinedTypes>
      <userDefinedType name="CustomerType"
         typeLibID="{91DC728C-4F1A-45de-A9B6-B538E209CEA6}"
         typeLibVersion="1.0"
         typeDefID="{D129765C-F211-434e-825A-9A63198C41F2}" />          
      <userDefinedType name="AddressType"
         typeLibID="{91DC728C-4F1A-45de-A9B6-B538E209CEA6}"
         typeLibVersion="1.0"
         typeDefID="{4616AE0D-687A-43B7-BC63-141AE3DFD099}" />          
    </userDefinedTypes>
    <exposedMethods>
      <add exposedMethod ="BuyStock" />
      <add exposedMethod ="SellStock" />
      <add exposedMethod ="ExecuteTransaction" />
    </exposedMethods>
  </comContract>
</comContracts>

Les attributs de l’élément <userDefinedType> sont définis comme suit :

typeName : attribut facultatif qui fournit le nom de type lisible. Il n'est pas utilisé par l'exécution mais aide le lecteur à 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 recherche les types spécifiés et les ajoute à la collection de types connus pour les contrats spécifiés.

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, le passage d'un UDT dans un VARIANT échoue car ce 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 comme 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, le ou les interfaces COM d'origine qui les utilisent.

S’applique à

Share via