home *** CD-ROM | disk | FTP | other *** search
/ io Programmo 40 / IOPROG_40.ISO / SOFT / NETFrameworkSDK.exe / comsdk.cab / samples.exe / QuickStart / howto / doc / XMLSerialization / XSDToCls.aspx < prev   
Encoding:
Text File  |  2000-06-06  |  2.9 KB  |  50 lines
  1. <%@ Register TagPrefix="Acme" TagName="SourceRef" Src="/quickstart/util/SrcRef.aspx"%>
  2.  
  3. <!-- #include virtual="/quickstart/howto/include/header.inc" -->
  4.  
  5. <script language="C#" runat="server">
  6.  
  7.     public void Page_Load(Object sender, EventArgs E) 
  8.     {
  9.         // shell the explorer to a directory
  10.          Ref.ViewSource = "/quickstart/howto/samples/Xmlserialization/PurchaseOrderXsd.src";
  11.         Ref.Icon = "/quickstart/images/genicon.gif";
  12.         Ref.Caption = "PurchaseOrder.XSD";
  13.  
  14.        RefCode.ViewSource = "/quickstart/howto/samples/Xmlserialization/PurchaseOrder.src";
  15.         RefCode.Icon = "/quickstart/images/genicon.gif";
  16.         RefCode.Caption = "PurchaseOrder.cs";
  17.  
  18.     }
  19.  
  20. </script>
  21.  
  22. <h4>How do I create classes from an XSD schema?</h4>
  23.  
  24. This topic will describe how to create classes that can be used to read and write XML that is defined by an XML Schema Description (XSD) file. Once you understand how to generate the classes for your XSD schema, you should read the <a href="RWObjFromXML.aspx">"How Do I Read and Write Objects From XML?"</a> topic to find out how to actually load XML into them, and save XML from them.
  25.  
  26. <ol>
  27. <li> Locate an XSD file.  In this example, we will use a purchase order schema, as follows: <p>
  28.  
  29.  
  30. <Acme:SourceRef id="Ref" runat="server" />
  31. <p>
  32. <li> Use the xsd.exe tool in the SDK to generate source code for the classes you want. Do this by specifying the name of the XSD file as an argument to the executable. The example below creates classes in C# using the purchaseorder.xsd schema and puts them in the XmlSerializationHowTo namespace:
  33. <div class="code"><xmp>
  34. xsd.exe -c -l:c# -n:XmlSerializationHowTo purchaseorder.xsd
  35. </xmp></div>
  36.  
  37. <li> The tool uses the xsd file to create a set of classes that can read XML files that use the schema you specified. Here is the code that gets created for the above schema:<p>
  38. <Acme:SourceRef id="RefCode" runat="server" />
  39. </ol>
  40.  
  41. In the code you will notice additional "Custom Metadata Attributes" above the field declarations. These are used to guide the Xml Serializer classes in properly reading and writing the XML.  They are basically "hints" to the parser.  For example, the Items field has a custom attribute applied to it to tell the serializer to that the Items field should contain an array of item objects which get created from the xml being loaded.<p>
  42. <div class="code"><xmp>
  43.     [XmlArray("items"), XmlArrayItem("item")]
  44.     public Item[] Items;
  45. </xmp></div>
  46. <p>
  47. For detailed information on these attributes, see the reference documentation in the SDK help.  They are located in the System.Xml.Serialization namespace. <p>
  48. Now that you understand how to generate the classes for your XSD schema, you should read the <a href="RWObjFromXML.aspx">"How Do I Read and Write Objects From XML?"</a> topic to find out how to actually load XML into them, and save XML from them.
  49. <!-- #include virtual="/quickstart/howto/include/footer.inc" -->
  50.