Como: usar a ferramenta de definição de esquema XML para gerar classes e documentos de esquema XMLHow to: Use the XML Schema Definition Tool to Generate Classes and XML Schema Documents

A ferramenta de Definição de Esquema XML (Xsd.exe) permite gerar um esquema XML que descreve uma classe ou gerar a classe definida por um esquema XML.The XML Schema Definition tool (Xsd.exe) allows you to generate an XML schema that describes a class or to generate the class defined by an XML schema. Os seguintes procedimentos mostram como executar essas operações.The following procedures show how to perform these operations.

Para gerar classes que estão em conformidade com um esquema específicoTo generate classes that conform to a specific schema

  1. Abra um prompt de comando.Open a command prompt.

  2. Passe o esquema XML como um argumento para a ferramenta de definição de esquema XML, que cria um conjunto de classes que correspondem precisamente ao Esquema XML, por exemplo:Pass the XML Schema as an argument to the XML Schema Definition tool, which creates a set of classes that are precisely matched to the XML Schema, for example:

    xsd mySchema.xsd  
    

    A ferramenta somente pode processar esquemas que fazem referência à especificação de XML World Wide Web Consortium de 16 de março de 2001.The tool can only process schemas that reference the World Wide Web Consortium XML specification of March 16, 2001. Em outras palavras, o namespace do esquema XML deve ser "http://www.w3.org/2001/XMLSchema" conforme mostrado no exemplo a seguir.In other words, the XML Schema namespace must be "http://www.w3.org/2001/XMLSchema" as shown in the following example.

    <?xml version="1.0" encoding="utf-8"?>  
    <xs:schema attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="" xmlns:xs="http://www.w3.org/2001/XMLSchema">  
    
  3. Modifique as classes com métodos, propriedades ou campos, conforme o necessário.Modify the classes with methods, properties, or fields, as necessary. Para obter mais informações sobre como modificar uma classe com atributos, consulte Controlando a serialização XML usando atributos e Atributos que controlam a serialização SOAP codificada.For more information about modifying a class with attributes, see Controlling XML Serialization Using Attributes and Attributes That Control Encoded SOAP Serialization.

É geralmente útil examinar o esquema do fluxo de XML que é gerado quando instâncias de uma classe (ou classes) são serializadas.It is often useful to examine the schema of the XML stream that is generated when instances of a class (or classes) are serialized. Por exemplo, você pode publicar seu esquema para outros usarem ou pode compará-lo com um esquema com o qual está tentando obter conformidade.For example, you might publish your schema for others to use, or you might compare it to a schema with which you are trying to achieve conformity.

Para gerar um documento de esquema XML de um conjunto de classesTo generate an XML Schema document from a set of classes

  1. Compile uma classe ou classes em uma DLL.Compile the class or classes into a DLL.

  2. Abra um prompt de comando.Open a command prompt.

  3. Passe a DLL como argumento para Xsd.exe, por exemplo:Pass the DLL as an argument to Xsd.exe, for example:

    xsd MyFile.dll  
    

    O esquema (ou esquemas) serão escritos, começando com o nome "schema0.xsd".The schema (or schemas) will be written, beginning with the name "schema0.xsd".

Consulte tambémSee also