How to create a XSD schema from a class?

Go To StackoverFlow.com

45

I'm having a hard time with the XSD files.

I'm trying to create an XSD file from a class:

public enum Levels { Easy, Medium, Hard }
public sealed class Configuration
{
    public string Name { get;set; }
    public Levels Level { get; set; }
    public ConfigurationSpec { get;set;}
}

public abstract class ConfigurationSpec { }
public class ConfigurationSpec1
{
    // ...
}
public class ConfigurationSpec2
{
    // ...
}

Please note that I have an abstract class inside of Configuration. With that feature, is it possible to create the XSD and if it's possible how?

The idea is to pass the class Configuration to the XSD.

2012-04-04 18:27
by Darf Zon
You can use the free XML Schema Definition Tool (Xsd.exe) - Todd Hilehoffer 2012-04-04 18:45


32

You can use XSD.exe (Available from your Visual Studio Installation.)

public sealed class Configuration
{
 public string Name { get; set; }
 public Levels Level { get; set; }
 public ConfigurationSpec Spec { get; set; }
}
 public abstract class ConfigurationSpec { }
 public class ConfigurationSpec1    {   }
public class ConfigurationSpec2 {   }

results in

<?xml version="1.0" encoding="utf-8"?>
<xs:schema elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="Levels" type="Levels" />
  <xs:simpleType name="Levels">
    <xs:restriction base="xs:string">
      <xs:enumeration value="Easy" />
      <xs:enumeration value="Medium" />
      <xs:enumeration value="Hard" />
    </xs:restriction>
  </xs:simpleType>
  <xs:element name="Configuration" nillable="true" type="Configuration" />
  <xs:complexType name="Configuration">
    <xs:sequence>
      <xs:element minOccurs="0" maxOccurs="1" name="Name" type="xs:string" />
      <xs:element minOccurs="1" maxOccurs="1" name="Level" type="Levels" />
      <xs:element minOccurs="0" maxOccurs="1" name="Spec" type="ConfigurationSpec" />
    </xs:sequence>
  </xs:complexType>
  <xs:complexType name="ConfigurationSpec" abstract="true" />
  <xs:element name="ConfigurationSpec" nillable="true" type="ConfigurationSpec" />
  <xs:element name="ConfigurationSpec1" nillable="true" type="ConfigurationSpec1" />
  <xs:complexType name="ConfigurationSpec1" />
  <xs:element name="ConfigurationSpec2" nillable="true" type="ConfigurationSpec2" />
  <xs:complexType name="ConfigurationSpec2" />
</xs:schema>

All you have to do is compiling your assembly and run XSD.exe with the path to your assembly as argument. XSD.exe /? has a list of all arguments as well.

Example: XSD.exe C:\Dev\Project1\Bin\Debug\library.dll

2012-04-04 18:49
by Alex
Can you tell me which steps did you follow to generated it - Darf Zon 2012-04-04 18:57
It throws me: Error - Could not load file or assembly 'file:///C:/../test.exe' or one of its dependencies. An attempt was made to load a program with an incorrect format - Darf Zon 2012-04-04 19:52
@DarfZon try to change it to the same architecture as your OS (x64, x86) - Peter 2013-08-02 09:08
If anyone is still wondering, to choose a specific class to generate an xsd, type: xsd.exe C:\Dev\Project1\Bin\Debug\library.dll /t:. This should produce a schema from the code. You can specify the location of the output using the /out: command - Brad Germain 2014-07-01 22:21
@BradGermain, it should be /t:., but thanks for the ti - ps2goat 2015-07-22 16:45
Is their anyway of doing this in code as I have a project where i need run in browser but gen xsd' - rogue39nin 2015-11-28 21:09


76

You can successfully integrate xsd.exe into the Visual Studio IDE like this:

Go into Tools, External Tools and click the Add button:

2010

enter image description here

2015 / 2017

enter image description here

Title:

Create Schema From Class

Command (per framework):

4.0

C:\Program Files (x86)\Microsoft SDKs\Windows\v7.0A\Bin\NETFX 4.0 Tools\x64\xsd.exe

4.5.1

C:\Program Files (x86)\Microsoft SDKs\Windows\v8.1A\bin\NETFX 4.5.1 Tools\x64\xsd.exe

4.6.*

C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.6.* Tools\x64\xsd.exe

Arguments:

$(BinDir)$(TargetName).dll /outputdir:$(ItemDir) /type:$(ItemFileName)

Use Output window:

Prevents an extra command window from popping up and keeps a record of the output until you clear it. Probably a good idea.

Prompt For Arguments:

Check if you want to test the output or troubleshoot; otherwise, leave unchecked.

Click OK

How to use:

  1. Compile your project! XSD.exe only looks at compiled code.
  2. Click on the class in Solution Explorer.
  3. Click Tools, Create Schema From Class
  4. Click on the Show All Files button in the Solution Explorer.
  5. Look in the same folder as your class and you will see Schema0.xsd.
  6. Right-click on Schema0.xsd and choose Include In Project
  7. Rename Schema0.xsd to <the name of the class>.xsd
  8. (optional) You may have to edit this new xsd by hand if you want to edit xml files in the xml editor using this schema and you are not using all attributes. You can replace use="required" with use="optional" to get rid of the blue squiggly lines in the xml editor (which create warnings), if indeed these attributes are not required.
2014-10-26 17:24
by toddmo
Don't forget step 1 Compile, during usage, as I did. Took me some time to realize : - R. Schreurs 2016-02-25 12:55
@R.Schreurs, emphasis added. Thanks - toddmo 2016-02-25 18:44
This answer is very nice. Thanks. In your opinion is possible to add the comments wrote in the class also in the XSD output file - theLaw 2016-11-03 09:18
@theLaw, unfortunately, xsd.exe does not offer that as a command line argument. https://msdn.microsoft.com/en-us/library/x6c1kb0s%28v=vs.110%29.aspx?f=255&MSPPError=-214721739 - toddmo 2016-11-03 18:50
Error: Error while processing 'D:\Lavori\Amplifon\CRM Wrapper ES\Source\EAI.CRM.Xrm\bin\Test\EAI.CRM.Xrm.dll'. - There was an error reflecting type 'EAI.CRM.Xrm.Configuration.SoapLoggerConfiguration'. - You must implement a default accessor on System.Configuration.ConfigurationLockCollection because it inherits from ICollectio - Glauco Cucchiar 2016-11-04 15:26
@GlaucoCucchiar, this error is a serialization error, not really related to xsd.exe. See http://stackoverflow.com/questions/2331755/xmlserialize-exception or search for "You must implement a default accessor on System.Configuration.ConfigurationLockCollection because it inherits from ICollection" on StackOverflow - toddmo 2016-11-04 15:56
Warning: cannot generate schemas because no suitable types were found - Paul McCarthy 2017-03-15 14:07
@PaulMcCarthy, see http://stackoverflow.com/questions/3054687/error-when-generating-a-class-from-xsd-schema-file and / or search S/O on that error. It's fixable - toddmo 2017-03-15 22:10
how to generate for separate files for more than one clas - Ragavan 2017-06-21 05:49
@ragavan, just follow these steps, for one class at a time, and you will have one xsd file per class - toddmo 2017-06-21 23:08
Ads