Partager via

<add>, élément de <soapExtensionTypes>

  • Article

Cette rubrique est spécifique à une technologie existante. Les services Web XML et les clients du service Web XML doivent à présent être créés à l'aide de Windows Communication Foundation.

Ajoute une classe d'extensions SOAP spécifiée qui fournit le traitement étendu des messages SOAP sur le client ou le service Web.

Hiérarchie de schéma

<configuration>
  <system.web>
    <webServices>, élément
      <soapExtensionTypes>, élément
        <add>, élément de <soapExtensionTypes>

Syntaxe

<add type="fully qualified type name [,Version=version number] [,Culture=culture] [,PublicKeyToken= token]"
   priority="number"
   group="0|1"/>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut Description

type

Attribut requis.

Spécifie la classe d'extension SOAP à ajouter. La valeur d'attribut type doit figurer sur une ligne et inclure le nom de type qualifié complet. Lorsque l'assembly est placé dans le Global Assembly Cache (GAC), il doit également inclure la version, la culture et le jeton de clé publique de l'assembly signé.

priority

Attribut requis.

Avec l'attribut group, spécifie l'ordre relatif dans lequel s'exécute une extension SOAP lorsque plusieurs extensions SOAP sont configurées en vue de leur exécution. Dans chaque group, l'attribut priority distingue la priorité relative générale de l'extension SOAP. Un numéro de priority inférieur indique une priorité plus élevée pour l'extension SOAP. La plus petite valeur possible pour l'attribut priority est 1.

group

Attribut requis.

  • Avec l'attribut priority, spécifie l'ordre relatif dans lequel s'exécute une extension SOAP lorsque plusieurs extensions SOAP sont configurées en vue de leur exécution.

Éléments enfants

Aucun(e).

Éléments parents

Élément Description

configuration

Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.

soapExtensionTypes

Spécifie les extensions SOAP utilisées pour examiner ou modifier le message SOAP au cours du traitement sur le client ou service Web. Les extensions SOAP augmentent les fonctionnalités des services Web.

system.web

Spécifie l'élément racine de la section de configuration ASP.NET.

webServices

Contrôle les paramètres de services Web déployés en utilisant ASP.NET et de clients de services Web qui sont exécutés sur le .NET Framework.

Exemple

L'exemple suivant ajoute une classe d'extension SOAP. Notez que la valeur de type doit figurer sur une ligne.

<configuration>
   <system.web>
      <webServices>
         <soapExtensionTypes>
            <add type="Contoso.Extensions.MySoapExtension, Version=2.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"  priority="2" group="0"/>
         </soapExtensionTypes>
      </webServices>
   </system.web>
</configuration>

Voir aussi

Référence

<webServices>, élément
<soapExtensionTypes>, élément
SoapExtension

Concepts

Modification de messages SOAP à l'aide d'extensions SOAP

Autres ressources

ASP.NET Settings Schema
Création de services Web XML à l'aide de clients de service Web XML et ASP.NET