Partilhar via


Como: Usar a ferramenta de definição de esquema XML para gerar classes e documentos de esquema XML

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. Os procedimentos a seguir mostram como executar essas operações.

A ferramenta de definição de esquema XML (Xsd.exe) geralmente pode ser encontrada no seguinte caminho:
C:\Arquivos de Programas (x86)\Microsoft SDKs\Windows\{version}\bin\NETFX {version} Tools\

Para gerar classes que estejam em conformidade com um esquema específico

  1. Abra uma linha de comandos.

  2. Passe o esquema XML como um argumento para a ferramenta de definição de esquema XML, que cria um conjunto de classes que são precisamente correspondidas ao esquema XML, por exemplo:

    xsd mySchema.xsd /classes
    

    (A /classes opção neste comando é usada para gerar classes para o mySchema esquema.) A ferramenta só pode processar esquemas que façam referência à especificação XML do World Wide Web Consortium de 16 de março de 2001. Em outras palavras, o namespace do esquema XML deve ser "http://www.w3.org/2001/XMLSchema", conforme mostrado no exemplo a seguir.

    <?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 necessário. 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.

Muitas vezes, é útil examinar o esquema do fluxo XML que é gerado quando instâncias de uma classe (ou classes) são serializadas. Por exemplo, você pode publicar seu esquema para outros usarem, ou você pode compará-lo a um esquema com o qual você está tentando alcançar a conformidade.

Para gerar um documento de esquema XML a partir de um conjunto de classes

  1. Compile a classe ou classes em uma DLL.

  2. Abra uma linha de comandos.

  3. Passe a DLL como um argumento para Xsd.exe, por exemplo:

    xsd MyFile.dll  
    

    O esquema (ou esquemas) será escrito, começando com o nome "schema0.xsd".

Consulte também