Missing parameter in example code for code generation from xsd

[IdatBuschmann]

Type of issue

Code doesn't work

Description

Under the header "To generate classes that conform to a specific schema", step 2, the console code example is
xsd mySchema.xsd
This generates an error message: "Error: Can only generate one of classes or datasets."

The correct call to generate the classes for the schema is
xsd mySchema.xsd /c

Page URL

https://learn.microsoft.com/en-us/dotnet/standard/serialization/xml-schema-def-tool-gen

Content source URL

https://github.com/dotnet/docs/blob/main/docs/standard/serialization/xml-schema-def-tool-gen.md

Document Version Independent Id

77c8e5c2-62e7-a5f7-5b3e-bc7bb7ce8691

Article author

@gewarren

Metadata

• ID: c09c6ce9-09c1-e543-4efd-f01dba75e1cb
• Service: dotnet-fundamentals

[BartoszKlonowski]

Indeed, even the help of the xsd.exe says:

xsd.exe -
    Utility to generate schema or class files from given source.

xsd.exe <schema>.xsd /classes|dataset [/e:] [/l:] [/n:] [/o:] [/s] [/uri:]
xsd.exe <assembly>.dll|.exe [/outputdir:] [/type: [...]]
xsd.exe <instance>.xml [/outputdir:]
xsd.exe <schema>.xdr [/outputdir:]

     - OPTIONS -

/classes
    Generate classes for this schema. Short form is '/c'.

Although I don't think that this page says strictly about the classes only, but other "XML Schema Documents" as well, I still believe an additional sentence would be good to have there to emphasize about the options and what to pass to generate mentioned classes, for instance.

I will handle that addition.