1 <?xml version="1.0" encoding="utf-8"?>
4 <name>System.Runtime.Serialization.Formatters</name>
7 <member name="T:System.Runtime.Serialization.Formatter">
8 <summary>Provides base functionality for the common language runtime serialization formatters.</summary>
10 <member name="M:System.Runtime.Serialization.Formatter.#ctor">
11 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.Formatter" /> class.</summary>
13 <member name="P:System.Runtime.Serialization.Formatter.Binder">
14 <summary>When overridden in a derived class, gets or sets the <see cref="T:System.Runtime.Serialization.SerializationBinder" /> used with the current formatter.</summary>
15 <returns>The <see cref="T:System.Runtime.Serialization.SerializationBinder" /> used with the current formatter.</returns>
17 <member name="P:System.Runtime.Serialization.Formatter.Context">
18 <summary>When overridden in a derived class, gets or sets the <see cref="T:System.Runtime.Serialization.StreamingContext" /> used for the current serialization.</summary>
19 <returns>The <see cref="T:System.Runtime.Serialization.StreamingContext" /> used for the current serialization.</returns>
21 <member name="M:System.Runtime.Serialization.Formatter.Deserialize(System.IO.Stream)">
22 <summary>When overridden in a derived class, deserializes the stream attached to the formatter when it was created, creating a graph of objects identical to the graph originally serialized into that stream.</summary>
23 <param name="serializationStream">The stream to deserialize.</param>
24 <returns>The top object of the deserialized graph of objects.</returns>
26 <member name="M:System.Runtime.Serialization.Formatter.GetNext(System.Int64@)">
27 <summary>Returns the next object to serialize, from the formatter's internal work queue.</summary>
28 <param name="objID">The ID assigned to the current object during serialization.</param>
29 <returns>The next object to serialize.</returns>
30 <exception cref="T:System.Runtime.Serialization.SerializationException">The next object retrieved from the work queue did not have an assigned ID.</exception>
32 <member name="F:System.Runtime.Serialization.Formatter.m_idGenerator">
33 <summary>Contains the <see cref="T:System.Runtime.Serialization.ObjectIDGenerator" /> used with the current formatter.</summary>
35 <member name="F:System.Runtime.Serialization.Formatter.m_objectQueue">
36 <summary>Contains a <see cref="T:System.Collections.Queue" /> of the objects left to serialize.</summary>
38 <member name="M:System.Runtime.Serialization.Formatter.Schedule(System.Object)">
39 <summary>Schedules an object for later serialization.</summary>
40 <param name="obj">The object to schedule for serialization.</param>
41 <returns>The object ID assigned to the object.</returns>
43 <member name="M:System.Runtime.Serialization.Formatter.Serialize(System.IO.Stream,System.Object)">
44 <summary>When overridden in a derived class, serializes the graph of objects with the specified root to the stream already attached to the formatter.</summary>
45 <param name="serializationStream">The stream to which the objects are serialized.</param>
46 <param name="graph">The object at the root of the graph to serialize.</param>
48 <member name="P:System.Runtime.Serialization.Formatter.SurrogateSelector">
49 <summary>When overridden in a derived class, gets or sets the <see cref="T:System.Runtime.Serialization.ISurrogateSelector" /> used with the current formatter.</summary>
50 <returns>The <see cref="T:System.Runtime.Serialization.ISurrogateSelector" /> used with the current formatter.</returns>
52 <member name="M:System.Runtime.Serialization.Formatter.WriteArray(System.Object,System.String,System.Type)">
53 <summary>When overridden in a derived class, writes an array to the stream already attached to the formatter.</summary>
54 <param name="obj">The array to write.</param>
55 <param name="name">The name of the array.</param>
56 <param name="memberType">The type of elements that the array holds.</param>
58 <member name="M:System.Runtime.Serialization.Formatter.WriteBoolean(System.Boolean,System.String)">
59 <summary>When overridden in a derived class, writes a Boolean value to the stream already attached to the formatter.</summary>
60 <param name="val">The value to write.</param>
61 <param name="name">The name of the member.</param>
63 <member name="M:System.Runtime.Serialization.Formatter.WriteByte(System.Byte,System.String)">
64 <summary>When overridden in a derived class, writes an 8-bit unsigned integer to the stream already attached to the formatter.</summary>
65 <param name="val">The value to write.</param>
66 <param name="name">The name of the member.</param>
68 <member name="M:System.Runtime.Serialization.Formatter.WriteChar(System.Char,System.String)">
69 <summary>When overridden in a derived class, writes a Unicode character to the stream already attached to the formatter.</summary>
70 <param name="val">The value to write.</param>
71 <param name="name">The name of the member.</param>
73 <member name="M:System.Runtime.Serialization.Formatter.WriteDateTime(System.DateTime,System.String)">
74 <summary>When overridden in a derived class, writes a <see cref="T:System.DateTime" /> value to the stream already attached to the formatter.</summary>
75 <param name="val">The value to write.</param>
76 <param name="name">The name of the member.</param>
78 <member name="M:System.Runtime.Serialization.Formatter.WriteDecimal(System.Decimal,System.String)">
79 <summary>When overridden in a derived class, writes a <see cref="T:System.Decimal" /> value to the stream already attached to the formatter.</summary>
80 <param name="val">The value to write.</param>
81 <param name="name">The name of the member.</param>
83 <member name="M:System.Runtime.Serialization.Formatter.WriteDouble(System.Double,System.String)">
84 <summary>When overridden in a derived class, writes a double-precision floating-point number to the stream already attached to the formatter.</summary>
85 <param name="val">The value to write.</param>
86 <param name="name">The name of the member.</param>
88 <member name="M:System.Runtime.Serialization.Formatter.WriteInt16(System.Int16,System.String)">
89 <summary>When overridden in a derived class, writes a 16-bit signed integer to the stream already attached to the formatter.</summary>
90 <param name="val">The value to write.</param>
91 <param name="name">The name of the member.</param>
93 <member name="M:System.Runtime.Serialization.Formatter.WriteInt32(System.Int32,System.String)">
94 <summary>When overridden in a derived class, writes a 32-bit signed integer to the stream.</summary>
95 <param name="val">The value to write.</param>
96 <param name="name">The name of the member.</param>
98 <member name="M:System.Runtime.Serialization.Formatter.WriteInt64(System.Int64,System.String)">
99 <summary>When overridden in a derived class, writes a 64-bit signed integer to the stream.</summary>
100 <param name="val">The value to write.</param>
101 <param name="name">The name of the member.</param>
103 <member name="M:System.Runtime.Serialization.Formatter.WriteMember(System.String,System.Object)">
104 <summary>Inspects the type of data received, and calls the appropriate <see langword="Write" /> method to perform the write to the stream already attached to the formatter.</summary>
105 <param name="memberName">The name of the member to serialize.</param>
106 <param name="data">The object to write to the stream attached to the formatter.</param>
108 <member name="M:System.Runtime.Serialization.Formatter.WriteObjectRef(System.Object,System.String,System.Type)">
109 <summary>When overridden in a derived class, writes an object reference to the stream already attached to the formatter.</summary>
110 <param name="obj">The object reference to write.</param>
111 <param name="name">The name of the member.</param>
112 <param name="memberType">The type of object the reference points to.</param>
114 <member name="M:System.Runtime.Serialization.Formatter.WriteSByte(System.SByte,System.String)">
115 <summary>When overridden in a derived class, writes an 8-bit signed integer to the stream already attached to the formatter.</summary>
116 <param name="val">The value to write.</param>
117 <param name="name">The name of the member.</param>
119 <member name="M:System.Runtime.Serialization.Formatter.WriteSingle(System.Single,System.String)">
120 <summary>When overridden in a derived class, writes a single-precision floating-point number to the stream already attached to the formatter.</summary>
121 <param name="val">The value to write.</param>
122 <param name="name">The name of the member.</param>
124 <member name="M:System.Runtime.Serialization.Formatter.WriteTimeSpan(System.TimeSpan,System.String)">
125 <summary>When overridden in a derived class, writes a <see cref="T:System.TimeSpan" /> value to the stream already attached to the formatter.</summary>
126 <param name="val">The value to write.</param>
127 <param name="name">The name of the member.</param>
129 <member name="M:System.Runtime.Serialization.Formatter.WriteUInt16(System.UInt16,System.String)">
130 <summary>When overridden in a derived class, writes a 16-bit unsigned integer to the stream already attached to the formatter.</summary>
131 <param name="val">The value to write.</param>
132 <param name="name">The name of the member.</param>
134 <member name="M:System.Runtime.Serialization.Formatter.WriteUInt32(System.UInt32,System.String)">
135 <summary>When overridden in a derived class, writes a 32-bit unsigned integer to the stream already attached to the formatter.</summary>
136 <param name="val">The value to write.</param>
137 <param name="name">The name of the member.</param>
139 <member name="M:System.Runtime.Serialization.Formatter.WriteUInt64(System.UInt64,System.String)">
140 <summary>When overridden in a derived class, writes a 64-bit unsigned integer to the stream already attached to the formatter.</summary>
141 <param name="val">The value to write.</param>
142 <param name="name">The name of the member.</param>
144 <member name="M:System.Runtime.Serialization.Formatter.WriteValueType(System.Object,System.String,System.Type)">
145 <summary>When overridden in a derived class, writes a value of the given type to the stream already attached to the formatter.</summary>
146 <param name="obj">The object representing the value type.</param>
147 <param name="name">The name of the member.</param>
148 <param name="memberType">The <see cref="T:System.Type" /> of the value type.</param>
150 <member name="T:System.Runtime.Serialization.FormatterConverter">
151 <summary>Represents a base implementation of the <see cref="T:System.Runtime.Serialization.IFormatterConverter" /> interface that uses the <see cref="T:System.Convert" /> class and the <see cref="T:System.IConvertible" /> interface.</summary>
153 <member name="M:System.Runtime.Serialization.FormatterConverter.#ctor">
154 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.FormatterConverter" /> class.</summary>
156 <member name="M:System.Runtime.Serialization.FormatterConverter.Convert(System.Object,System.Type)">
157 <summary>Converts a value to the given <see cref="T:System.Type" />.</summary>
158 <param name="value">The object to convert.</param>
159 <param name="type">The <see cref="T:System.Type" /> into which <paramref name="value" /> is converted.</param>
160 <returns>The converted <paramref name="value" /> or <see langword="null" /> if the <paramref name="type" /> parameter is <see langword="null" />.</returns>
161 <exception cref="T:System.ArgumentNullException">The <paramref name="value" /> parameter is <see langword="null" />.</exception>
163 <member name="M:System.Runtime.Serialization.FormatterConverter.Convert(System.Object,System.TypeCode)">
164 <summary>Converts a value to the given <see cref="T:System.TypeCode" />.</summary>
165 <param name="value">The object to convert.</param>
166 <param name="typeCode">The <see cref="T:System.TypeCode" /> into which <paramref name="value" /> is converted.</param>
167 <returns>The converted <paramref name="value" />, or <see langword="null" /> if the <paramref name="type" /> parameter is <see langword="null" />.</returns>
168 <exception cref="T:System.ArgumentNullException">The <paramref name="value" /> parameter is <see langword="null" />.</exception>
170 <member name="M:System.Runtime.Serialization.FormatterConverter.ToBoolean(System.Object)">
171 <summary>Converts a value to a <see cref="T:System.Boolean" />.</summary>
172 <param name="value">The object to convert.</param>
173 <returns>The converted <paramref name="value" /> or <see langword="null" /> if the <paramref name="type" /> parameter is <see langword="null" />.</returns>
174 <exception cref="T:System.ArgumentNullException">The <paramref name="value" /> parameter is <see langword="null" />.</exception>
176 <member name="M:System.Runtime.Serialization.FormatterConverter.ToByte(System.Object)">
177 <summary>Converts a value to an 8-bit unsigned integer.</summary>
178 <param name="value">The object to convert.</param>
179 <returns>The converted <paramref name="value" /> or <see langword="null" /> if the <paramref name="type" /> parameter is <see langword="null" />.</returns>
180 <exception cref="T:System.ArgumentNullException">The <paramref name="value" /> parameter is <see langword="null" />.</exception>
182 <member name="M:System.Runtime.Serialization.FormatterConverter.ToChar(System.Object)">
183 <summary>Converts a value to a Unicode character.</summary>
184 <param name="value">The object to convert.</param>
185 <returns>The converted <paramref name="value" /> or <see langword="null" /> if the <paramref name="type" /> parameter is <see langword="null" />.</returns>
186 <exception cref="T:System.ArgumentNullException">The <paramref name="value" /> parameter is <see langword="null" />.</exception>
188 <member name="M:System.Runtime.Serialization.FormatterConverter.ToDateTime(System.Object)">
189 <summary>Converts a value to a <see cref="T:System.DateTime" />.</summary>
190 <param name="value">The object to convert.</param>
191 <returns>The converted <paramref name="value" /> or <see langword="null" /> if the <paramref name="type" /> parameter is <see langword="null" />.</returns>
192 <exception cref="T:System.ArgumentNullException">The <paramref name="value" /> parameter is <see langword="null" />.</exception>
194 <member name="M:System.Runtime.Serialization.FormatterConverter.ToDecimal(System.Object)">
195 <summary>Converts a value to a <see cref="T:System.Decimal" />.</summary>
196 <param name="value">The object to convert.</param>
197 <returns>The converted <paramref name="value" /> or <see langword="null" /> if the <paramref name="type" /> parameter is <see langword="null" />.</returns>
198 <exception cref="T:System.ArgumentNullException">The <paramref name="value" /> parameter is <see langword="null" />.</exception>
200 <member name="M:System.Runtime.Serialization.FormatterConverter.ToDouble(System.Object)">
201 <summary>Converts a value to a double-precision floating-point number.</summary>
202 <param name="value">The object to convert.</param>
203 <returns>The converted <paramref name="value" /> or <see langword="null" /> if the <paramref name="type" /> parameter is <see langword="null" />.</returns>
204 <exception cref="T:System.ArgumentNullException">The <paramref name="value" /> parameter is <see langword="null" />.</exception>
206 <member name="M:System.Runtime.Serialization.FormatterConverter.ToInt16(System.Object)">
207 <summary>Converts a value to a 16-bit signed integer.</summary>
208 <param name="value">The object to convert.</param>
209 <returns>The converted <paramref name="value" /> or <see langword="null" /> if the <paramref name="type" /> parameter is <see langword="null" />.</returns>
210 <exception cref="T:System.ArgumentNullException">The <paramref name="value" /> parameter is <see langword="null" />.</exception>
212 <member name="M:System.Runtime.Serialization.FormatterConverter.ToInt32(System.Object)">
213 <summary>Converts a value to a 32-bit signed integer.</summary>
214 <param name="value">The object to convert.</param>
215 <returns>The converted <paramref name="value" /> or <see langword="null" /> if the <paramref name="type" /> parameter is <see langword="null" />.</returns>
216 <exception cref="T:System.ArgumentNullException">The <paramref name="value" /> parameter is <see langword="null" />.</exception>
218 <member name="M:System.Runtime.Serialization.FormatterConverter.ToInt64(System.Object)">
219 <summary>Converts a value to a 64-bit signed integer.</summary>
220 <param name="value">The object to convert.</param>
221 <returns>The converted <paramref name="value" /> or <see langword="null" /> if the <paramref name="type" /> parameter is <see langword="null" />.</returns>
222 <exception cref="T:System.ArgumentNullException">The <paramref name="value" /> parameter is <see langword="null" />.</exception>
224 <member name="M:System.Runtime.Serialization.FormatterConverter.ToSByte(System.Object)">
225 <summary>Converts a value to a <see cref="T:System.SByte" />.</summary>
226 <param name="value">The object to convert.</param>
227 <returns>The converted <paramref name="value" /> or <see langword="null" /> if the <paramref name="type" /> parameter is <see langword="null" />.</returns>
228 <exception cref="T:System.ArgumentNullException">The <paramref name="value" /> parameter is <see langword="null" />.</exception>
230 <member name="M:System.Runtime.Serialization.FormatterConverter.ToSingle(System.Object)">
231 <summary>Converts a value to a single-precision floating-point number.</summary>
232 <param name="value">The object to convert.</param>
233 <returns>The converted <paramref name="value" /> or <see langword="null" /> if the <paramref name="type" /> parameter is <see langword="null" />.</returns>
234 <exception cref="T:System.ArgumentNullException">The <paramref name="value" /> parameter is <see langword="null" />.</exception>
236 <member name="M:System.Runtime.Serialization.FormatterConverter.ToString(System.Object)">
237 <summary>Converts the specified object to a <see cref="T:System.String" />.</summary>
238 <param name="value">The object to convert.</param>
239 <returns>The converted <paramref name="value" /> or <see langword="null" /> if the <paramref name="type" /> parameter is <see langword="null" />.</returns>
240 <exception cref="T:System.ArgumentNullException">The <paramref name="value" /> parameter is <see langword="null" />.</exception>
242 <member name="M:System.Runtime.Serialization.FormatterConverter.ToUInt16(System.Object)">
243 <summary>Converts a value to a 16-bit unsigned integer.</summary>
244 <param name="value">The object to convert.</param>
245 <returns>The converted <paramref name="value" /> or <see langword="null" /> if the <paramref name="type" /> parameter is <see langword="null" />.</returns>
246 <exception cref="T:System.ArgumentNullException">The <paramref name="value" /> parameter is <see langword="null" />.</exception>
248 <member name="M:System.Runtime.Serialization.FormatterConverter.ToUInt32(System.Object)">
249 <summary>Converts a value to a 32-bit unsigned integer.</summary>
250 <param name="value">The object to convert.</param>
251 <returns>The converted <paramref name="value" /> or <see langword="null" /> if the <paramref name="type" /> parameter is <see langword="null" />.</returns>
252 <exception cref="T:System.ArgumentNullException">The <paramref name="value" /> parameter is <see langword="null" />.</exception>
254 <member name="M:System.Runtime.Serialization.FormatterConverter.ToUInt64(System.Object)">
255 <summary>Converts a value to a 64-bit unsigned integer.</summary>
256 <param name="value">The object to convert.</param>
257 <returns>The converted <paramref name="value" /> or <see langword="null" /> if the <paramref name="type" /> parameter is <see langword="null" />.</returns>
258 <exception cref="T:System.ArgumentNullException">The <paramref name="value" /> parameter is <see langword="null" />.</exception>
260 <member name="T:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter">
261 <summary>Serializes and deserializes an object, or an entire graph of connected objects, in binary format.</summary>
263 <member name="M:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.#ctor">
264 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter" /> class with default values.</summary>
266 <member name="M:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.#ctor(System.Runtime.Serialization.ISurrogateSelector,System.Runtime.Serialization.StreamingContext)">
267 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter" /> class with a given surrogate selector and streaming context.</summary>
268 <param name="selector">The <see cref="T:System.Runtime.Serialization.ISurrogateSelector" /> to use. Can be <see langword="null" />.</param>
269 <param name="context">The source and destination for the serialized data.</param>
271 <member name="P:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.AssemblyFormat">
272 <summary>Gets or sets the behavior of the deserializer with regards to finding and loading assemblies.</summary>
273 <returns>One of the <see cref="T:System.Runtime.Serialization.Formatters.FormatterAssemblyStyle" /> values that specifies the deserializer behavior.</returns>
275 <member name="P:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.Binder">
276 <summary>Gets or sets an object of type <see cref="T:System.Runtime.Serialization.SerializationBinder" /> that controls the binding of a serialized object to a type.</summary>
277 <returns>The serialization binder to use with this formatter.</returns>
279 <member name="P:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.Context">
280 <summary>Gets or sets the <see cref="T:System.Runtime.Serialization.StreamingContext" /> for this formatter.</summary>
281 <returns>The streaming context to use with this formatter.</returns>
283 <member name="M:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.Deserialize(System.IO.Stream)">
284 <summary>Deserializes the specified stream into an object graph.</summary>
285 <param name="serializationStream">The stream from which to deserialize the object graph.</param>
286 <returns>The top (root) of the object graph.</returns>
287 <exception cref="T:System.ArgumentNullException">The <paramref name="serializationStream" /> is <see langword="null" />.</exception>
288 <exception cref="T:System.Runtime.Serialization.SerializationException">The <paramref name="serializationStream" /> supports seeking, but its length is 0.
290 The target type is a <see cref="T:System.Decimal" />, but the value is out of range of the <see cref="T:System.Decimal" /> type.</exception>
291 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
293 <member name="P:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.FilterLevel">
294 <summary>Gets or sets the <see cref="T:System.Runtime.Serialization.Formatters.TypeFilterLevel" /> of automatic deserialization the <see cref="T:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter" /> performs.</summary>
295 <returns>The <see cref="T:System.Runtime.Serialization.Formatters.TypeFilterLevel" /> that represents the current automatic deserialization level.</returns>
297 <member name="M:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.Serialize(System.IO.Stream,System.Object)">
298 <summary>Serializes the object, or graph of objects with the specified top (root), to the given stream.</summary>
299 <param name="serializationStream">The stream to which the graph is to be serialized.</param>
300 <param name="graph">The object at the root of the graph to serialize.</param>
301 <exception cref="T:System.ArgumentNullException">The <paramref name="serializationStream" /> is <see langword="null" />.
303 The <paramref name="graph" /> is null.</exception>
304 <exception cref="T:System.Runtime.Serialization.SerializationException">An error has occurred during serialization, such as if an object in the <paramref name="graph" /> parameter is not marked as serializable.</exception>
305 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
307 <member name="P:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.SurrogateSelector">
308 <summary>Gets or sets a <see cref="T:System.Runtime.Serialization.ISurrogateSelector" /> that controls type substitution during serialization and deserialization.</summary>
309 <returns>The surrogate selector to use with this formatter.</returns>
311 <member name="P:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.TypeFormat">
312 <summary>Gets or sets the format in which type descriptions are laid out in the serialized stream.</summary>
313 <returns>The style of type layouts to use.</returns>
315 <member name="T:System.Runtime.Serialization.Formatters.FormatterAssemblyStyle">
316 <summary>Indicates the method that will be used during deserialization for locating and loading assemblies.</summary>
318 <member name="F:System.Runtime.Serialization.Formatters.FormatterAssemblyStyle.Full">
319 <summary>In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The <see cref="Overload:System.Reflection.Assembly.Load" /> method of the <see cref="T:System.Reflection.Assembly" /> class is used to load the assembly.</summary>
321 <member name="F:System.Runtime.Serialization.Formatters.FormatterAssemblyStyle.Simple">
322 <summary>In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the <see cref="Overload:System.Reflection.Assembly.LoadWithPartialName" /> method is used to load the assembly.</summary>
324 <member name="T:System.Runtime.Serialization.Formatters.FormatterTypeStyle">
325 <summary>Indicates the format in which type descriptions are laid out in the serialized stream.</summary>
327 <member name="F:System.Runtime.Serialization.Formatters.FormatterTypeStyle.TypesAlways">
328 <summary>Indicates that types can be given to all object members and <see cref="T:System.Runtime.Serialization.ISerializable" /> object members.</summary>
330 <member name="F:System.Runtime.Serialization.Formatters.FormatterTypeStyle.TypesWhenNeeded">
331 <summary>Indicates that types can be stated only for arrays of objects, object members of type <see cref="T:System.Object" />, and <see cref="T:System.Runtime.Serialization.ISerializable" /> non-primitive value types.</summary>
333 <member name="F:System.Runtime.Serialization.Formatters.FormatterTypeStyle.XsdString">
334 <summary>Indicates that strings can be given in the XSD format rather than SOAP. No string IDs are transmitted.</summary>
336 <member name="T:System.Runtime.Serialization.Formatters.IFieldInfo">
337 <summary>Allows access to field names and field types of objects that support the <see cref="T:System.Runtime.Serialization.ISerializable" /> interface.</summary>
339 <member name="P:System.Runtime.Serialization.Formatters.IFieldInfo.FieldNames">
340 <summary>Gets or sets the field names of serialized objects.</summary>
341 <returns>The field names of serialized objects.</returns>
342 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
344 <member name="P:System.Runtime.Serialization.Formatters.IFieldInfo.FieldTypes">
345 <summary>Gets or sets the field types of the serialized objects.</summary>
346 <returns>The field types of the serialized objects.</returns>
347 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
349 <member name="T:System.Runtime.Serialization.Formatters.TypeFilterLevel">
350 <summary>Specifies the level of automatic deserialization for .NET Framework remoting.</summary>
352 <member name="F:System.Runtime.Serialization.Formatters.TypeFilterLevel.Full">
353 <summary>The full deserialization level for .NET Framework remoting. It supports all types that remoting supports in all situations.</summary>
355 <member name="F:System.Runtime.Serialization.Formatters.TypeFilterLevel.Low">
356 <summary>The low deserialization level for .NET Framework remoting. It supports types associated with basic remoting functionality.</summary>
358 <member name="T:System.Runtime.Serialization.FormatterServices">
359 <summary>Provides static methods to aid with the implementation of a <see cref="T:System.Runtime.Serialization.Formatter" /> for serialization. This class cannot be inherited.</summary>
361 <member name="M:System.Runtime.Serialization.FormatterServices.CheckTypeSecurity(System.Type,System.Runtime.Serialization.Formatters.TypeFilterLevel)">
362 <summary>Determines whether the specified <see cref="T:System.Type" /> can be deserialized with the <see cref="T:System.Runtime.Serialization.Formatters.TypeFilterLevel" /> property set to <see langword="Low" />.</summary>
363 <param name="t">The <see cref="T:System.Type" /> to check for the ability to deserialize.</param>
364 <param name="securityLevel">The <see cref="T:System.Runtime.Serialization.Formatters.TypeFilterLevel" /> property value.</param>
365 <exception cref="T:System.Security.SecurityException">The <paramref name="t" /> parameter is an advanced type and cannot be deserialized when the <see cref="T:System.Runtime.Serialization.Formatters.TypeFilterLevel" /> property is set to <see langword="Low" />.</exception>
367 <member name="M:System.Runtime.Serialization.FormatterServices.GetObjectData(System.Object,System.Reflection.MemberInfo[])">
368 <summary>Extracts the data from the specified object and returns it as an array of objects.</summary>
369 <param name="obj">The object to write to the formatter.</param>
370 <param name="members">The members to extract from the object.</param>
371 <returns>An array of <see cref="T:System.Object" /> that contains data stored in <paramref name="members" /> and associated with <paramref name="obj" />.</returns>
372 <exception cref="T:System.ArgumentNullException">The <paramref name="obj" /> or <paramref name="members" /> parameter is <see langword="null" />.
373 An element of <paramref name="members" /> is <see langword="null" />.</exception>
374 <exception cref="T:System.Runtime.Serialization.SerializationException">An element of <paramref name="members" /> does not represent a field.</exception>
376 <member name="M:System.Runtime.Serialization.FormatterServices.GetSafeUninitializedObject(System.Type)">
377 <summary>Creates a new instance of the specified object type.</summary>
378 <param name="type">The type of object to create.</param>
379 <returns>A zeroed object of the specified type.</returns>
380 <exception cref="T:System.ArgumentNullException">The <paramref name="type" /> parameter is <see langword="null" />.</exception>
381 <exception cref="T:System.Runtime.Serialization.SerializationException">The <paramref name="type" /> parameter is not a valid common language runtime type.</exception>
382 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
384 <member name="M:System.Runtime.Serialization.FormatterServices.GetSerializableMembers(System.Type)">
385 <summary>Gets all the serializable members for a class of the specified <see cref="T:System.Type" />.</summary>
386 <param name="type">The type being serialized.</param>
387 <returns>An array of type <see cref="T:System.Reflection.MemberInfo" /> of the non-transient, non-static members.</returns>
388 <exception cref="T:System.ArgumentNullException">The <paramref name="type" /> parameter is <see langword="null" />.</exception>
389 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
391 <member name="M:System.Runtime.Serialization.FormatterServices.GetSerializableMembers(System.Type,System.Runtime.Serialization.StreamingContext)">
392 <summary>Gets all the serializable members for a class of the specified <see cref="T:System.Type" /> and in the provided <see cref="T:System.Runtime.Serialization.StreamingContext" />.</summary>
393 <param name="type">The type being serialized or cloned.</param>
394 <param name="context">The context where the serialization occurs.</param>
395 <returns>An array of type <see cref="T:System.Reflection.MemberInfo" /> of the non-transient, non-static members.</returns>
396 <exception cref="T:System.ArgumentNullException">The <paramref name="type" /> parameter is <see langword="null" />.</exception>
397 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
399 <member name="M:System.Runtime.Serialization.FormatterServices.GetSurrogateForCyclicalReference(System.Runtime.Serialization.ISerializationSurrogate)">
400 <summary>Returns a serialization surrogate for the specified <see cref="T:System.Runtime.Serialization.ISerializationSurrogate" />.</summary>
401 <param name="innerSurrogate">The specified surrogate.</param>
402 <returns>An <see cref="T:System.Runtime.Serialization.ISerializationSurrogate" /> for the specified <paramref name="innerSurrogate" />.</returns>
404 <member name="M:System.Runtime.Serialization.FormatterServices.GetTypeFromAssembly(System.Reflection.Assembly,System.String)">
405 <summary>Looks up the <see cref="T:System.Type" /> of the specified object in the provided <see cref="T:System.Reflection.Assembly" />.</summary>
406 <param name="assem">The assembly where you want to look up the object.</param>
407 <param name="name">The name of the object.</param>
408 <returns>The <see cref="T:System.Type" /> of the named object.</returns>
409 <exception cref="T:System.ArgumentNullException">The <paramref name="assem" /> parameter is <see langword="null" />.</exception>
410 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
412 <member name="M:System.Runtime.Serialization.FormatterServices.GetUninitializedObject(System.Type)">
413 <summary>Creates a new instance of the specified object type.</summary>
414 <param name="type">The type of object to create.</param>
415 <returns>A zeroed object of the specified type.</returns>
416 <exception cref="T:System.ArgumentNullException">The <paramref name="type" /> parameter is <see langword="null" />.</exception>
417 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
419 <member name="M:System.Runtime.Serialization.FormatterServices.PopulateObjectMembers(System.Object,System.Reflection.MemberInfo[],System.Object[])">
420 <summary>Populates the specified object with values for each field drawn from the data array of objects.</summary>
421 <param name="obj">The object to populate.</param>
422 <param name="members">An array of <see cref="T:System.Reflection.MemberInfo" /> that describes which fields and properties to populate.</param>
423 <param name="data">An array of <see cref="T:System.Object" /> that specifies the values for each field and property to populate.</param>
424 <returns>The newly populated object.</returns>
425 <exception cref="T:System.ArgumentNullException">The <paramref name="obj" />, <paramref name="members" />, or <paramref name="data" /> parameter is <see langword="null" />.
426 An element of <paramref name="members" /> is <see langword="null" />.</exception>
427 <exception cref="T:System.ArgumentException">The length of <paramref name="members" /> does not match the length of <paramref name="data" />.</exception>
428 <exception cref="T:System.Runtime.Serialization.SerializationException">An element of <paramref name="members" /> is not an instance of <see cref="T:System.Reflection.FieldInfo" />.</exception>
429 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
431 <member name="T:System.Runtime.Serialization.IFormatter">
432 <summary>Provides functionality for formatting serialized objects.</summary>
434 <member name="P:System.Runtime.Serialization.IFormatter.Binder">
435 <summary>Gets or sets the <see cref="T:System.Runtime.Serialization.SerializationBinder" /> that performs type lookups during deserialization.</summary>
436 <returns>The <see cref="T:System.Runtime.Serialization.SerializationBinder" /> that performs type lookups during deserialization.</returns>
438 <member name="P:System.Runtime.Serialization.IFormatter.Context">
439 <summary>Gets or sets the <see cref="T:System.Runtime.Serialization.StreamingContext" /> used for serialization and deserialization.</summary>
440 <returns>The <see cref="T:System.Runtime.Serialization.StreamingContext" /> used for serialization and deserialization.</returns>
442 <member name="M:System.Runtime.Serialization.IFormatter.Deserialize(System.IO.Stream)">
443 <summary>Deserializes the data on the provided stream and reconstitutes the graph of objects.</summary>
444 <param name="serializationStream">The stream that contains the data to deserialize.</param>
445 <returns>The top object of the deserialized graph.</returns>
447 <member name="M:System.Runtime.Serialization.IFormatter.Serialize(System.IO.Stream,System.Object)">
448 <summary>Serializes an object, or graph of objects with the given root to the provided stream.</summary>
449 <param name="serializationStream">The stream where the formatter puts the serialized data. This stream can reference a variety of backing stores (such as files, network, memory, and so on).</param>
450 <param name="graph">The object, or root of the object graph, to serialize. All child objects of this root object are automatically serialized.</param>
452 <member name="P:System.Runtime.Serialization.IFormatter.SurrogateSelector">
453 <summary>Gets or sets the <see cref="T:System.Runtime.Serialization.SurrogateSelector" /> used by the current formatter.</summary>
454 <returns>The <see cref="T:System.Runtime.Serialization.SurrogateSelector" /> used by this formatter.</returns>
456 <member name="T:System.Runtime.Serialization.ISerializationSurrogate">
457 <summary>Implements a serialization surrogate selector that allows one object to perform serialization and deserialization of another.</summary>
459 <member name="M:System.Runtime.Serialization.ISerializationSurrogate.GetObjectData(System.Object,System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
460 <summary>Populates the provided <see cref="T:System.Runtime.Serialization.SerializationInfo" /> with the data needed to serialize the object.</summary>
461 <param name="obj">The object to serialize.</param>
462 <param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo" /> to populate with data.</param>
463 <param name="context">The destination (see <see cref="T:System.Runtime.Serialization.StreamingContext" />) for this serialization.</param>
464 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
466 <member name="M:System.Runtime.Serialization.ISerializationSurrogate.SetObjectData(System.Object,System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext,System.Runtime.Serialization.ISurrogateSelector)">
467 <summary>Populates the object using the information in the <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</summary>
468 <param name="obj">The object to populate.</param>
469 <param name="info">The information to populate the object.</param>
470 <param name="context">The source from which the object is deserialized.</param>
471 <param name="selector">The surrogate selector where the search for a compatible surrogate begins.</param>
472 <returns>The populated deserialized object.</returns>
473 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
475 <member name="T:System.Runtime.Serialization.ISurrogateSelector">
476 <summary>Indicates a serialization surrogate selector class.</summary>
478 <member name="M:System.Runtime.Serialization.ISurrogateSelector.ChainSelector(System.Runtime.Serialization.ISurrogateSelector)">
479 <summary>Specifies the next <see cref="T:System.Runtime.Serialization.ISurrogateSelector" /> for surrogates to examine if the current instance does not have a surrogate for the specified type and assembly in the specified context.</summary>
480 <param name="selector">The next surrogate selector to examine.</param>
481 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
483 <member name="M:System.Runtime.Serialization.ISurrogateSelector.GetNextSelector">
484 <summary>Returns the next surrogate selector in the chain.</summary>
485 <returns>The next surrogate selector in the chain or <see langword="null" />.</returns>
486 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
488 <member name="M:System.Runtime.Serialization.ISurrogateSelector.GetSurrogate(System.Type,System.Runtime.Serialization.StreamingContext,System.Runtime.Serialization.ISurrogateSelector@)">
489 <summary>Finds the surrogate that represents the specified object's type, starting with the specified surrogate selector for the specified serialization context.</summary>
490 <param name="type">The <see cref="T:System.Type" /> of object (class) that needs a surrogate.</param>
491 <param name="context">The source or destination context for the current serialization.</param>
492 <param name="selector">When this method returns, contains a <see cref="T:System.Runtime.Serialization.ISurrogateSelector" /> that holds a reference to the surrogate selector where the appropriate surrogate was found. This parameter is passed uninitialized.</param>
493 <returns>The appropriate surrogate for the given type in the given context.</returns>
494 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
496 <member name="T:System.Runtime.Serialization.ObjectIDGenerator">
497 <summary>Generates IDs for objects.</summary>
499 <member name="M:System.Runtime.Serialization.ObjectIDGenerator.#ctor">
500 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.ObjectIDGenerator" /> class.</summary>
502 <member name="M:System.Runtime.Serialization.ObjectIDGenerator.GetId(System.Object,System.Boolean@)">
503 <summary>Returns the ID for the specified object, generating a new ID if the specified object has not already been identified by the <see cref="T:System.Runtime.Serialization.ObjectIDGenerator" />.</summary>
504 <param name="obj">The object you want an ID for.</param>
505 <param name="firstTime">
506 <see langword="true" /> if <paramref name="obj" /> was not previously known to the <see cref="T:System.Runtime.Serialization.ObjectIDGenerator" />; otherwise, <see langword="false" />.</param>
507 <returns>The object's ID is used for serialization. <paramref name="firstTime" /> is set to <see langword="true" /> if this is the first time the object has been identified; otherwise, it is set to <see langword="false" />.</returns>
508 <exception cref="T:System.ArgumentNullException">The <paramref name="obj" /> parameter is <see langword="null" />.</exception>
509 <exception cref="T:System.Runtime.Serialization.SerializationException">The <see cref="T:System.Runtime.Serialization.ObjectIDGenerator" /> has been asked to keep track of too many objects.</exception>
511 <member name="M:System.Runtime.Serialization.ObjectIDGenerator.HasId(System.Object,System.Boolean@)">
512 <summary>Determines whether an object has already been assigned an ID.</summary>
513 <param name="obj">The object you are asking for.</param>
514 <param name="firstTime">
515 <see langword="true" /> if <paramref name="obj" /> was not previously known to the <see cref="T:System.Runtime.Serialization.ObjectIDGenerator" />; otherwise, <see langword="false" />.</param>
516 <returns>The object ID of <paramref name="obj" /> if previously known to the <see cref="T:System.Runtime.Serialization.ObjectIDGenerator" />; otherwise, zero.</returns>
517 <exception cref="T:System.ArgumentNullException">The <paramref name="obj" /> parameter is <see langword="null" />.</exception>
519 <member name="T:System.Runtime.Serialization.ObjectManager">
520 <summary>Keeps track of objects as they are deserialized.</summary>
522 <member name="M:System.Runtime.Serialization.ObjectManager.#ctor(System.Runtime.Serialization.ISurrogateSelector,System.Runtime.Serialization.StreamingContext)">
523 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.ObjectManager" /> class.</summary>
524 <param name="selector">The surrogate selector to use. The <see cref="T:System.Runtime.Serialization.ISurrogateSelector" /> determines the correct surrogate to use when deserializing objects of a given type. At deserialization time, the surrogate selector creates a new instance of the object from the information transmitted on the stream.</param>
525 <param name="context">The streaming context. The <see cref="T:System.Runtime.Serialization.StreamingContext" /> is not used by <see langword="ObjectManager" />, but is passed as a parameter to any objects implementing <see cref="T:System.Runtime.Serialization.ISerializable" /> or having a <see cref="T:System.Runtime.Serialization.ISerializationSurrogate" />. These objects can take specific actions depending on the source of the information to deserialize.</param>
526 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
528 <member name="M:System.Runtime.Serialization.ObjectManager.DoFixups">
529 <summary>Performs all the recorded fixups.</summary>
530 <exception cref="T:System.Runtime.Serialization.SerializationException">A fixup was not successfully completed.</exception>
532 <member name="M:System.Runtime.Serialization.ObjectManager.GetObject(System.Int64)">
533 <summary>Returns the object with the specified object ID.</summary>
534 <param name="objectID">The ID of the requested object.</param>
535 <returns>The object with the specified object ID if it has been previously stored or <see langword="null" /> if no such object has been registered.</returns>
536 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="objectID" /> parameter is less than or equal to zero.</exception>
538 <member name="M:System.Runtime.Serialization.ObjectManager.RaiseDeserializationEvent">
539 <summary>Raises the deserialization event to any registered object that implements <see cref="T:System.Runtime.Serialization.IDeserializationCallback" />.</summary>
541 <member name="M:System.Runtime.Serialization.ObjectManager.RaiseOnDeserializingEvent(System.Object)">
542 <summary>Invokes the method marked with the <see cref="T:System.Runtime.Serialization.OnDeserializingAttribute" />.</summary>
543 <param name="obj">The instance of the type that contains the method to be invoked.</param>
545 <member name="M:System.Runtime.Serialization.ObjectManager.RecordArrayElementFixup(System.Int64,System.Int32,System.Int64)">
546 <summary>Records a fixup for one element in an array.</summary>
547 <param name="arrayToBeFixed">The ID of the array used to record a fixup.</param>
548 <param name="index">The index within <c>arrayFixup</c> that a fixup is requested for.</param>
549 <param name="objectRequired">The ID of the object that the current array element will point to after fixup is completed.</param>
550 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="arrayToBeFixed" /> or <paramref name="objectRequired" /> parameter is less than or equal to zero.</exception>
551 <exception cref="T:System.ArgumentNullException">The <paramref name="index" /> parameter is <see langword="null" />.</exception>
553 <member name="M:System.Runtime.Serialization.ObjectManager.RecordArrayElementFixup(System.Int64,System.Int32[],System.Int64)">
554 <summary>Records fixups for the specified elements in an array, to be executed later.</summary>
555 <param name="arrayToBeFixed">The ID of the array used to record a fixup.</param>
556 <param name="indices">The indexes within the multidimensional array that a fixup is requested for.</param>
557 <param name="objectRequired">The ID of the object the array elements will point to after fixup is completed.</param>
558 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="arrayToBeFixed" /> or <paramref name="objectRequired" /> parameter is less than or equal to zero.</exception>
559 <exception cref="T:System.ArgumentNullException">The <paramref name="indices" /> parameter is <see langword="null" />.</exception>
561 <member name="M:System.Runtime.Serialization.ObjectManager.RecordDelayedFixup(System.Int64,System.String,System.Int64)">
562 <summary>Records a fixup for an object member, to be executed later.</summary>
563 <param name="objectToBeFixed">The ID of the object that needs the reference to <paramref name="objectRequired" />.</param>
564 <param name="memberName">The member name of <paramref name="objectToBeFixed" /> where the fixup will be performed.</param>
565 <param name="objectRequired">The ID of the object required by <paramref name="objectToBeFixed" />.</param>
566 <exception cref="T:System.ArgumentOutOfRangeException">
567 <paramref name="objectToBeFixed" /> or <paramref name="objectRequired" /> parameter is less than or equal to zero.</exception>
568 <exception cref="T:System.ArgumentNullException">The <paramref name="memberName" /> parameter is <see langword="null" />.</exception>
570 <member name="M:System.Runtime.Serialization.ObjectManager.RecordFixup(System.Int64,System.Reflection.MemberInfo,System.Int64)">
571 <summary>Records a fixup for a member of an object, to be executed later.</summary>
572 <param name="objectToBeFixed">The ID of the object that needs the reference to the <paramref name="objectRequired" /> object.</param>
573 <param name="member">The member of <paramref name="objectToBeFixed" /> where the fixup will be performed.</param>
574 <param name="objectRequired">The ID of the object required by <paramref name="objectToBeFixed" />.</param>
575 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="objectToBeFixed" /> or <paramref name="objectRequired" /> parameter is less than or equal to zero.</exception>
576 <exception cref="T:System.ArgumentNullException">The <paramref name="member" /> parameter is <see langword="null" />.</exception>
578 <member name="M:System.Runtime.Serialization.ObjectManager.RegisterObject(System.Object,System.Int64)">
579 <summary>Registers an object as it is deserialized, associating it with <paramref name="objectID" />.</summary>
580 <param name="obj">The object to register.</param>
581 <param name="objectID">The ID of the object to register.</param>
582 <exception cref="T:System.ArgumentNullException">The <paramref name="obj" /> parameter is <see langword="null" />.</exception>
583 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="objectID" /> parameter is less than or equal to zero.</exception>
584 <exception cref="T:System.Runtime.Serialization.SerializationException">The <paramref name="objectID" /> has already been registered for an object other than <paramref name="obj" />.</exception>
586 <member name="M:System.Runtime.Serialization.ObjectManager.RegisterObject(System.Object,System.Int64,System.Runtime.Serialization.SerializationInfo)">
587 <summary>Registers an object as it is deserialized, associating it with <paramref name="objectID" />, and recording the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> used with it.</summary>
588 <param name="obj">The object to register.</param>
589 <param name="objectID">The ID of the object to register.</param>
590 <param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo" /> used if <paramref name="obj" /> implements <see cref="T:System.Runtime.Serialization.ISerializable" /> or has a <see cref="T:System.Runtime.Serialization.ISerializationSurrogate" />. <paramref name="info" /> will be completed with any required fixup information and then passed to the required object when that object is completed.</param>
591 <exception cref="T:System.ArgumentNullException">The <paramref name="obj" /> parameter is <see langword="null" />.</exception>
592 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="objectID" /> parameter is less than or equal to zero.</exception>
593 <exception cref="T:System.Runtime.Serialization.SerializationException">The <paramref name="objectID" /> has already been registered for an object other than <paramref name="obj" />.</exception>
595 <member name="M:System.Runtime.Serialization.ObjectManager.RegisterObject(System.Object,System.Int64,System.Runtime.Serialization.SerializationInfo,System.Int64,System.Reflection.MemberInfo)">
596 <summary>Registers a member of an object as it is deserialized, associating it with <paramref name="objectID" />, and recording the <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</summary>
597 <param name="obj">The object to register.</param>
598 <param name="objectID">The ID of the object to register.</param>
599 <param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo" /> used if <paramref name="obj" /> implements <see cref="T:System.Runtime.Serialization.ISerializable" /> or has a <see cref="T:System.Runtime.Serialization.ISerializationSurrogate" />. <paramref name="info" /> will be completed with any required fixup information and then passed to the required object when that object is completed.</param>
600 <param name="idOfContainingObj">The ID of the object that contains <paramref name="obj" />. This parameter is required only if <paramref name="obj" /> is a value type.</param>
601 <param name="member">The field in the containing object where <paramref name="obj" /> exists. This parameter has meaning only if <paramref name="obj" /> is a value type.</param>
602 <exception cref="T:System.ArgumentNullException">The <paramref name="obj" /> parameter is <see langword="null" />.</exception>
603 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="objectID" /> parameter is less than or equal to zero.</exception>
604 <exception cref="T:System.Runtime.Serialization.SerializationException">The <paramref name="objectID" /> has already been registered for an object other than <paramref name="obj" />, or <paramref name="member" /> is not a <see cref="T:System.Reflection.FieldInfo" /> and <paramref name="member" /> is not <see langword="null" />.</exception>
606 <member name="M:System.Runtime.Serialization.ObjectManager.RegisterObject(System.Object,System.Int64,System.Runtime.Serialization.SerializationInfo,System.Int64,System.Reflection.MemberInfo,System.Int32[])">
607 <summary>Registers a member of an array contained in an object while it is deserialized, associating it with <paramref name="objectID" />, and recording the <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</summary>
608 <param name="obj">The object to register.</param>
609 <param name="objectID">The ID of the object to register.</param>
610 <param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo" /> used if <paramref name="obj" /> implements <see cref="T:System.Runtime.Serialization.ISerializable" /> or has a <see cref="T:System.Runtime.Serialization.ISerializationSurrogate" />. <paramref name="info" /> will be completed with any required fixup information and then passed to the required object when that object is completed.</param>
611 <param name="idOfContainingObj">The ID of the object that contains <paramref name="obj" />. This parameter is required only if <paramref name="obj" /> is a value type.</param>
612 <param name="member">The field in the containing object where <paramref name="obj" /> exists. This parameter has meaning only if <paramref name="obj" /> is a value type.</param>
613 <param name="arrayIndex">If <paramref name="obj" /> is a <see cref="T:System.ValueType" /> and a member of an array, <paramref name="arrayIndex" /> contains the index within that array where <paramref name="obj" /> exists. <paramref name="arrayIndex" /> is ignored if <paramref name="obj" /> is not both a <see cref="T:System.ValueType" /> and a member of an array.</param>
614 <exception cref="T:System.ArgumentNullException">The <paramref name="obj" /> parameter is <see langword="null" />.</exception>
615 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="objectID" /> parameter is less than or equal to zero.</exception>
616 <exception cref="T:System.Runtime.Serialization.SerializationException">The <paramref name="objectID" /> has already been registered for an object other than <paramref name="obj" />, or <paramref name="member" /> is not a <see cref="T:System.Reflection.FieldInfo" /> and <paramref name="member" /> isn't <see langword="null" />.</exception>
618 <member name="T:System.Runtime.Serialization.SerializationBinder">
619 <summary>Allows users to control class loading and mandate what class to load.</summary>
621 <member name="M:System.Runtime.Serialization.SerializationBinder.#ctor">
622 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.SerializationBinder" /> class.</summary>
624 <member name="M:System.Runtime.Serialization.SerializationBinder.BindToName(System.Type,System.String@,System.String@)">
625 <summary>When overridden in a derived class, controls the binding of a serialized object to a type.</summary>
626 <param name="serializedType">The type of the object the formatter creates a new instance of.</param>
627 <param name="assemblyName">Specifies the <see cref="T:System.Reflection.Assembly" /> name of the serialized object.</param>
628 <param name="typeName">Specifies the <see cref="T:System.Type" /> name of the serialized object.</param>
630 <member name="M:System.Runtime.Serialization.SerializationBinder.BindToType(System.String,System.String)">
631 <summary>When overridden in a derived class, controls the binding of a serialized object to a type.</summary>
632 <param name="assemblyName">Specifies the <see cref="T:System.Reflection.Assembly" /> name of the serialized object.</param>
633 <param name="typeName">Specifies the <see cref="T:System.Type" /> name of the serialized object.</param>
634 <returns>The type of the object the formatter creates a new instance of.</returns>
636 <member name="T:System.Runtime.Serialization.SerializationObjectManager">
637 <summary>Manages serialization processes at run time. This class cannot be inherited.</summary>
639 <member name="M:System.Runtime.Serialization.SerializationObjectManager.#ctor(System.Runtime.Serialization.StreamingContext)">
640 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.SerializationObjectManager" /> class.</summary>
641 <param name="context">An instance of the <see cref="T:System.Runtime.Serialization.StreamingContext" /> class that contains information about the current serialization operation.</param>
643 <member name="M:System.Runtime.Serialization.SerializationObjectManager.RaiseOnSerializedEvent">
644 <summary>Invokes the OnSerializing callback event if the type of the object has one; and registers the object for raising the OnSerialized event if the type of the object has one.</summary>
646 <member name="M:System.Runtime.Serialization.SerializationObjectManager.RegisterObject(System.Object)">
647 <summary>Registers the object upon which events will be raised.</summary>
648 <param name="obj">The object to register.</param>
650 <member name="T:System.Runtime.Serialization.SurrogateSelector">
651 <summary>Assists formatters in selection of the serialization surrogate to delegate the serialization or deserialization process to.</summary>
653 <member name="M:System.Runtime.Serialization.SurrogateSelector.#ctor">
654 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.SurrogateSelector" /> class.</summary>
656 <member name="M:System.Runtime.Serialization.SurrogateSelector.AddSurrogate(System.Type,System.Runtime.Serialization.StreamingContext,System.Runtime.Serialization.ISerializationSurrogate)">
657 <summary>Adds a surrogate to the list of checked surrogates.</summary>
658 <param name="type">The <see cref="T:System.Type" /> for which the surrogate is required.</param>
659 <param name="context">The context-specific data.</param>
660 <param name="surrogate">The surrogate to call for this type.</param>
661 <exception cref="T:System.ArgumentNullException">The <paramref name="type" /> or <paramref name="surrogate" /> parameter is <see langword="null" />.</exception>
662 <exception cref="T:System.ArgumentException">A surrogate already exists for this type and context.</exception>
664 <member name="M:System.Runtime.Serialization.SurrogateSelector.ChainSelector(System.Runtime.Serialization.ISurrogateSelector)">
665 <summary>Adds the specified <see cref="T:System.Runtime.Serialization.ISurrogateSelector" /> that can handle a particular object type to the list of surrogates.</summary>
666 <param name="selector">The surrogate selector to add.</param>
667 <exception cref="T:System.ArgumentNullException">The <paramref name="selector" /> parameter is <see langword="null" />.</exception>
668 <exception cref="T:System.Runtime.Serialization.SerializationException">The selector is already on the list of selectors.</exception>
669 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
671 <member name="M:System.Runtime.Serialization.SurrogateSelector.GetNextSelector">
672 <summary>Returns the next selector on the chain of selectors.</summary>
673 <returns>The next <see cref="T:System.Runtime.Serialization.ISurrogateSelector" /> on the chain of selectors.</returns>
674 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
676 <member name="M:System.Runtime.Serialization.SurrogateSelector.GetSurrogate(System.Type,System.Runtime.Serialization.StreamingContext,System.Runtime.Serialization.ISurrogateSelector@)">
677 <summary>Returns the surrogate for a particular type.</summary>
678 <param name="type">The <see cref="T:System.Type" /> for which the surrogate is requested.</param>
679 <param name="context">The streaming context.</param>
680 <param name="selector">The surrogate to use.</param>
681 <returns>The surrogate for a particular type.</returns>
682 <exception cref="T:System.ArgumentNullException">The <paramref name="type" /> parameter is <see langword="null" />.</exception>
683 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
685 <member name="M:System.Runtime.Serialization.SurrogateSelector.RemoveSurrogate(System.Type,System.Runtime.Serialization.StreamingContext)">
686 <summary>Removes the surrogate associated with a given type.</summary>
687 <param name="type">The <see cref="T:System.Type" /> for which to remove the surrogate.</param>
688 <param name="context">The <see cref="T:System.Runtime.Serialization.StreamingContext" /> for the current surrogate.</param>
689 <exception cref="T:System.ArgumentNullException">The <paramref name="type" /> parameter is <see langword="null" />.</exception>