Format WSDL par défaut

Le format WSDL par défaut est retourné lorsque la chaîne d'arguments wsdl est transmise à un point de terminaison HTTP SOAP exécuté sur une instance de SQL Server 2005, par exemple http://MyServer/MyEndpoint/sql?wsdl.

Pour les documents WSDL par défaut, les éléments de paramètres contiennent des mappages des types provenant des mappages WSDL sqltypes:type aux types de données système SQL Server 2005. Pour plus d'informations sur ces mappages, consultez Mappage des types de données dans les services Web XML natifs.

Le document WSDL par défaut généré par un point de terminaison spécifie le type de paramètres en faisant référence à l'un des types définis dans la rubrique Mappages des types de données ou a des sous-types de ces types, puis en ajoutant des restrictions supplémentaires. Pour tous les types de chaîne et binaires, le format WSDL par défaut retourné par le point de terminaison inclut un sous-type qui contient la facette XSD maxLength pour spécifier le nombre d'octets ou de caractères.

La facette maxLength n'est pas générée pour les types de longueur variable qui sont déclarés avec le spécificateur (max). Pour les types de données decimal et numeric, le format WSDL par défaut génère un sous-type qui inclut les facettes XSD totalDigits et fractionDigits, qui décrivent la précision et l'échelle du paramètre.

Mappages de types SQL Server à Common Language Runtime pour WSDL par défaut

Les instances WSDL par défaut prennent en charge le mappage des types de données SQL Server aux types CLR (Common Language Runtime) fournis dans Microsoft .NET Framework 2.0. Comme certains types de données CLR intégrés ne correspondent pas correctement aux types de données SQL Server, l'espace de noms System.Data.SqlTypes est fourni dans .NET Framework 2.0. Ceci active un système de types managés capable de traiter spécifiquement de nombreuses facettes du système de types de données SQL Server 2005 qui ne peut pas être mappé autrement dans les types XSD.

Pour la version .NET Framework 2.0, l'outil Web Services Definition Language Tool (Wsdl.exe) possède une prise en charge intégrée pour générer les mappages appropriés de SQL Server à CLR pour les instances WSDL par défaut. Cette prise en charge est disponible si vous utilisez Wsdl.exe à l'invite de commandes ou si vous ajoutez une référence Web à un projet Visual Studio 2005.

Dans les instances WSDL générées par l'exploitation de cette prise en charge des mappages de types, tous les types de données SQL Server sont codés en déclarant et en utilisant un URI d'espace de noms (https://schemas.microsoft.com/sqlserver/2004/sqltypes) et son préfixe correspondant (sqltypes). Le tableau suivant illustre comment les mappages de **sqltype:**type dans les instances WSDL générées par le biais de l'outil Wsdl.exe sont mappés à leurs types CLR correspondants.

1 Mappé au wrapper de classe pour un tableau d'objets System.Xml.XmlNode. La classe du wrapper est nommée xml pour les paramètres XML non typés, mais utilise un nom généré pour les paramètres XML typés.

2 Mappé à un wrapper de classe autour d'un unique objet System.Xml.XmlElement utilisant un nom généré.

Traitement du type de données xml dans WSDL par défaut

Lorsque les paramètres du type de données xml sont définis dans le format WSDL par défaut, ils sont mappés au type de données WSDL sqltypes:xml. Ceci permet de spécifier un code XML correct sans validation supplémentaire de contenu ou de schéma. Pour plus d'informations, consultez Type de données xml

Pour les paramètres du type de données xml liés à un espace de noms XML, le document WSDL par défaut génère un élément <xsd:complexType> contenant des restrictions sur le type sqltypes:xml. À son tour, le code XML typé spécifie le type xsd:any comme règle de restriction. Comme illustré dans l'exemple suivant, cette restriction spécifie à son tour l'attribut processContents en définissant sa valeur sur strict et spécifie également l'attribut namespace en définissant sa valeur sur une liste des espaces de noms XML correspondants associés à la collection de schémas à laquelle le code XML typé est lié.

<xsd:element name="xmlVal" minOccurs="1" maxOccurs="1" nillable="true">
    <xsd:complexType >
        <xsd:restriction base="sqltypes:xml">
             <xsd:any minOccurs="0" maxOccurs="unbounded" processContents="strict" namespace="NS1 NS2 ...." /> 
        </xsd:restriction>
    </xsd:complexType>
</xsd:element>

Voir aussi

Référence

Format WSDL simple
Mise en œuvre d'une prise en charge WSDL personnalisée

Concepts

Utilisation de WSDL

Aide et Informations

Assistance sur SQL Server 2005