SchemaImporterExtension SchemaImporterExtension SchemaImporterExtension SchemaImporterExtension Class

Definición

Le permite personalizar el código generado a partir de un documento del Lenguaje de descripción de servicios Web (WSDL) cuando se utilizan herramientas de consulta automatizadas.Allows you to customize the code generated from a Web Services Description Language (WSDL) document when using automated query tools.

public ref class SchemaImporterExtension abstract
public abstract class SchemaImporterExtension
type SchemaImporterExtension = class
Public MustInherit Class SchemaImporterExtension
Herencia
SchemaImporterExtensionSchemaImporterExtensionSchemaImporterExtensionSchemaImporterExtension
Derivado

Ejemplos

Vea el ejemplo de tecnología SchemaImporterExtension.See the SchemaImporterExtension Technology Sample. Tenga en cuenta que en este ejemplo no se incluye un ensamblado firmado.Note that this example does not include a signed assembly. En su lugar, muestra cómo usar SchemaImporterExtension con una ventana de comandos.Instead, it demonstrates how to use the SchemaImporterExtension with a command window.

Comentarios

La importación de esquemas se produce siempre que se genera un proxy de servicio Web a través de una herramienta como el cuadro de diálogo Agregar referencia Web que se encuentra en Visual Studio o mediante la herramienta lenguaje de descripción de servicios web (WSDL. exe).Schema importation occurs whenever a Web service proxy is produced through a tool such as the Add Web Reference dialog box found in Visual Studio, or by using the Web Services Description Language Tool (Wsdl.exe). La importación de esquemas también se produce cuando se usa la herramienta de definición de esquemas XML (XSD. exe) para generar código a partir de un documento XSD específico.Schema importation also occurs when using the XML Schema Definition Tool (Xsd.exe) to generate code from a specific XSD document.

La SchemaImporterExtension clase le permite modificar el código generado al usar cualquiera de estas herramientas.The SchemaImporterExtension class allows you to modify the code generated when using any of these tools. Por ejemplo, puede tener una clase existente que procese pedidos de libros en un sistema y tenga un documento XSD existente que proporcione los pedidos.For example, you may have an existing class that processes book orders on a system and you have an existing XSD document that supplies your orders. Con la SchemaImporterExtension clase, puede habilitar una de las herramientas para generar código que use la clase.Using the SchemaImporterExtension class, you can enable one of the tools to generate code that uses your class.

Para controlar la generación del código, debe usar las clases que se encuentran en el System.CodeDom espacio de nombres.In order to control the generation of the code, you must use the classes found in the System.CodeDom namespace. Para obtener más información, vea usar la referencia rápidade CodeDom y CodeDom.For more information, see Using the CodeDOM and CodeDOM Quick Reference.

Los pasos para habilitar la herramienta WSDL. exe (que, a su vez, usan otras herramientas, como el cuadro de diálogo Agregar referencia Web) para usar la extensión son:The steps to enabling the WSDL.exe tool (which in turn is used by other tools such as the Add Web Reference dialog box) to use your extension are:

  1. Cree una implementación de la SchemaImporterExtension clase.Create an implementation of the SchemaImporterExtension class.

  2. Use el ImportSchemaType método para escribir código para el generador de código.Use the ImportSchemaType method to write code for the code generator. El método contiene parámetros que le permiten examinar el tipo XSD interceptado y crear objetos CodeDOM que se utilizan para generar el nuevo código CLR.The method contains parameters that allow you to examine the intercepted XSD type and create CodeDOM objects that are used to generate the new CLR code.

  3. Si es necesario, utilice ImportAnyElement el método para <controlar xsd: cualquier elemento > que se encuentre en el documento XSD.If required, use the ImportAnyElement method to handle <xsd:any> elements found in the XSD document.

  4. Si es necesario, utilice ImportDefaultValue el método para examinar los valores predeterminados que se encuentran en el documento XSD y devolver un valor predeterminado diferente.If required, use the ImportDefaultValue method to examine default values found in the XSD document and return a different default value.

  5. Compile la extensión en una biblioteca.Compile your extension into a library.

  6. Firmar el ensamblado.Sign the assembly.

  7. Instale el ensamblado en la caché de ensamblados global (GAC).Install the assembly in the Global Assembly Cache (GAC).

  8. Modifique el archivo Machine. config para incluir la extensión.Modify the machine.config file to include the extension.

Constructores

SchemaImporterExtension() SchemaImporterExtension() SchemaImporterExtension() SchemaImporterExtension()

Inicializa una nueva instancia de la clase SchemaImporterExtension.Initializes a new instance of the SchemaImporterExtension class.

Métodos

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
ImportAnyElement(XmlSchemaAny, Boolean, XmlSchemas, XmlSchemaImporter, CodeCompileUnit, CodeNamespace, CodeGenerationOptions, CodeDomProvider) ImportAnyElement(XmlSchemaAny, Boolean, XmlSchemas, XmlSchemaImporter, CodeCompileUnit, CodeNamespace, CodeGenerationOptions, CodeDomProvider) ImportAnyElement(XmlSchemaAny, Boolean, XmlSchemas, XmlSchemaImporter, CodeCompileUnit, CodeNamespace, CodeGenerationOptions, CodeDomProvider) ImportAnyElement(XmlSchemaAny, Boolean, XmlSchemas, XmlSchemaImporter, CodeCompileUnit, CodeNamespace, CodeGenerationOptions, CodeDomProvider)

Controla la importación de los elementos <xsd: any> del esquema.Handles the importation of the <xsd:any> elements in the schema.

ImportDefaultValue(String, String) ImportDefaultValue(String, String) ImportDefaultValue(String, String) ImportDefaultValue(String, String)

Permite especificar el valor predeterminado para el tipo XSD que se está importando.Allows you to specify the default value for the XSD type being imported.

ImportSchemaType(String, String, XmlSchemaObject, XmlSchemas, XmlSchemaImporter, CodeCompileUnit, CodeNamespace, CodeGenerationOptions, CodeDomProvider) ImportSchemaType(String, String, XmlSchemaObject, XmlSchemas, XmlSchemaImporter, CodeCompileUnit, CodeNamespace, CodeGenerationOptions, CodeDomProvider) ImportSchemaType(String, String, XmlSchemaObject, XmlSchemas, XmlSchemaImporter, CodeCompileUnit, CodeNamespace, CodeGenerationOptions, CodeDomProvider) ImportSchemaType(String, String, XmlSchemaObject, XmlSchemas, XmlSchemaImporter, CodeCompileUnit, CodeNamespace, CodeGenerationOptions, CodeDomProvider)

Permite manipular el código que se ha generado examinando el esquema importado y especificando el tipo CLR que asigna.Allows you to manipulate the code generated by examining the imported schema and specifying the CLR type that it maps to.

ImportSchemaType(XmlSchemaType, XmlSchemaObject, XmlSchemas, XmlSchemaImporter, CodeCompileUnit, CodeNamespace, CodeGenerationOptions, CodeDomProvider) ImportSchemaType(XmlSchemaType, XmlSchemaObject, XmlSchemas, XmlSchemaImporter, CodeCompileUnit, CodeNamespace, CodeGenerationOptions, CodeDomProvider) ImportSchemaType(XmlSchemaType, XmlSchemaObject, XmlSchemas, XmlSchemaImporter, CodeCompileUnit, CodeNamespace, CodeGenerationOptions, CodeDomProvider) ImportSchemaType(XmlSchemaType, XmlSchemaObject, XmlSchemas, XmlSchemaImporter, CodeCompileUnit, CodeNamespace, CodeGenerationOptions, CodeDomProvider)

Permite manipular el código que se ha generado examinando el esquema importado y especificando el tipo CLR que asigna.Allows you to manipulate the code generated by examining the imported schema and specifying the CLR type that it maps to.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Se aplica a