SchemaImporterExtension, classe (System.Xml.Serialization.Advanced)

Changer de vue:
ScriptFree
Bibliothèque de classes .NET Framework
SchemaImporterExtension, classe
Cet article a fait l'objet d'une traduction manuelle. Pour afficher simultanément cette page et le contenu source en anglais, choisissez le paramètre d'affichage Basse densité.

Vous permet de personnaliser le code généré dans un document WSDL (Web Services Description Language) pendant l'utilisation d'outils de recherche automatisés.

Hiérarchie d'héritage

System.Object
  System.Xml.Serialization.Advanced.SchemaImporterExtension
    System.Data.DataSetSchemaImporterExtension
    System.Data.Design.TypedDataSetSchemaImporterExtension
    System.Data.SqlTypes.SqlTypesSchemaImporterExtensionHelper

Espace de noms :  System.Xml.Serialization.Advanced
Assembly :  System.Xml (dans System.Xml.dll)
Syntaxe

Visual Basic
Public MustInherit Class SchemaImporterExtension
C#
public abstract class SchemaImporterExtension
VisualC++
public ref class SchemaImporterExtension abstract
F#
[<AbstractClass>]
type SchemaImporterExtension =  class end

Le type SchemaImporterExtension expose les membres suivants.

Constructeurs

  Nom Description
Méthode protégée SchemaImporterExtension Initialise une nouvelle instance de la classe SchemaImporterExtension.
Début
Méthodes

  Nom Description
Méthode publique Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégée Finalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique ImportAnyElement Gère l'importation des éléments < xsd:any > dans le schéma.
Méthode publique ImportDefaultValue Vous permet de spécifier la valeur par défaut pour le type XSD qui est importé.
Méthode publique ImportSchemaType(XmlSchemaType, XmlSchemaObject, XmlSchemas, XmlSchemaImporter, CodeCompileUnit, CodeNamespace, CodeGenerationOptions, CodeDomProvider) Permet de manipuler le code généré en examinant le schéma importé et en spécifiant le type CLR auquel il correspond.
Méthode publique ImportSchemaType(String, String, XmlSchemaObject, XmlSchemas, XmlSchemaImporter, CodeCompileUnit, CodeNamespace, CodeGenerationOptions, CodeDomProvider) Permet de manipuler le code généré en examinant le schéma importé et en spécifiant le type CLR auquel il correspond.
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publique ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Début
Notes

L'importation de schéma se produit toutes les fois qu'un proxy de service Web est généré à l'aide d'un outil, tel que la boîte de dialogue Ajouter une référence Web qui se trouve dans Visual Studio, ou en utilisant le Web Services Description Language Tool (Wsdl.exe). L'importation de schéma se produit également lorsque XML Schema Definition Tool (Xsd.exe) est utilisé pour générer le code d'un document XSD spécifique.

La classe SchemaImporterExtension vous permet de modifier le code généré lors de l'utilisation de chacun de ces outils. Par exemple, une classe existante peut traiter des ordres sur un système et un document XSD peut fournir ces ordres. À l'aide de la classe SchemaImporterExtension, vous pouvez autoriser l'un des outils à générer un code qui utilise votre classe.

Pour contrôler la génération du code, vous devez utiliser les classes de l'espace de noms System.CodeDom. Pour plus d'informations, consultez Utilisation du CodeDOM et Aide-mémoire de CodeDOM.

Les étapes pour autoriser l'outil WSDL.exe (utilisé ensuite par d'autres outils, tels que la boîte de dialogue Ajouter une référence Web) à utiliser votre extension sont :

  1. Créez une implémentation de la classe SchemaImporterExtension.

  2. Utilisez la méthode ImportSchemaType pour écrire un code pour le générateur de code. La méthode contient des paramètres qui vous permettent d'examiner le type XSD intercepté et de créer les objets CodeDOM qui sont utilisés pour générer le nouveau code CLR.

  3. Si nécessaire, utilisez la méthode ImportAnyElement pour gérer les éléments < xsd:any > trouvés dans le document XSD.

  4. Si nécessaire, utilisez la méthode ImportDefaultValue pour examiner les valeurs par défaut trouvées dans le document XSD et retourner une valeur par défaut différente.

  5. Compilez votre extension dans une bibliothèque.

  6. Signez l'assembly.

  7. Installez l'assembly dans le GAC (Global Assembly Cache).

  8. Modifiez le fichier machine.config pour inclure l'extension.

Exemples

Consultez SchemaImporterExtension Technology Sample. Notez que cet exemple n'inclut pas d'assembly signé. Il montre comment utiliser le SchemaImporterExtension avec une fenêtre de commande.

Informations de version

.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1
Plateformes

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Voir aussi

Référence