Merge branch 'master' of http://github.com/mono/mono
[mono.git] / mcs / class / System.XML / Documentation / en / System.Xml.Serialization / XmlSerializer.xml
1 <Type Name="XmlSerializer" FullName="System.Xml.Serialization.XmlSerializer">
2   <TypeSignature Maintainer="auto" Language="C#" Value="public class XmlSerializer" />
3   <AssemblyInfo>
4     <AssemblyName>System.Xml</AssemblyName>
5     <AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
6     <AssemblyVersion>1.0.5000.0</AssemblyVersion>
7     <AssemblyVersion>2.0.0.0</AssemblyVersion>
8   </AssemblyInfo>
9   <ThreadSafetyStatement>To be added</ThreadSafetyStatement>
10   <Base>
11     <BaseTypeName>System.Object</BaseTypeName>
12   </Base>
13   <Interfaces />
14   <Docs>
15     <summary>Class for serializing and and deserializing objects to XML.</summary>
16     <remarks>
17       <para>
18 XML serialization is useful when we want to store object state and restore it back later. 
19 </para>
20
21 XML serialization main benefits are:
22
23 <list type="bullet"><item><term>It is easy to use</term></item><item><term>It is very fast</term></item><item><term>You have to write mimimum of code</term></item></list>
24
25
26 On the other hand:
27
28 <list type="bullet"><item><term>All properties or fields you want to serialize must be public</term></item><item><term>Not every object can be serialized</term></item><item><term>Your classes must be designed for serialization (e.g you must provide public paremeterless constructor.)</term></item></list><para>
29 Now take a look at simple XML serialization example:
30 </para><example><code lang="C#">
31 // Simple XML serialization
32 using System;
33 using System.IO;
34 using System.Xml.Serialization;
35
36 public class MyObject {
37     public int X;
38     public int Y;
39
40     public MyObject() {
41     }
42
43     public MyObject(int x, int y) {
44         this.X = x;
45         this.Y = y;
46     }    
47
48         public static void Main(string[] args)
49         {
50                 MyObject o = new MyObject (5, 8);
51                 using (FileStream fs = new FileStream("test.xml", FileMode.Create)) {        
52                         XmlSerializer serializer = new XmlSerializer(typeof(MyObject));
53                         serializer.Serialize(fs, o);    
54                 }
55         }
56 }
57   </code></example><para>
58 MyObject is here class that will be serialized. We serialize it's instance o to file test.xml. First we must create instance of XmlSerializer. As parameter we pass type of object we want to serialize. Then calling Serialize method with stream and object does serialization for us.
59 </para><para>
60 Next example shows how to load object back from XML.
61 </para><example><code lang="C#">
62 // Simple XML deserialization
63 using System;
64 using System.IO;
65 using System.Xml.Serialization;
66
67 public class MyObject {
68     public int X;
69     public int Y;
70
71     public MyObject() {
72     }
73
74     public MyObject(int x, int y) {
75         this.X = x;
76         this.Y = y;
77     }    
78
79         public static void Main(string[] args) {
80                 MyObject o;
81                 using (FileStream fs = File.OpenRead("test.xml")) {        
82                         XmlSerializer serializer = new XmlSerializer(typeof(MyObject));
83                         o = (MyObject) serializer.Deserialize(fs);      
84                 }
85                 Console.WriteLine("Deserialized object: " + o.X + "," + o.Y);
86         }
87 }
88   </code></example><para>
89 These were two simple examples, but reality is more complex. You will need to control serialization process. That can be done using various attributes from System.Xml.Serialization. Use
90
91
92 <list type="bullet"><item><term>XmlIgnore attribute for public fields or properties that you don't want to serialize</term></item></list></para></remarks>
93   </Docs>
94   <Members>
95     <Member MemberName=".ctor">
96       <MemberSignature Language="C#" Value="protected XmlSerializer ();" />
97       <MemberType>Constructor</MemberType>
98       <ReturnValue />
99       <Parameters />
100       <Docs>
101         <summary>To be added</summary>
102         <remarks>To be added</remarks>
103       </Docs>
104       <AssemblyInfo>
105         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
106         <AssemblyVersion>2.0.0.0</AssemblyVersion>
107       </AssemblyInfo>
108     </Member>
109     <Member MemberName=".ctor">
110       <MemberSignature Language="C#" Value="public XmlSerializer (Type type);" />
111       <MemberType>Constructor</MemberType>
112       <ReturnValue />
113       <Parameters>
114         <Parameter Name="type" Type="System.Type" />
115       </Parameters>
116       <Docs>
117         <param name="type">To be added: an object of type 'System.Type'</param>
118         <summary>To be added</summary>
119         <remarks>To be added</remarks>
120       </Docs>
121       <AssemblyInfo>
122         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
123         <AssemblyVersion>2.0.0.0</AssemblyVersion>
124       </AssemblyInfo>
125     </Member>
126     <Member MemberName=".ctor">
127       <MemberSignature Language="C#" Value="public XmlSerializer (System.Xml.Serialization.XmlTypeMapping xmlTypeMapping);" />
128       <MemberType>Constructor</MemberType>
129       <ReturnValue />
130       <Parameters>
131         <Parameter Name="xmlTypeMapping" Type="System.Xml.Serialization.XmlTypeMapping" />
132       </Parameters>
133       <Docs>
134         <param name="xmlTypeMapping">To be added: an object of type 'XmlTypeMapping'</param>
135         <summary>To be added</summary>
136         <remarks>To be added</remarks>
137       </Docs>
138       <AssemblyInfo>
139         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
140         <AssemblyVersion>2.0.0.0</AssemblyVersion>
141       </AssemblyInfo>
142     </Member>
143     <Member MemberName=".ctor">
144       <MemberSignature Language="C#" Value="public XmlSerializer (Type type, string defaultNamespace);" />
145       <MemberType>Constructor</MemberType>
146       <ReturnValue />
147       <Parameters>
148         <Parameter Name="type" Type="System.Type" />
149         <Parameter Name="defaultNamespace" Type="System.String" />
150       </Parameters>
151       <Docs>
152         <param name="type">To be added: an object of type 'System.Type'</param>
153         <param name="defaultNamespace">To be added: an object of type 'string'</param>
154         <summary>To be added</summary>
155         <remarks>To be added</remarks>
156       </Docs>
157       <AssemblyInfo>
158         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
159         <AssemblyVersion>2.0.0.0</AssemblyVersion>
160       </AssemblyInfo>
161     </Member>
162     <Member MemberName=".ctor">
163       <MemberSignature Language="C#" Value="public XmlSerializer (Type type, Type[] extraTypes);" />
164       <MemberType>Constructor</MemberType>
165       <ReturnValue />
166       <Parameters>
167         <Parameter Name="type" Type="System.Type" />
168         <Parameter Name="extraTypes" Type="System.Type[]" />
169       </Parameters>
170       <Docs>
171         <param name="type">To be added: an object of type 'System.Type'</param>
172         <param name="extraTypes">To be added: an object of type 'System.Type[]'</param>
173         <summary>To be added</summary>
174         <remarks>To be added</remarks>
175       </Docs>
176       <AssemblyInfo>
177         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
178         <AssemblyVersion>2.0.0.0</AssemblyVersion>
179       </AssemblyInfo>
180     </Member>
181     <Member MemberName=".ctor">
182       <MemberSignature Language="C#" Value="public XmlSerializer (Type type, System.Xml.Serialization.XmlAttributeOverrides overrides);" />
183       <MemberType>Constructor</MemberType>
184       <ReturnValue />
185       <Parameters>
186         <Parameter Name="type" Type="System.Type" />
187         <Parameter Name="overrides" Type="System.Xml.Serialization.XmlAttributeOverrides" />
188       </Parameters>
189       <Docs>
190         <param name="type">To be added: an object of type 'System.Type'</param>
191         <param name="overrides">To be added: an object of type 'XmlAttributeOverrides'</param>
192         <summary>To be added</summary>
193         <remarks>To be added</remarks>
194       </Docs>
195       <AssemblyInfo>
196         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
197         <AssemblyVersion>2.0.0.0</AssemblyVersion>
198       </AssemblyInfo>
199     </Member>
200     <Member MemberName=".ctor">
201       <MemberSignature Language="C#" Value="public XmlSerializer (Type type, System.Xml.Serialization.XmlRootAttribute root);" />
202       <MemberType>Constructor</MemberType>
203       <ReturnValue />
204       <Parameters>
205         <Parameter Name="type" Type="System.Type" />
206         <Parameter Name="root" Type="System.Xml.Serialization.XmlRootAttribute" />
207       </Parameters>
208       <Docs>
209         <param name="type">To be added: an object of type 'System.Type'</param>
210         <param name="root">To be added: an object of type 'XmlRootAttribute'</param>
211         <summary>To be added</summary>
212         <remarks>To be added</remarks>
213       </Docs>
214       <AssemblyInfo>
215         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
216         <AssemblyVersion>2.0.0.0</AssemblyVersion>
217       </AssemblyInfo>
218     </Member>
219     <Member MemberName=".ctor">
220       <MemberSignature Language="C#" Value="public XmlSerializer (Type type, System.Xml.Serialization.XmlAttributeOverrides overrides, Type[] extraTypes, System.Xml.Serialization.XmlRootAttribute root, string defaultNamespace);" />
221       <MemberType>Constructor</MemberType>
222       <ReturnValue />
223       <Parameters>
224         <Parameter Name="type" Type="System.Type" />
225         <Parameter Name="overrides" Type="System.Xml.Serialization.XmlAttributeOverrides" />
226         <Parameter Name="extraTypes" Type="System.Type[]" />
227         <Parameter Name="root" Type="System.Xml.Serialization.XmlRootAttribute" />
228         <Parameter Name="defaultNamespace" Type="System.String" />
229       </Parameters>
230       <Docs>
231         <param name="type">To be added: an object of type 'System.Type'</param>
232         <param name="overrides">To be added: an object of type 'XmlAttributeOverrides'</param>
233         <param name="extraTypes">To be added: an object of type 'System.Type[]'</param>
234         <param name="root">To be added: an object of type 'XmlRootAttribute'</param>
235         <param name="defaultNamespace">To be added: an object of type 'string'</param>
236         <summary>To be added</summary>
237         <remarks>To be added</remarks>
238       </Docs>
239       <AssemblyInfo>
240         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
241         <AssemblyVersion>2.0.0.0</AssemblyVersion>
242       </AssemblyInfo>
243     </Member>
244     <Member MemberName=".ctor">
245       <MemberSignature Language="C#" Value="public XmlSerializer (Type type, System.Xml.Serialization.XmlAttributeOverrides overrides, Type[] extraTypes, System.Xml.Serialization.XmlRootAttribute root, string defaultNamespace, string location, System.Security.Policy.Evidence evidence);" />
246       <MemberType>Constructor</MemberType>
247       <Parameters>
248         <Parameter Name="type" Type="System.Type" />
249         <Parameter Name="overrides" Type="System.Xml.Serialization.XmlAttributeOverrides" />
250         <Parameter Name="extraTypes" Type="System.Type[]" />
251         <Parameter Name="root" Type="System.Xml.Serialization.XmlRootAttribute" />
252         <Parameter Name="defaultNamespace" Type="System.String" />
253         <Parameter Name="location" Type="System.String" />
254         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
255       </Parameters>
256       <Docs>
257         <param name="type">To be added.</param>
258         <param name="overrides">To be added.</param>
259         <param name="extraTypes">To be added.</param>
260         <param name="root">To be added.</param>
261         <param name="defaultNamespace">To be added.</param>
262         <param name="location">To be added.</param>
263         <param name="evidence">To be added.</param>
264         <summary>To be added.</summary>
265         <remarks>To be added.</remarks>
266         <since version=".NET 2.0" />
267       </Docs>
268       <AssemblyInfo>
269         <AssemblyVersion>2.0.0.0</AssemblyVersion>
270       </AssemblyInfo>
271     </Member>
272     <Member MemberName="CanDeserialize">
273       <MemberSignature Language="C#" Value="public virtual bool CanDeserialize (System.Xml.XmlReader xmlReader);" />
274       <MemberType>Method</MemberType>
275       <ReturnValue>
276         <ReturnType>System.Boolean</ReturnType>
277       </ReturnValue>
278       <Parameters>
279         <Parameter Name="xmlReader" Type="System.Xml.XmlReader" />
280       </Parameters>
281       <Docs>
282         <param name="xmlReader">To be added: an object of type 'System.Xml.XmlReader'</param>
283         <summary>To be added</summary>
284         <returns>To be added: an object of type 'bool'</returns>
285         <remarks>To be added</remarks>
286       </Docs>
287       <AssemblyInfo>
288         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
289         <AssemblyVersion>2.0.0.0</AssemblyVersion>
290       </AssemblyInfo>
291     </Member>
292     <Member MemberName="CreateReader">
293       <MemberSignature Language="C#" Value="protected virtual System.Xml.Serialization.XmlSerializationReader CreateReader ();" />
294       <MemberType>Method</MemberType>
295       <ReturnValue>
296         <ReturnType>System.Xml.Serialization.XmlSerializationReader</ReturnType>
297       </ReturnValue>
298       <Parameters />
299       <Docs>
300         <summary>To be added</summary>
301         <returns>To be added: an object of type 'XmlSerializationReader'</returns>
302         <remarks>To be added</remarks>
303       </Docs>
304       <AssemblyInfo>
305         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
306         <AssemblyVersion>2.0.0.0</AssemblyVersion>
307       </AssemblyInfo>
308     </Member>
309     <Member MemberName="CreateWriter">
310       <MemberSignature Language="C#" Value="protected virtual System.Xml.Serialization.XmlSerializationWriter CreateWriter ();" />
311       <MemberType>Method</MemberType>
312       <ReturnValue>
313         <ReturnType>System.Xml.Serialization.XmlSerializationWriter</ReturnType>
314       </ReturnValue>
315       <Parameters />
316       <Docs>
317         <summary>To be added</summary>
318         <returns>To be added: an object of type 'XmlSerializationWriter'</returns>
319         <remarks>To be added</remarks>
320       </Docs>
321       <AssemblyInfo>
322         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
323         <AssemblyVersion>2.0.0.0</AssemblyVersion>
324       </AssemblyInfo>
325     </Member>
326     <Member MemberName="Deserialize">
327       <MemberSignature Language="C#" Value="public object Deserialize (System.IO.Stream stream);" />
328       <MemberType>Method</MemberType>
329       <ReturnValue>
330         <ReturnType>System.Object</ReturnType>
331       </ReturnValue>
332       <Parameters>
333         <Parameter Name="stream" Type="System.IO.Stream" />
334       </Parameters>
335       <Docs>
336         <param name="stream">To be added: an object of type 'System.IO.Stream'</param>
337         <summary>To be added</summary>
338         <returns>To be added: an object of type 'object'</returns>
339         <remarks>To be added</remarks>
340       </Docs>
341       <AssemblyInfo>
342         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
343         <AssemblyVersion>2.0.0.0</AssemblyVersion>
344       </AssemblyInfo>
345     </Member>
346     <Member MemberName="Deserialize">
347       <MemberSignature Language="C#" Value="public object Deserialize (System.IO.TextReader textReader);" />
348       <MemberType>Method</MemberType>
349       <ReturnValue>
350         <ReturnType>System.Object</ReturnType>
351       </ReturnValue>
352       <Parameters>
353         <Parameter Name="textReader" Type="System.IO.TextReader" />
354       </Parameters>
355       <Docs>
356         <param name="textReader">To be added: an object of type 'System.IO.TextReader'</param>
357         <summary>To be added</summary>
358         <returns>To be added: an object of type 'object'</returns>
359         <remarks>To be added</remarks>
360       </Docs>
361       <AssemblyInfo>
362         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
363         <AssemblyVersion>2.0.0.0</AssemblyVersion>
364       </AssemblyInfo>
365     </Member>
366     <Member MemberName="Deserialize">
367       <MemberSignature Language="C#" Value="protected virtual object Deserialize (System.Xml.Serialization.XmlSerializationReader reader);" />
368       <MemberType>Method</MemberType>
369       <ReturnValue>
370         <ReturnType>System.Object</ReturnType>
371       </ReturnValue>
372       <Parameters>
373         <Parameter Name="reader" Type="System.Xml.Serialization.XmlSerializationReader" />
374       </Parameters>
375       <Docs>
376         <param name="reader">To be added: an object of type 'XmlSerializationReader'</param>
377         <summary>To be added</summary>
378         <returns>To be added: an object of type 'object'</returns>
379         <remarks>To be added</remarks>
380       </Docs>
381       <AssemblyInfo>
382         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
383         <AssemblyVersion>2.0.0.0</AssemblyVersion>
384       </AssemblyInfo>
385     </Member>
386     <Member MemberName="Deserialize">
387       <MemberSignature Language="C#" Value="public object Deserialize (System.Xml.XmlReader xmlReader);" />
388       <MemberType>Method</MemberType>
389       <ReturnValue>
390         <ReturnType>System.Object</ReturnType>
391       </ReturnValue>
392       <Parameters>
393         <Parameter Name="xmlReader" Type="System.Xml.XmlReader" />
394       </Parameters>
395       <Docs>
396         <param name="xmlReader">To be added: an object of type 'System.Xml.XmlReader'</param>
397         <summary>To be added</summary>
398         <returns>To be added: an object of type 'object'</returns>
399         <remarks>To be added</remarks>
400       </Docs>
401       <AssemblyInfo>
402         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
403         <AssemblyVersion>2.0.0.0</AssemblyVersion>
404       </AssemblyInfo>
405     </Member>
406     <Member MemberName="Deserialize">
407       <MemberSignature Language="C#" Value="public object Deserialize (System.Xml.XmlReader xmlReader, string encodingStyle);" />
408       <MemberType>Method</MemberType>
409       <ReturnValue>
410         <ReturnType>System.Object</ReturnType>
411       </ReturnValue>
412       <Parameters>
413         <Parameter Name="xmlReader" Type="System.Xml.XmlReader" />
414         <Parameter Name="encodingStyle" Type="System.String" />
415       </Parameters>
416       <Docs>
417         <param name="xmlReader">To be added.</param>
418         <param name="encodingStyle">To be added.</param>
419         <summary>To be added.</summary>
420         <returns>To be added.</returns>
421         <remarks>To be added.</remarks>
422         <since version=".NET 2.0" />
423       </Docs>
424       <AssemblyInfo>
425         <AssemblyVersion>2.0.0.0</AssemblyVersion>
426       </AssemblyInfo>
427     </Member>
428     <Member MemberName="Deserialize">
429       <MemberSignature Language="C#" Value="public object Deserialize (System.Xml.XmlReader xmlReader, System.Xml.Serialization.XmlDeserializationEvents events);" />
430       <MemberType>Method</MemberType>
431       <ReturnValue>
432         <ReturnType>System.Object</ReturnType>
433       </ReturnValue>
434       <Parameters>
435         <Parameter Name="xmlReader" Type="System.Xml.XmlReader" />
436         <Parameter Name="events" Type="System.Xml.Serialization.XmlDeserializationEvents" />
437       </Parameters>
438       <Docs>
439         <param name="xmlReader">To be added.</param>
440         <param name="events">To be added.</param>
441         <summary>To be added.</summary>
442         <returns>To be added.</returns>
443         <remarks>To be added.</remarks>
444         <since version=".NET 2.0" />
445       </Docs>
446       <AssemblyInfo>
447         <AssemblyVersion>2.0.0.0</AssemblyVersion>
448       </AssemblyInfo>
449     </Member>
450     <Member MemberName="Deserialize">
451       <MemberSignature Language="C#" Value="public object Deserialize (System.Xml.XmlReader xmlReader, string encodingStyle, System.Xml.Serialization.XmlDeserializationEvents events);" />
452       <MemberType>Method</MemberType>
453       <ReturnValue>
454         <ReturnType>System.Object</ReturnType>
455       </ReturnValue>
456       <Parameters>
457         <Parameter Name="xmlReader" Type="System.Xml.XmlReader" />
458         <Parameter Name="encodingStyle" Type="System.String" />
459         <Parameter Name="events" Type="System.Xml.Serialization.XmlDeserializationEvents" />
460       </Parameters>
461       <Docs>
462         <param name="xmlReader">To be added.</param>
463         <param name="encodingStyle">To be added.</param>
464         <param name="events">To be added.</param>
465         <summary>To be added.</summary>
466         <returns>To be added.</returns>
467         <remarks>To be added.</remarks>
468         <since version=".NET 2.0" />
469       </Docs>
470       <AssemblyInfo>
471         <AssemblyVersion>2.0.0.0</AssemblyVersion>
472       </AssemblyInfo>
473     </Member>
474     <Member MemberName="FromMappings">
475       <MemberSignature Language="C#" Value="public static System.Xml.Serialization.XmlSerializer[] FromMappings (System.Xml.Serialization.XmlMapping[] mappings);" />
476       <MemberType>Method</MemberType>
477       <ReturnValue>
478         <ReturnType>System.Xml.Serialization.XmlSerializer[]</ReturnType>
479       </ReturnValue>
480       <Parameters>
481         <Parameter Name="mappings" Type="System.Xml.Serialization.XmlMapping[]" />
482       </Parameters>
483       <Docs>
484         <param name="mappings">To be added: an object of type 'XmlMapping[]'</param>
485         <summary>To be added</summary>
486         <returns>To be added: an object of type 'XmlSerializer[]'</returns>
487         <remarks>To be added</remarks>
488       </Docs>
489       <AssemblyInfo>
490         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
491         <AssemblyVersion>2.0.0.0</AssemblyVersion>
492       </AssemblyInfo>
493     </Member>
494     <Member MemberName="FromMappings">
495       <MemberSignature Language="C#" Value="public static System.Xml.Serialization.XmlSerializer[] FromMappings (System.Xml.Serialization.XmlMapping[] mappings, System.Security.Policy.Evidence evidence);" />
496       <MemberType>Method</MemberType>
497       <ReturnValue>
498         <ReturnType>System.Xml.Serialization.XmlSerializer[]</ReturnType>
499       </ReturnValue>
500       <Parameters>
501         <Parameter Name="mappings" Type="System.Xml.Serialization.XmlMapping[]" />
502         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
503       </Parameters>
504       <Docs>
505         <param name="mappings">To be added.</param>
506         <param name="evidence">To be added.</param>
507         <summary>To be added.</summary>
508         <returns>To be added.</returns>
509         <remarks>To be added.</remarks>
510         <since version=".NET 2.0" />
511       </Docs>
512       <AssemblyInfo>
513         <AssemblyVersion>2.0.0.0</AssemblyVersion>
514       </AssemblyInfo>
515     </Member>
516     <Member MemberName="FromMappings">
517       <MemberSignature Language="C#" Value="public static System.Xml.Serialization.XmlSerializer[] FromMappings (System.Xml.Serialization.XmlMapping[] mappings, Type type);" />
518       <MemberType>Method</MemberType>
519       <ReturnValue>
520         <ReturnType>System.Xml.Serialization.XmlSerializer[]</ReturnType>
521       </ReturnValue>
522       <Parameters>
523         <Parameter Name="mappings" Type="System.Xml.Serialization.XmlMapping[]" />
524         <Parameter Name="type" Type="System.Type" />
525       </Parameters>
526       <Docs>
527         <param name="mappings">To be added.</param>
528         <param name="type">To be added.</param>
529         <summary>To be added.</summary>
530         <returns>To be added.</returns>
531         <remarks>To be added.</remarks>
532         <since version=".NET 2.0" />
533       </Docs>
534       <AssemblyInfo>
535         <AssemblyVersion>2.0.0.0</AssemblyVersion>
536       </AssemblyInfo>
537     </Member>
538     <Member MemberName="FromTypes">
539       <MemberSignature Language="C#" Value="public static System.Xml.Serialization.XmlSerializer[] FromTypes (Type[] mappings);" />
540       <MemberType>Method</MemberType>
541       <ReturnValue>
542         <ReturnType>System.Xml.Serialization.XmlSerializer[]</ReturnType>
543       </ReturnValue>
544       <Parameters>
545         <Parameter Name="mappings" Type="System.Type[]" />
546       </Parameters>
547       <Docs>
548         <param name="mappings">To be added.</param>
549         <summary>To be added</summary>
550         <returns>To be added: an object of type 'XmlSerializer[]'</returns>
551         <remarks>To be added</remarks>
552       </Docs>
553       <AssemblyInfo>
554         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
555         <AssemblyVersion>2.0.0.0</AssemblyVersion>
556       </AssemblyInfo>
557     </Member>
558     <Member MemberName="GenerateSerializer">
559       <MemberSignature Language="C#" Value="public static System.Reflection.Assembly GenerateSerializer (Type[] types, System.Xml.Serialization.XmlMapping[] mappings);" />
560       <MemberType>Method</MemberType>
561       <ReturnValue>
562         <ReturnType>System.Reflection.Assembly</ReturnType>
563       </ReturnValue>
564       <Parameters>
565         <Parameter Name="types" Type="System.Type[]" />
566         <Parameter Name="mappings" Type="System.Xml.Serialization.XmlMapping[]" />
567       </Parameters>
568       <Docs>
569         <param name="types">To be added.</param>
570         <param name="mappings">To be added.</param>
571         <summary>To be added.</summary>
572         <returns>To be added.</returns>
573         <remarks>To be added.</remarks>
574         <since version=".NET 2.0" />
575       </Docs>
576       <AssemblyInfo>
577         <AssemblyVersion>2.0.0.0</AssemblyVersion>
578       </AssemblyInfo>
579     </Member>
580     <Member MemberName="GenerateSerializer">
581       <MemberSignature Language="C#" Value="public static System.Reflection.Assembly GenerateSerializer (Type[] types, System.Xml.Serialization.XmlMapping[] mappings, System.CodeDom.Compiler.CompilerParameters parameters);" />
582       <MemberType>Method</MemberType>
583       <ReturnValue>
584         <ReturnType>System.Reflection.Assembly</ReturnType>
585       </ReturnValue>
586       <Parameters>
587         <Parameter Name="types" Type="System.Type[]" />
588         <Parameter Name="mappings" Type="System.Xml.Serialization.XmlMapping[]" />
589         <Parameter Name="parameters" Type="System.CodeDom.Compiler.CompilerParameters" />
590       </Parameters>
591       <Docs>
592         <param name="types">To be added.</param>
593         <param name="mappings">To be added.</param>
594         <param name="parameters">To be added.</param>
595         <summary>To be added.</summary>
596         <returns>To be added.</returns>
597         <remarks>To be added.</remarks>
598         <since version=".NET 2.0" />
599       </Docs>
600       <AssemblyInfo>
601         <AssemblyVersion>2.0.0.0</AssemblyVersion>
602       </AssemblyInfo>
603     </Member>
604     <Member MemberName="GetXmlSerializerAssemblyName">
605       <MemberSignature Language="C#" Value="public static string GetXmlSerializerAssemblyName (Type type);" />
606       <MemberType>Method</MemberType>
607       <ReturnValue>
608         <ReturnType>System.String</ReturnType>
609       </ReturnValue>
610       <Parameters>
611         <Parameter Name="type" Type="System.Type" />
612       </Parameters>
613       <Docs>
614         <param name="type">To be added.</param>
615         <summary>To be added.</summary>
616         <returns>To be added.</returns>
617         <remarks>To be added.</remarks>
618         <since version=".NET 2.0" />
619       </Docs>
620       <AssemblyInfo>
621         <AssemblyVersion>2.0.0.0</AssemblyVersion>
622       </AssemblyInfo>
623     </Member>
624     <Member MemberName="GetXmlSerializerAssemblyName">
625       <MemberSignature Language="C#" Value="public static string GetXmlSerializerAssemblyName (Type type, string defaultNamespace);" />
626       <MemberType>Method</MemberType>
627       <ReturnValue>
628         <ReturnType>System.String</ReturnType>
629       </ReturnValue>
630       <Parameters>
631         <Parameter Name="type" Type="System.Type" />
632         <Parameter Name="defaultNamespace" Type="System.String" />
633       </Parameters>
634       <Docs>
635         <param name="type">To be added.</param>
636         <param name="defaultNamespace">To be added.</param>
637         <summary>To be added.</summary>
638         <returns>To be added.</returns>
639         <remarks>To be added.</remarks>
640         <since version=".NET 2.0" />
641       </Docs>
642       <AssemblyInfo>
643         <AssemblyVersion>2.0.0.0</AssemblyVersion>
644       </AssemblyInfo>
645     </Member>
646     <Member MemberName="Serialize">
647       <MemberSignature Language="C#" Value="public void Serialize (System.IO.Stream stream, object o);" />
648       <MemberType>Method</MemberType>
649       <ReturnValue>
650         <ReturnType>System.Void</ReturnType>
651       </ReturnValue>
652       <Parameters>
653         <Parameter Name="stream" Type="System.IO.Stream" />
654         <Parameter Name="o" Type="System.Object" />
655       </Parameters>
656       <Docs>
657         <param name="stream">To be added: an object of type 'System.IO.Stream'</param>
658         <param name="o">To be added: an object of type 'object'</param>
659         <summary>To be added</summary>
660         <remarks>To be added</remarks>
661       </Docs>
662       <AssemblyInfo>
663         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
664         <AssemblyVersion>2.0.0.0</AssemblyVersion>
665       </AssemblyInfo>
666     </Member>
667     <Member MemberName="Serialize">
668       <MemberSignature Language="C#" Value="public void Serialize (System.IO.TextWriter textWriter, object o);" />
669       <MemberType>Method</MemberType>
670       <ReturnValue>
671         <ReturnType>System.Void</ReturnType>
672       </ReturnValue>
673       <Parameters>
674         <Parameter Name="textWriter" Type="System.IO.TextWriter" />
675         <Parameter Name="o" Type="System.Object" />
676       </Parameters>
677       <Docs>
678         <param name="textWriter">To be added: an object of type 'System.IO.TextWriter'</param>
679         <param name="o">To be added: an object of type 'object'</param>
680         <summary>To be added</summary>
681         <remarks>To be added</remarks>
682       </Docs>
683       <AssemblyInfo>
684         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
685         <AssemblyVersion>2.0.0.0</AssemblyVersion>
686       </AssemblyInfo>
687     </Member>
688     <Member MemberName="Serialize">
689       <MemberSignature Language="C#" Value="protected virtual void Serialize (object o, System.Xml.Serialization.XmlSerializationWriter writer);" />
690       <MemberType>Method</MemberType>
691       <ReturnValue>
692         <ReturnType>System.Void</ReturnType>
693       </ReturnValue>
694       <Parameters>
695         <Parameter Name="o" Type="System.Object" />
696         <Parameter Name="writer" Type="System.Xml.Serialization.XmlSerializationWriter" />
697       </Parameters>
698       <Docs>
699         <param name="o">To be added: an object of type 'object'</param>
700         <param name="writer">To be added: an object of type 'XmlSerializationWriter'</param>
701         <summary>To be added</summary>
702         <remarks>To be added</remarks>
703       </Docs>
704       <AssemblyInfo>
705         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
706         <AssemblyVersion>2.0.0.0</AssemblyVersion>
707       </AssemblyInfo>
708     </Member>
709     <Member MemberName="Serialize">
710       <MemberSignature Language="C#" Value="public void Serialize (System.Xml.XmlWriter xmlWriter, object o);" />
711       <MemberType>Method</MemberType>
712       <ReturnValue>
713         <ReturnType>System.Void</ReturnType>
714       </ReturnValue>
715       <Parameters>
716         <Parameter Name="xmlWriter" Type="System.Xml.XmlWriter" />
717         <Parameter Name="o" Type="System.Object" />
718       </Parameters>
719       <Docs>
720         <param name="xmlWriter">To be added: an object of type 'System.Xml.XmlWriter'</param>
721         <param name="o">To be added: an object of type 'object'</param>
722         <summary>To be added</summary>
723         <remarks>To be added</remarks>
724       </Docs>
725       <AssemblyInfo>
726         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
727         <AssemblyVersion>2.0.0.0</AssemblyVersion>
728       </AssemblyInfo>
729     </Member>
730     <Member MemberName="Serialize">
731       <MemberSignature Language="C#" Value="public void Serialize (System.IO.Stream stream, object o, System.Xml.Serialization.XmlSerializerNamespaces namespaces);" />
732       <MemberType>Method</MemberType>
733       <ReturnValue>
734         <ReturnType>System.Void</ReturnType>
735       </ReturnValue>
736       <Parameters>
737         <Parameter Name="stream" Type="System.IO.Stream" />
738         <Parameter Name="o" Type="System.Object" />
739         <Parameter Name="namespaces" Type="System.Xml.Serialization.XmlSerializerNamespaces" />
740       </Parameters>
741       <Docs>
742         <param name="stream">To be added: an object of type 'System.IO.Stream'</param>
743         <param name="o">To be added: an object of type 'object'</param>
744         <param name="namespaces">To be added: an object of type 'XmlSerializerNamespaces'</param>
745         <summary>To be added</summary>
746         <remarks>To be added</remarks>
747       </Docs>
748       <AssemblyInfo>
749         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
750         <AssemblyVersion>2.0.0.0</AssemblyVersion>
751       </AssemblyInfo>
752     </Member>
753     <Member MemberName="Serialize">
754       <MemberSignature Language="C#" Value="public void Serialize (System.IO.TextWriter textWriter, object o, System.Xml.Serialization.XmlSerializerNamespaces namespaces);" />
755       <MemberType>Method</MemberType>
756       <ReturnValue>
757         <ReturnType>System.Void</ReturnType>
758       </ReturnValue>
759       <Parameters>
760         <Parameter Name="textWriter" Type="System.IO.TextWriter" />
761         <Parameter Name="o" Type="System.Object" />
762         <Parameter Name="namespaces" Type="System.Xml.Serialization.XmlSerializerNamespaces" />
763       </Parameters>
764       <Docs>
765         <param name="textWriter">To be added: an object of type 'System.IO.TextWriter'</param>
766         <param name="o">To be added: an object of type 'object'</param>
767         <param name="namespaces">To be added: an object of type 'XmlSerializerNamespaces'</param>
768         <summary>To be added</summary>
769         <remarks>To be added</remarks>
770       </Docs>
771       <AssemblyInfo>
772         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
773         <AssemblyVersion>2.0.0.0</AssemblyVersion>
774       </AssemblyInfo>
775     </Member>
776     <Member MemberName="Serialize">
777       <MemberSignature Language="C#" Value="public void Serialize (System.Xml.XmlWriter writer, object o, System.Xml.Serialization.XmlSerializerNamespaces namespaces);" />
778       <MemberType>Method</MemberType>
779       <ReturnValue>
780         <ReturnType>System.Void</ReturnType>
781       </ReturnValue>
782       <Parameters>
783         <Parameter Name="writer" Type="System.Xml.XmlWriter" />
784         <Parameter Name="o" Type="System.Object" />
785         <Parameter Name="namespaces" Type="System.Xml.Serialization.XmlSerializerNamespaces" />
786       </Parameters>
787       <Docs>
788         <param name="writer">To be added.</param>
789         <param name="o">To be added: an object of type 'object'</param>
790         <param name="namespaces">To be added: an object of type 'XmlSerializerNamespaces'</param>
791         <summary>To be added</summary>
792         <remarks>To be added</remarks>
793       </Docs>
794       <AssemblyInfo>
795         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
796         <AssemblyVersion>2.0.0.0</AssemblyVersion>
797       </AssemblyInfo>
798     </Member>
799     <Member MemberName="Serialize">
800       <MemberSignature Language="C#" Value="public void Serialize (System.Xml.XmlWriter xmlWriter, object o, System.Xml.Serialization.XmlSerializerNamespaces namespaces, string encodingStyle);" />
801       <MemberType>Method</MemberType>
802       <ReturnValue>
803         <ReturnType>System.Void</ReturnType>
804       </ReturnValue>
805       <Parameters>
806         <Parameter Name="xmlWriter" Type="System.Xml.XmlWriter" />
807         <Parameter Name="o" Type="System.Object" />
808         <Parameter Name="namespaces" Type="System.Xml.Serialization.XmlSerializerNamespaces" />
809         <Parameter Name="encodingStyle" Type="System.String" />
810       </Parameters>
811       <Docs>
812         <param name="xmlWriter">To be added.</param>
813         <param name="o">To be added.</param>
814         <param name="namespaces">To be added.</param>
815         <param name="encodingStyle">To be added.</param>
816         <summary>To be added.</summary>
817         <remarks>To be added.</remarks>
818         <since version=".NET 2.0" />
819       </Docs>
820       <AssemblyInfo>
821         <AssemblyVersion>2.0.0.0</AssemblyVersion>
822       </AssemblyInfo>
823     </Member>
824     <Member MemberName="Serialize">
825       <MemberSignature Language="C#" Value="public void Serialize (System.Xml.XmlWriter xmlWriter, object o, System.Xml.Serialization.XmlSerializerNamespaces namespaces, string encodingStyle, string id);" />
826       <MemberType>Method</MemberType>
827       <ReturnValue>
828         <ReturnType>System.Void</ReturnType>
829       </ReturnValue>
830       <Parameters>
831         <Parameter Name="xmlWriter" Type="System.Xml.XmlWriter" />
832         <Parameter Name="o" Type="System.Object" />
833         <Parameter Name="namespaces" Type="System.Xml.Serialization.XmlSerializerNamespaces" />
834         <Parameter Name="encodingStyle" Type="System.String" />
835         <Parameter Name="id" Type="System.String" />
836       </Parameters>
837       <Docs>
838         <param name="xmlWriter">To be added.</param>
839         <param name="o">To be added.</param>
840         <param name="namespaces">To be added.</param>
841         <param name="encodingStyle">To be added.</param>
842         <param name="id">To be added.</param>
843         <summary>To be added.</summary>
844         <remarks>To be added.</remarks>
845         <since version=".NET 2.0" />
846       </Docs>
847       <AssemblyInfo>
848         <AssemblyVersion>2.0.0.0</AssemblyVersion>
849       </AssemblyInfo>
850     </Member>
851     <Member MemberName="UnknownAttribute">
852       <MemberSignature Language="C#" Value="public event System.Xml.Serialization.XmlAttributeEventHandler UnknownAttribute;" />
853       <MemberType>Event</MemberType>
854       <ReturnValue>
855         <ReturnType>System.Xml.Serialization.XmlAttributeEventHandler</ReturnType>
856       </ReturnValue>
857       <Parameters />
858       <Docs>
859         <summary>To be added</summary>
860         <remarks>To be added</remarks>
861       </Docs>
862       <AssemblyInfo>
863         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
864         <AssemblyVersion>2.0.0.0</AssemblyVersion>
865       </AssemblyInfo>
866     </Member>
867     <Member MemberName="UnknownElement">
868       <MemberSignature Language="C#" Value="public event System.Xml.Serialization.XmlElementEventHandler UnknownElement;" />
869       <MemberType>Event</MemberType>
870       <ReturnValue>
871         <ReturnType>System.Xml.Serialization.XmlElementEventHandler</ReturnType>
872       </ReturnValue>
873       <Parameters />
874       <Docs>
875         <summary>To be added</summary>
876         <remarks>To be added</remarks>
877       </Docs>
878       <AssemblyInfo>
879         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
880         <AssemblyVersion>2.0.0.0</AssemblyVersion>
881       </AssemblyInfo>
882     </Member>
883     <Member MemberName="UnknownNode">
884       <MemberSignature Language="C#" Value="public event System.Xml.Serialization.XmlNodeEventHandler UnknownNode;" />
885       <MemberType>Event</MemberType>
886       <ReturnValue>
887         <ReturnType>System.Xml.Serialization.XmlNodeEventHandler</ReturnType>
888       </ReturnValue>
889       <Parameters />
890       <Docs>
891         <summary>To be added</summary>
892         <remarks>To be added</remarks>
893       </Docs>
894       <AssemblyInfo>
895         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
896         <AssemblyVersion>2.0.0.0</AssemblyVersion>
897       </AssemblyInfo>
898     </Member>
899     <Member MemberName="UnreferencedObject">
900       <MemberSignature Language="C#" Value="public event System.Xml.Serialization.UnreferencedObjectEventHandler UnreferencedObject;" />
901       <MemberType>Event</MemberType>
902       <ReturnValue>
903         <ReturnType>System.Xml.Serialization.UnreferencedObjectEventHandler</ReturnType>
904       </ReturnValue>
905       <Parameters />
906       <Docs>
907         <summary>To be added</summary>
908         <remarks>To be added</remarks>
909       </Docs>
910       <AssemblyInfo>
911         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
912         <AssemblyVersion>2.0.0.0</AssemblyVersion>
913       </AssemblyInfo>
914     </Member>
915   </Members>
916 </Type>