1 <?xml version="1.0" encoding="utf-8"?><doc>
3 <name>System.Runtime.Serialization.Formatters</name>
6 <member name="T:System.SerializableAttribute">
7 <summary>Indicates that a class can be serialized. This class cannot be inherited.</summary>
9 <member name="M:System.SerializableAttribute.#ctor">
10 <summary>Initializes a new instance of the <see cref="T:System.SerializableAttribute"></see> class.</summary>
12 <member name="T:System.NonSerializedAttribute">
13 <summary>Indicates that a field of a serializable class should not be serialized. This class cannot be inherited.</summary>
15 <member name="M:System.NonSerializedAttribute.#ctor">
16 <summary>Initializes a new instance of the <see cref="T:System.NonSerializedAttribute"></see> class.</summary>
18 <member name="T:System.Runtime.Serialization.Formatters.TypeFilterLevel">
19 <summary>Specifies the level of automatic deserialization for .NET Framework remoting.</summary>
21 <member name="F:System.Runtime.Serialization.Formatters.TypeFilterLevel.Full">
22 <summary>The full deserialization level for .NET Framework remoting. It supports all types that remoting supports in all situations.</summary>
25 <member name="F:System.Runtime.Serialization.Formatters.TypeFilterLevel.Low">
26 <summary>The low deserialization level for .NET Framework remoting. It supports types associated with basic remoting functionality.</summary>
29 <member name="T:System.Runtime.Serialization.Formatters.IFieldInfo">
30 <summary>Allows access to field names and field types of objects that support the <see cref="T:System.Runtime.Serialization.ISerializable"></see> interface.</summary>
32 <member name="P:System.Runtime.Serialization.Formatters.IFieldInfo.FieldNames">
33 <summary>Gets or sets the field names of serialized objects.</summary>
34 <returns>The field names of serialized objects.</returns>
35 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
37 <member name="P:System.Runtime.Serialization.Formatters.IFieldInfo.FieldTypes">
38 <summary>Gets or sets the field types of the serialized objects.</summary>
39 <returns>The field types of the serialized objects.</returns>
40 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
42 <member name="T:System.Runtime.Serialization.Formatters.FormatterTypeStyle">
43 <summary>Indicates the format in which type descriptions are laid out in the serialized stream.</summary>
45 <member name="F:System.Runtime.Serialization.Formatters.FormatterTypeStyle.TypesAlways">
46 <summary>Indicates that types can be given to all object members and <see cref="T:System.Runtime.Serialization.ISerializable"></see> object members.</summary>
49 <member name="F:System.Runtime.Serialization.Formatters.FormatterTypeStyle.TypesWhenNeeded">
50 <summary>Indicates that types can be stated only for arrays of objects, object members of type <see cref="T:System.Object"></see>, and <see cref="T:System.Runtime.Serialization.ISerializable"></see> non-primitive value types.</summary>
53 <member name="F:System.Runtime.Serialization.Formatters.FormatterTypeStyle.XsdString">
54 <summary>Indicates that strings can be given in the XSD format rather than SOAP. No string IDs are transmitted.</summary>
57 <member name="T:System.Runtime.Serialization.SurrogateSelector">
58 <summary>Assists formatters in selection of the serialization surrogate to delegate the serialization or deserialization process to.</summary>
60 <member name="M:System.Runtime.Serialization.SurrogateSelector.#ctor">
61 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.SurrogateSelector"></see> class.</summary>
63 <member name="M:System.Runtime.Serialization.SurrogateSelector.AddSurrogate(System.Type,System.Runtime.Serialization.StreamingContext,System.Runtime.Serialization.ISerializationSurrogate)">
64 <summary>Adds a surrogate to the list of checked surrogates.</summary>
65 <param name="type">The <see cref="T:System.Type"></see> for which the surrogate is required.</param>
66 <param name="context">The context-specific data.</param>
67 <param name="surrogate">The surrogate to call for this type.</param>
68 <exception cref="T:System.ArgumentNullException">The <paramref name="type">type</paramref> or <paramref name="surrogate">surrogate</paramref> parameter is <see langword="null"></see>.</exception>
69 <exception cref="T:System.ArgumentException">A surrogate already exists for this type and context.</exception>
71 <member name="M:System.Runtime.Serialization.SurrogateSelector.ChainSelector(System.Runtime.Serialization.ISurrogateSelector)">
72 <summary>Adds the specified <see cref="T:System.Runtime.Serialization.ISurrogateSelector"></see> that can handle a particular object type to the list of surrogates.</summary>
73 <param name="selector">The surrogate selector to add.</param>
74 <exception cref="T:System.ArgumentNullException">The <paramref name="selector">selector</paramref> parameter is <see langword="null"></see>.</exception>
75 <exception cref="T:System.Runtime.Serialization.SerializationException">The selector is already on the list of selectors.</exception>
76 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
78 <member name="M:System.Runtime.Serialization.SurrogateSelector.GetNextSelector">
79 <summary>Returns the next selector on the chain of selectors.</summary>
80 <returns>The next <see cref="T:System.Runtime.Serialization.ISurrogateSelector"></see> on the chain of selectors.</returns>
81 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
83 <member name="M:System.Runtime.Serialization.SurrogateSelector.GetSurrogate(System.Type,System.Runtime.Serialization.StreamingContext,System.Runtime.Serialization.ISurrogateSelector@)">
84 <summary>Returns the surrogate for a particular type.</summary>
85 <param name="type">The <see cref="T:System.Type"></see> for which the surrogate is requested.</param>
86 <param name="context">The streaming context.</param>
87 <param name="selector">The surrogate to use.</param>
88 <returns>The surrogate for a particular type.</returns>
89 <exception cref="T:System.ArgumentNullException">The <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</exception>
90 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
92 <member name="M:System.Runtime.Serialization.SurrogateSelector.RemoveSurrogate(System.Type,System.Runtime.Serialization.StreamingContext)">
93 <summary>Removes the surrogate associated with a given type.</summary>
94 <param name="type">The <see cref="T:System.Type"></see> for which to remove the surrogate.</param>
95 <param name="context">The <see cref="T:System.Runtime.Serialization.StreamingContext"></see> for the current surrogate.</param>
96 <exception cref="T:System.ArgumentNullException">The <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</exception>
98 <member name="T:System.Runtime.Serialization.SerializationObjectManager">
99 <summary>Manages serialization processes at run time. This class cannot be inherited.</summary>
101 <member name="M:System.Runtime.Serialization.SerializationObjectManager.#ctor(System.Runtime.Serialization.StreamingContext)">
102 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.SerializationObjectManager"></see> class.</summary>
103 <param name="context">An instance of the <see cref="T:System.Runtime.Serialization.StreamingContext"></see> class that contains information about the current serialization operation.</param>
105 <member name="M:System.Runtime.Serialization.SerializationObjectManager.RaiseOnSerializedEvent">
106 <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>
108 <member name="M:System.Runtime.Serialization.SerializationObjectManager.RegisterObject(System.Object)">
109 <summary>Registers the object upon which events will be raised.</summary>
110 <param name="obj">The object to register.</param>
112 <member name="T:System.Runtime.Serialization.SerializationInfoEnumerator">
113 <summary>Provides a formatter-friendly mechanism for parsing the data in <see cref="T:System.Runtime.Serialization.SerializationInfo"></see>. This class cannot be inherited.</summary>
115 <member name="P:System.Runtime.Serialization.SerializationInfoEnumerator.Current">
116 <summary>Gets the item currently being examined.</summary>
117 <returns>The item currently being examined.</returns>
118 <exception cref="T:System.InvalidOperationException">The enumerator has not started enumerating items or has reached the end of the enumeration.</exception>
120 <member name="M:System.Runtime.Serialization.SerializationInfoEnumerator.MoveNext">
121 <summary>Updates the enumerator to the next item.</summary>
122 <returns><see langword="true"></see> if a new element is found; otherwise, <see langword="false"></see>.</returns>
124 <member name="P:System.Runtime.Serialization.SerializationInfoEnumerator.Name">
125 <summary>Gets the name for the item currently being examined.</summary>
126 <returns>The item name.</returns>
127 <exception cref="T:System.InvalidOperationException">The enumerator has not started enumerating items or has reached the end of the enumeration.</exception>
129 <member name="P:System.Runtime.Serialization.SerializationInfoEnumerator.ObjectType">
130 <summary>Gets the type of the item currently being examined.</summary>
131 <returns>The type of the item currently being examined.</returns>
132 <exception cref="T:System.InvalidOperationException">The enumerator has not started enumerating items or has reached the end of the enumeration.</exception>
134 <member name="M:System.Runtime.Serialization.SerializationInfoEnumerator.Reset">
135 <summary>Resets the enumerator to the first item.</summary>
137 <member name="P:System.Runtime.Serialization.SerializationInfoEnumerator.Value">
138 <summary>Gets the value of the item currently being examined.</summary>
139 <returns>The value of the item currently being examined.</returns>
140 <exception cref="T:System.InvalidOperationException">The enumerator has not started enumerating items or has reached the end of the enumeration.</exception>
142 <member name="P:System.Runtime.Serialization.SerializationInfoEnumerator.System#Collections#IEnumerator#Current">
143 <summary>Gets the current item in the collection.</summary>
144 <returns>A <see cref="T:System.Runtime.Serialization.SerializationEntry"></see> that contains the current serialization data.</returns>
145 <exception cref="T:System.InvalidOperationException">The enumeration has not started or has already ended.</exception>
147 <member name="T:System.Runtime.Serialization.SerializationInfo">
148 <summary>Stores all the data needed to serialize or deserialize an object. This class cannot be inherited.</summary>
150 <member name="M:System.Runtime.Serialization.SerializationInfo.#ctor(System.Type,System.Runtime.Serialization.IFormatterConverter)">
151 <summary>Creates a new instance of the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> class.</summary>
152 <param name="type">The <see cref="T:System.Type"></see> of the object to serialize.</param>
153 <param name="converter">The <see cref="T:System.Runtime.Serialization.IFormatterConverter"></see> used during deserialization.</param>
154 <exception cref="T:System.ArgumentNullException"><paramref name="type">type</paramref> or <paramref name="converter">converter</paramref> is <see langword="null"></see>.</exception>
156 <member name="M:System.Runtime.Serialization.SerializationInfo.AddValue(System.String,System.Object,System.Type)">
157 <summary>Adds a value into the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store, where <paramref name="value">value</paramref> is associated with <paramref name="name">name</paramref> and is serialized as being of <see cref="T:System.Type"></see><paramref name="type">type</paramref>.</summary>
158 <param name="name">The name to associate with the value, so it can be deserialized later.</param>
159 <param name="value">The value to be serialized. Any children of this object will automatically be serialized.</param>
160 <param name="type">The <see cref="T:System.Type"></see> to associate with the current object. This parameter must always be the type of the object itself or of one of its base classes.</param>
161 <exception cref="T:System.ArgumentNullException">If <paramref name="name">name</paramref> or <paramref name="type">type</paramref> is <see langword="null"></see>.</exception>
162 <exception cref="T:System.Runtime.Serialization.SerializationException">A value has already been associated with <paramref name="name">name</paramref>.</exception>
164 <member name="M:System.Runtime.Serialization.SerializationInfo.AddValue(System.String,System.UInt64)">
165 <summary>Adds a 64-bit unsigned integer value into the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
166 <param name="name">The name to associate with the value, so it can be deserialized later.</param>
167 <param name="value">The <see langword="UInt64"></see> value to serialize.</param>
168 <exception cref="T:System.ArgumentNullException">The <paramref name="name">name</paramref> parameter is <see langword="null"></see>.</exception>
169 <exception cref="T:System.Runtime.Serialization.SerializationException">A value has already been associated with <paramref name="name">name</paramref>.</exception>
171 <member name="M:System.Runtime.Serialization.SerializationInfo.AddValue(System.String,System.UInt32)">
172 <summary>Adds a 32-bit unsigned integer value into the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
173 <param name="name">The name to associate with the value, so it can be deserialized later.</param>
174 <param name="value">The <see langword="UInt32"></see> value to serialize.</param>
175 <exception cref="T:System.ArgumentNullException">The <paramref name="name">name</paramref> parameter is <see langword="null"></see>.</exception>
176 <exception cref="T:System.Runtime.Serialization.SerializationException">A value has already been associated with <paramref name="name">name</paramref>.</exception>
178 <member name="M:System.Runtime.Serialization.SerializationInfo.AddValue(System.String,System.UInt16)">
179 <summary>Adds a 16-bit unsigned integer value into the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
180 <param name="name">The name to associate with the value, so it can be deserialized later.</param>
181 <param name="value">The <see langword="UInt16"></see> value to serialize.</param>
182 <exception cref="T:System.ArgumentNullException">The <paramref name="name">name</paramref> parameter is <see langword="null"></see>.</exception>
183 <exception cref="T:System.Runtime.Serialization.SerializationException">A value has already been associated with <paramref name="name">name</paramref>.</exception>
185 <member name="M:System.Runtime.Serialization.SerializationInfo.AddValue(System.String,System.Single)">
186 <summary>Adds a single-precision floating-point value into the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
187 <param name="name">The name to associate with the value, so it can be deserialized later.</param>
188 <param name="value">The single value to serialize.</param>
189 <exception cref="T:System.ArgumentNullException">The <paramref name="name">name</paramref> parameter is <see langword="null"></see>.</exception>
190 <exception cref="T:System.Runtime.Serialization.SerializationException">A value has already been associated with <paramref name="name">name</paramref>.</exception>
192 <member name="M:System.Runtime.Serialization.SerializationInfo.AddValue(System.String,System.SByte)">
193 <summary>Adds an 8-bit signed integer value into the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
194 <param name="name">The name to associate with the value, so it can be deserialized later.</param>
195 <param name="value">The <see langword="Sbyte"></see> value to serialize.</param>
196 <exception cref="T:System.ArgumentNullException">The <paramref name="name">name</paramref> parameter is <see langword="null"></see>.</exception>
197 <exception cref="T:System.Runtime.Serialization.SerializationException">A value has already been associated with <paramref name="name">name</paramref>.</exception>
199 <member name="M:System.Runtime.Serialization.SerializationInfo.AddValue(System.String,System.Object)">
200 <summary>Adds the specified object into the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store, where it is associated with a specified name.</summary>
201 <param name="name">The name to associate with the value, so it can be deserialized later.</param>
202 <param name="value">The value to be serialized. Any children of this object will automatically be serialized.</param>
203 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is <see langword="null"></see>.</exception>
204 <exception cref="T:System.Runtime.Serialization.SerializationException">A value has already been associated with <paramref name="name">name</paramref>.</exception>
206 <member name="M:System.Runtime.Serialization.SerializationInfo.AddValue(System.String,System.Int64)">
207 <summary>Adds a 64-bit signed integer value into the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
208 <param name="name">The name to associate with the value, so it can be deserialized later.</param>
209 <param name="value">The Int64 value to serialize.</param>
210 <exception cref="T:System.ArgumentNullException">The <paramref name="name">name</paramref> parameter is <see langword="null"></see>.</exception>
211 <exception cref="T:System.Runtime.Serialization.SerializationException">A value has already been associated with <paramref name="name">name</paramref>.</exception>
213 <member name="M:System.Runtime.Serialization.SerializationInfo.AddValue(System.String,System.Int32)">
214 <summary>Adds a 32-bit signed integer value into the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
215 <param name="name">The name to associate with the value, so it can be deserialized later.</param>
216 <param name="value">The <see langword="Int32"></see> value to serialize.</param>
217 <exception cref="T:System.ArgumentNullException">The <paramref name="name">name</paramref> parameter is <see langword="null"></see>.</exception>
218 <exception cref="T:System.Runtime.Serialization.SerializationException">A value has already been associated with <paramref name="name">name</paramref>.</exception>
220 <member name="M:System.Runtime.Serialization.SerializationInfo.AddValue(System.String,System.Int16)">
221 <summary>Adds a 16-bit signed integer value into the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
222 <param name="name">The name to associate with the value, so it can be deserialized later.</param>
223 <param name="value">The <see langword="Int16"></see> value to serialize.</param>
224 <exception cref="T:System.ArgumentNullException">The <paramref name="name">name</paramref> parameter is <see langword="null"></see>.</exception>
225 <exception cref="T:System.Runtime.Serialization.SerializationException">A value has already been associated with <paramref name="name">name</paramref>.</exception>
227 <member name="M:System.Runtime.Serialization.SerializationInfo.AddValue(System.String,System.Double)">
228 <summary>Adds a double-precision floating-point value into the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
229 <param name="name">The name to associate with the value, so it can be deserialized later.</param>
230 <param name="value">The double value to serialize.</param>
231 <exception cref="T:System.ArgumentNullException">The <paramref name="name">name</paramref> parameter is <see langword="null"></see>.</exception>
232 <exception cref="T:System.Runtime.Serialization.SerializationException">A value has already been associated with <paramref name="name">name</paramref>.</exception>
234 <member name="M:System.Runtime.Serialization.SerializationInfo.AddValue(System.String,System.Decimal)">
235 <summary>Adds a decimal value into the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
236 <param name="name">The name to associate with the value, so it can be deserialized later.</param>
237 <param name="value">The decimal value to serialize.</param>
238 <exception cref="T:System.ArgumentNullException">If The <paramref name="name">name</paramref> parameter is <see langword="null"></see>.</exception>
239 <exception cref="T:System.Runtime.Serialization.SerializationException">If a value has already been associated with <paramref name="name">name</paramref>.</exception>
241 <member name="M:System.Runtime.Serialization.SerializationInfo.AddValue(System.String,System.DateTime)">
242 <summary>Adds a <see cref="T:System.DateTime"></see> value into the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
243 <param name="name">The name to associate with the value, so it can be deserialized later.</param>
244 <param name="value">The <see cref="T:System.DateTime"></see> value to serialize.</param>
245 <exception cref="T:System.ArgumentNullException">The <paramref name="name">name</paramref> parameter is <see langword="null"></see>.</exception>
246 <exception cref="T:System.Runtime.Serialization.SerializationException">A value has already been associated with <paramref name="name">name</paramref>.</exception>
248 <member name="M:System.Runtime.Serialization.SerializationInfo.AddValue(System.String,System.Char)">
249 <summary>Adds a Unicode character value into the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
250 <param name="name">The name to associate with the value, so it can be deserialized later.</param>
251 <param name="value">The character value to serialize.</param>
252 <exception cref="T:System.ArgumentNullException">The <paramref name="name">name</paramref> parameter is <see langword="null"></see>.</exception>
253 <exception cref="T:System.Runtime.Serialization.SerializationException">A value has already been associated with <paramref name="name">name</paramref>.</exception>
255 <member name="M:System.Runtime.Serialization.SerializationInfo.AddValue(System.String,System.Byte)">
256 <summary>Adds an 8-bit unsigned integer value into the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
257 <param name="name">The name to associate with the value, so it can be deserialized later.</param>
258 <param name="value">The byte value to serialize.</param>
259 <exception cref="T:System.ArgumentNullException">The <paramref name="name">name</paramref> parameter is <see langword="null"></see>.</exception>
260 <exception cref="T:System.Runtime.Serialization.SerializationException">A value has already been associated with <paramref name="name">name</paramref>.</exception>
262 <member name="M:System.Runtime.Serialization.SerializationInfo.AddValue(System.String,System.Boolean)">
263 <summary>Adds a Boolean value into the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
264 <param name="name">The name to associate with the value, so it can be deserialized later.</param>
265 <param name="value">The Boolean value to serialize.</param>
266 <exception cref="T:System.ArgumentNullException">The <paramref name="name">name</paramref> parameter is <see langword="null"></see>.</exception>
267 <exception cref="T:System.Runtime.Serialization.SerializationException">A value has already been associated with <paramref name="name">name</paramref>.</exception>
269 <member name="P:System.Runtime.Serialization.SerializationInfo.AssemblyName">
270 <summary>Gets or sets the assembly name of the type to serialize during serialization only.</summary>
271 <returns>The full name of the assembly of the type to serialize.</returns>
272 <exception cref="T:System.ArgumentNullException">The value the property is set to is <see langword="null"></see>.</exception>
274 <member name="P:System.Runtime.Serialization.SerializationInfo.FullTypeName">
275 <summary>Gets or sets the full name of the <see cref="T:System.Type"></see> to serialize.</summary>
276 <returns>The full name of the type to serialize.</returns>
277 <exception cref="T:System.ArgumentNullException">The value this property is set to is <see langword="null"></see>.</exception>
279 <member name="M:System.Runtime.Serialization.SerializationInfo.GetBoolean(System.String)">
280 <summary>Retrieves a Boolean value from the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
281 <param name="name">The name associated with the value to retrieve.</param>
282 <returns>The Boolean value associated with <paramref name="name">name</paramref>.</returns>
283 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is <see langword="null"></see>.</exception>
284 <exception cref="T:System.InvalidCastException">The value associated with <paramref name="name">name</paramref> cannot be converted to a Boolean value.</exception>
285 <exception cref="T:System.Runtime.Serialization.SerializationException">An element with the specified name is not found in the current instance.</exception>
287 <member name="M:System.Runtime.Serialization.SerializationInfo.GetByte(System.String)">
288 <summary>Retrieves an 8-bit unsigned integer value from the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
289 <param name="name">The name associated with the value to retrieve.</param>
290 <returns>The 8-bit unsigned integer associated with <paramref name="name">name</paramref>.</returns>
291 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is <see langword="null"></see>.</exception>
292 <exception cref="T:System.InvalidCastException">The value associated with <paramref name="name">name</paramref> cannot be converted to an 8-bit unsigned integer.</exception>
293 <exception cref="T:System.Runtime.Serialization.SerializationException">An element with the specified name is not found in the current instance.</exception>
295 <member name="M:System.Runtime.Serialization.SerializationInfo.GetChar(System.String)">
296 <summary>Retrieves a Unicode character value from the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
297 <param name="name">The name associated with the value to retrieve.</param>
298 <returns>The Unicode character associated with <paramref name="name">name</paramref>.</returns>
299 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is <see langword="null"></see>.</exception>
300 <exception cref="T:System.InvalidCastException">The value associated with <paramref name="name">name</paramref> cannot be converted to a Unicode character.</exception>
301 <exception cref="T:System.Runtime.Serialization.SerializationException">An element with the specified name is not found in the current instance.</exception>
303 <member name="M:System.Runtime.Serialization.SerializationInfo.GetDateTime(System.String)">
304 <summary>Retrieves a <see cref="T:System.DateTime"></see> value from the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
305 <param name="name">The name associated with the value to retrieve.</param>
306 <returns>The <see cref="T:System.DateTime"></see> value associated with <paramref name="name">name</paramref>.</returns>
307 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is <see langword="null"></see>.</exception>
308 <exception cref="T:System.InvalidCastException">The value associated with <paramref name="name">name</paramref> cannot be converted to a <see cref="System.DateTime"></see> value.</exception>
309 <exception cref="T:System.Runtime.Serialization.SerializationException">An element with the specified name is not found in the current instance.</exception>
311 <member name="M:System.Runtime.Serialization.SerializationInfo.GetDecimal(System.String)">
312 <summary>Retrieves a decimal value from the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
313 <param name="name">The name associated with the value to retrieve.</param>
314 <returns>A decimal value from the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see>.</returns>
315 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is <see langword="null"></see>.</exception>
316 <exception cref="T:System.InvalidCastException">The value associated with <paramref name="name">name</paramref> cannot be converted to a decimal.</exception>
317 <exception cref="T:System.Runtime.Serialization.SerializationException">An element with the specified name is not found in the current instance.</exception>
319 <member name="M:System.Runtime.Serialization.SerializationInfo.GetDouble(System.String)">
320 <summary>Retrieves a double-precision floating-point value from the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
321 <param name="name">The name associated with the value to retrieve.</param>
322 <returns>The double-precision floating-point value associated with <paramref name="name">name</paramref>.</returns>
323 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is <see langword="null"></see>.</exception>
324 <exception cref="T:System.InvalidCastException">The value associated with <paramref name="name">name</paramref> cannot be converted to a double-precision floating-point value.</exception>
325 <exception cref="T:System.Runtime.Serialization.SerializationException">An element with the specified name is not found in the current instance.</exception>
327 <member name="M:System.Runtime.Serialization.SerializationInfo.GetEnumerator">
328 <summary>Returns a <see cref="T:System.Runtime.Serialization.SerializationInfoEnumerator"></see> used to iterate through the name-value pairs in the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
329 <returns>A <see cref="T:System.Runtime.Serialization.SerializationInfoEnumerator"></see> for parsing the name-value pairs contained in the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</returns>
331 <member name="M:System.Runtime.Serialization.SerializationInfo.GetInt16(System.String)">
332 <summary>Retrieves a 16-bit signed integer value from the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
333 <param name="name">The name associated with the value to retrieve.</param>
334 <returns>The 16-bit signed integer associated with <paramref name="name">name</paramref>.</returns>
335 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is <see langword="null"></see>.</exception>
336 <exception cref="T:System.InvalidCastException">The value associated with <paramref name="name">name</paramref> cannot be converted to a 16-bit signed integer.</exception>
337 <exception cref="T:System.Runtime.Serialization.SerializationException">An element with the specified name is not found in the current instance.</exception>
339 <member name="M:System.Runtime.Serialization.SerializationInfo.GetInt32(System.String)">
340 <summary>Retrieves a 32-bit signed integer value from the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
341 <param name="name">The name of the value to retrieve.</param>
342 <returns>The 32-bit signed integer associated with <paramref name="name">name</paramref>.</returns>
343 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is <see langword="null"></see>.</exception>
344 <exception cref="T:System.InvalidCastException">The value associated with <paramref name="name">name</paramref> cannot be converted to a 32-bit signed integer.</exception>
345 <exception cref="T:System.Runtime.Serialization.SerializationException">An element with the specified name is not found in the current instance.</exception>
347 <member name="M:System.Runtime.Serialization.SerializationInfo.GetInt64(System.String)">
348 <summary>Retrieves a 64-bit signed integer value from the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
349 <param name="name">The name associated with the value to retrieve.</param>
350 <returns>The 64-bit signed integer associated with <paramref name="name">name</paramref>.</returns>
351 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is <see langword="null"></see>.</exception>
352 <exception cref="T:System.InvalidCastException">The value associated with <paramref name="name">name</paramref> cannot be converted to a 64-bit signed integer.</exception>
353 <exception cref="T:System.Runtime.Serialization.SerializationException">An element with the specified name is not found in the current instance.</exception>
355 <member name="M:System.Runtime.Serialization.SerializationInfo.GetSByte(System.String)">
356 <summary>Retrieves an 8-bit signed integer value from the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
357 <param name="name">The name associated with the value to retrieve.</param>
358 <returns>The 8-bit signed integer associated with <paramref name="name">name</paramref>.</returns>
359 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is <see langword="null"></see>.</exception>
360 <exception cref="T:System.InvalidCastException">The value associated with <paramref name="name">name</paramref> cannot be converted to an 8-bit signed integer.</exception>
361 <exception cref="T:System.Runtime.Serialization.SerializationException">An element with the specified name is not found in the current instance.</exception>
363 <member name="M:System.Runtime.Serialization.SerializationInfo.GetSingle(System.String)">
364 <summary>Retrieves a single-precision floating-point value from the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
365 <param name="name">The name of the value to retrieve.</param>
366 <returns>The single-precision floating-point value associated with <paramref name="name">name</paramref>.</returns>
367 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is <see langword="null"></see>.</exception>
368 <exception cref="T:System.InvalidCastException">The value associated with <paramref name="name">name</paramref> cannot be converted to a single-precision floating-point value.</exception>
369 <exception cref="T:System.Runtime.Serialization.SerializationException">An element with the specified name is not found in the current instance.</exception>
371 <member name="M:System.Runtime.Serialization.SerializationInfo.GetString(System.String)">
372 <summary>Retrieves a <see cref="T:System.String"></see> value from the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
373 <param name="name">The name associated with the value to retrieve.</param>
374 <returns>The <see cref="T:System.String"></see> associated with <paramref name="name">name</paramref>.</returns>
375 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is <see langword="null"></see>.</exception>
376 <exception cref="T:System.InvalidCastException">The value associated with <paramref name="name">name</paramref> cannot be converted to a <see cref="System.String"></see>.</exception>
377 <exception cref="T:System.Runtime.Serialization.SerializationException">An element with the specified name is not found in the current instance.</exception>
379 <member name="M:System.Runtime.Serialization.SerializationInfo.GetUInt16(System.String)">
380 <summary>Retrieves a 16-bit unsigned integer value from the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
381 <param name="name">The name associated with the value to retrieve.</param>
382 <returns>The 16-bit unsigned integer associated with <paramref name="name">name</paramref>.</returns>
383 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is <see langword="null"></see>.</exception>
384 <exception cref="T:System.InvalidCastException">The value associated with <paramref name="name">name</paramref> cannot be converted to a 16-bit unsigned integer.</exception>
385 <exception cref="T:System.Runtime.Serialization.SerializationException">An element with the specified name is not found in the current instance.</exception>
387 <member name="M:System.Runtime.Serialization.SerializationInfo.GetUInt32(System.String)">
388 <summary>Retrieves a 32-bit unsigned integer value from the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
389 <param name="name">The name associated with the value to retrieve.</param>
390 <returns>The 32-bit unsigned integer associated with <paramref name="name">name</paramref>.</returns>
391 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is <see langword="null"></see>.</exception>
392 <exception cref="T:System.InvalidCastException">The value associated with <paramref name="name">name</paramref> cannot be converted to a 32-bit unsigned integer.</exception>
393 <exception cref="T:System.Runtime.Serialization.SerializationException">An element with the specified name is not found in the current instance.</exception>
395 <member name="M:System.Runtime.Serialization.SerializationInfo.GetUInt64(System.String)">
396 <summary>Retrieves a 64-bit unsigned integer value from the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
397 <param name="name">The name associated with the value to retrieve.</param>
398 <returns>The 64-bit unsigned integer associated with <paramref name="name">name</paramref>.</returns>
399 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is <see langword="null"></see>.</exception>
400 <exception cref="T:System.InvalidCastException">The value associated with <paramref name="name">name</paramref> cannot be converted to a 64-bit unsigned integer.</exception>
401 <exception cref="T:System.Runtime.Serialization.SerializationException">An element with the specified name is not found in the current instance.</exception>
403 <member name="M:System.Runtime.Serialization.SerializationInfo.GetValue(System.String,System.Type)">
404 <summary>Retrieves a value from the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
405 <param name="name">The name associated with the value to retrieve.</param>
406 <param name="type">The <see cref="T:System.Type"></see> of the value to retrieve. If the stored value cannot be converted to this type, the system will throw a <see cref="T:System.InvalidCastException"></see>.</param>
407 <returns>The object of the specified <see cref="T:System.Type"></see> associated with <paramref name="name">name</paramref>.</returns>
408 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> or <paramref name="type">type</paramref> is <see langword="null"></see>.</exception>
409 <exception cref="T:System.InvalidCastException">The value associated with <paramref name="name">name</paramref> cannot be converted to <paramref name="type">type</paramref>.</exception>
410 <exception cref="T:System.Runtime.Serialization.SerializationException">An element with the specified name is not found in the current instance.</exception>
412 <member name="P:System.Runtime.Serialization.SerializationInfo.MemberCount">
413 <summary>Gets the number of members that have been added to the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> store.</summary>
414 <returns>The number of members that have been added to the current <see cref="T:System.Runtime.Serialization.SerializationInfo"></see>.</returns>
416 <member name="P:System.Runtime.Serialization.SerializationInfo.ObjectType">
417 <summary>Returns the type of the object to be serialized.</summary>
418 <returns>The type of the object being serialized.</returns>
420 <member name="M:System.Runtime.Serialization.SerializationInfo.SetType(System.Type)">
421 <summary>Sets the <see cref="T:System.Type"></see> of the object to serialize.</summary>
422 <param name="type">The <see cref="T:System.Type"></see> of the object to serialize.</param>
423 <exception cref="T:System.ArgumentNullException">The <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</exception>
425 <member name="T:System.Runtime.Serialization.SerializationEntry">
426 <summary>Holds the value, <see cref="T:System.Type"></see>, and name of a serialized object.</summary>
428 <member name="P:System.Runtime.Serialization.SerializationEntry.Name">
429 <summary>Gets the name of the object.</summary>
430 <returns>The name of the object.</returns>
432 <member name="P:System.Runtime.Serialization.SerializationEntry.ObjectType">
433 <summary>Gets the <see cref="T:System.Type"></see> of the object.</summary>
434 <returns>The <see cref="T:System.Type"></see> of the object.</returns>
436 <member name="P:System.Runtime.Serialization.SerializationEntry.Value">
437 <summary>Gets the value contained in the object.</summary>
438 <returns>The value contained in the object.</returns>
440 <member name="T:System.Runtime.Serialization.SerializationBinder">
441 <summary>Allows users to control class loading and mandate what class to load.</summary>
443 <member name="M:System.Runtime.Serialization.SerializationBinder.#ctor">
444 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.SerializationBinder"></see> class.</summary>
446 <member name="M:System.Runtime.Serialization.SerializationBinder.BindToName(System.Type,System.String@,System.String@)">
447 <summary>When overridden in a derived class, controls the binding of a serialized object to a type.</summary>
448 <param name="serializedType">The type of the object the formatter creates a new instance of.</param>
449 <param name="assemblyName">Specifies the <see cref="T:System.Reflection.Assembly"></see> name of the serialized object.</param>
450 <param name="typeName">Specifies the <see cref="T:System.Type"></see> name of the serialized object.</param>
452 <member name="M:System.Runtime.Serialization.SerializationBinder.BindToType(System.String,System.String)">
453 <summary>When overridden in a derived class, controls the binding of a serialized object to a type.</summary>
454 <param name="assemblyName">Specifies the <see cref="T:System.Reflection.Assembly"></see> name of the serialized object.</param>
455 <param name="typeName">Specifies the <see cref="T:System.Type"></see> name of the serialized object.</param>
456 <returns>The type of the object the formatter creates a new instance of.</returns>
458 <member name="T:System.Runtime.Serialization.ObjectManager">
459 <summary>Keeps track of objects as they are deserialized.</summary>
461 <member name="M:System.Runtime.Serialization.ObjectManager.#ctor(System.Runtime.Serialization.ISurrogateSelector,System.Runtime.Serialization.StreamingContext)">
462 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.ObjectManager"></see> class.</summary>
463 <param name="selector">The surrogate selector to use. The <see cref="T:System.Runtime.Serialization.ISurrogateSelector"></see> 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>
464 <param name="context">The streaming context. The <see cref="T:System.Runtime.Serialization.StreamingContext"></see> is not used by <see langword="ObjectManager"></see>, but is passed as a parameter to any objects implementing <see cref="T:System.Runtime.Serialization.ISerializable"></see> or having a <see cref="T:System.Runtime.Serialization.ISerializationSurrogate"></see>. These objects can take specific actions depending on the source of the information to deserialize.</param>
465 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
467 <member name="M:System.Runtime.Serialization.ObjectManager.DoFixups">
468 <summary>Performs all the recorded fixups.</summary>
469 <exception cref="T:System.Runtime.Serialization.SerializationException">A fixup was not successfully completed.</exception>
471 <member name="M:System.Runtime.Serialization.ObjectManager.GetObject(System.Int64)">
472 <summary>Returns the object with the specified object ID.</summary>
473 <param name="objectID">The ID of the requested object.</param>
474 <returns>The object with the specified object ID if it has been previously stored or <see langword="null"></see> if no such object has been registered.</returns>
475 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="objectID">objectID</paramref> parameter is less than or equal to zero.</exception>
477 <member name="M:System.Runtime.Serialization.ObjectManager.RaiseDeserializationEvent">
478 <summary>Raises the deserialization event to any registered object that implements <see cref="T:System.Runtime.Serialization.IDeserializationCallback"></see>.</summary>
480 <member name="M:System.Runtime.Serialization.ObjectManager.RaiseOnDeserializingEvent(System.Object)">
481 <summary>Invokes the method marked with the <see cref="T:System.Runtime.Serialization.OnDeserializingAttribute"></see>.</summary>
482 <param name="obj">The instance of the type that contains the method to be invoked.</param>
484 <member name="M:System.Runtime.Serialization.ObjectManager.RecordArrayElementFixup(System.Int64,System.Int32,System.Int64)">
485 <summary>Records a fixup for one element in an array.</summary>
486 <param name="arrayToBeFixed">The ID of the array used to record a fixup.</param>
487 <param name="index">The index within arrayFixup that a fixup is requested for.</param>
488 <param name="objectRequired">The ID of the object that the current array element will point to after fixup is completed.</param>
489 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="arrayToBeFixed">arrayToBeFixed</paramref> or <paramref name="objectRequired">objectRequired</paramref> parameter is less than or equal to zero.</exception>
490 <exception cref="T:System.ArgumentNullException">The <paramref name="index">index</paramref> parameter is <see langword="null"></see>.</exception>
492 <member name="M:System.Runtime.Serialization.ObjectManager.RecordArrayElementFixup(System.Int64,System.Int32[],System.Int64)">
493 <summary>Records fixups for the specified elements in an array, to be executed later.</summary>
494 <param name="arrayToBeFixed">The ID of the array used to record a fixup.</param>
495 <param name="indices">The indexes within the multidimensional array that a fixup is requested for.</param>
496 <param name="objectRequired">The ID of the object the array elements will point to after fixup is completed.</param>
497 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="arrayToBeFixed">arrayToBeFixed</paramref> or <paramref name="objectRequired">objectRequired</paramref> parameter is less than or equal to zero.</exception>
498 <exception cref="T:System.ArgumentNullException">The <paramref name="indices">indices</paramref> parameter is <see langword="null"></see>.</exception>
500 <member name="M:System.Runtime.Serialization.ObjectManager.RecordDelayedFixup(System.Int64,System.String,System.Int64)">
501 <summary>Records a fixup for an object member, to be executed later.</summary>
502 <param name="objectToBeFixed">The ID of the object that needs the reference to objectRequired.</param>
503 <param name="memberName">The member name of objectToBeFixed where the fixup will be performed.</param>
504 <param name="objectRequired">The ID of the object required by objectToBeFixed.</param>
505 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="objectToBeFixed">objectToBeFixed</paramref> or <paramref name="objectRequired">objectRequired</paramref> parameter is less than or equal to zero.</exception>
506 <exception cref="T:System.ArgumentNullException">The <paramref name="memberName">memberName</paramref> parameter is <see langword="null"></see>.</exception>
508 <member name="M:System.Runtime.Serialization.ObjectManager.RecordFixup(System.Int64,System.Reflection.MemberInfo,System.Int64)">
509 <summary>Records a fixup for a member of an object, to be executed later.</summary>
510 <param name="objectToBeFixed">The ID of the object that needs the reference to the objectRequired object.</param>
511 <param name="member">The member of objectToBeFixed where the fixup will be performed.</param>
512 <param name="objectRequired">The ID of the object required by objectToBeFixed.</param>
513 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="objectToBeFixed">objectToBeFixed</paramref> or <paramref name="objectRequired">objectRequired</paramref> parameter is less than or equal to zero.</exception>
514 <exception cref="T:System.ArgumentNullException">The <paramref name="member">member</paramref> parameter is <see langword="null"></see>.</exception>
516 <member name="M:System.Runtime.Serialization.ObjectManager.RegisterObject(System.Object,System.Int64)">
517 <summary>Registers an object as it is deserialized, associating it with <paramref name="objectID">objectID</paramref>.</summary>
518 <param name="obj">The object to register.</param>
519 <param name="objectID">The ID of the object to register.</param>
520 <exception cref="T:System.ArgumentNullException">The <paramref name="obj">obj</paramref> parameter is <see langword="null"></see>.</exception>
521 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="objectID">objectID</paramref> parameter is less than or equal to zero.</exception>
522 <exception cref="T:System.Runtime.Serialization.SerializationException">The <paramref name="objectID">objectID</paramref> has already been registered for an object other than <paramref name="obj">obj</paramref>.</exception>
524 <member name="M:System.Runtime.Serialization.ObjectManager.RegisterObject(System.Object,System.Int64,System.Runtime.Serialization.SerializationInfo)">
525 <summary>Registers an object as it is deserialized, associating it with <paramref name="objectID">objectID</paramref>, and recording the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> used with it.</summary>
526 <param name="obj">The object to register.</param>
527 <param name="objectID">The ID of the object to register.</param>
528 <param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> used if obj implements <see cref="T:System.Runtime.Serialization.ISerializable"></see> or has a <see cref="T:System.Runtime.Serialization.ISerializationSurrogate"></see>. info will be completed with any required fixup information and then passed to the required object when that object is completed.</param>
529 <exception cref="T:System.ArgumentNullException">The <paramref name="obj">obj</paramref> parameter is <see langword="null"></see>.</exception>
530 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="objectID">objectID</paramref> parameter is less than or equal to zero.</exception>
531 <exception cref="T:System.Runtime.Serialization.SerializationException">The <paramref name="objectID">objectID</paramref> has already been registered for an object other than <paramref name="obj">obj</paramref>.</exception>
533 <member name="M:System.Runtime.Serialization.ObjectManager.RegisterObject(System.Object,System.Int64,System.Runtime.Serialization.SerializationInfo,System.Int64,System.Reflection.MemberInfo)">
534 <summary>Registers a member of an object as it is deserialized, associating it with <paramref name="objectID">objectID</paramref>, and recording the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see>.</summary>
535 <param name="obj">The object to register.</param>
536 <param name="objectID">The ID of the object to register.</param>
537 <param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> used if obj implements <see cref="T:System.Runtime.Serialization.ISerializable"></see> or has a <see cref="T:System.Runtime.Serialization.ISerializationSurrogate"></see>. info will be completed with any required fixup information and then passed to the required object when that object is completed.</param>
538 <param name="idOfContainingObj">The ID of the object that contains obj. This parameter is required only if obj is a value type.</param>
539 <param name="member">The field in the containing object where obj exists. This parameter has meaning only if obj is a value type.</param>
540 <exception cref="T:System.ArgumentNullException">The <paramref name="obj">obj</paramref> parameter is <see langword="null"></see>.</exception>
541 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="objectID">objectID</paramref> parameter is less than or equal to zero.</exception>
542 <exception cref="T:System.Runtime.Serialization.SerializationException">The <paramref name="objectID">objectID</paramref> has already been registered for an object other than <paramref name="obj">obj</paramref>, or <paramref name="member">member</paramref> is not a <see cref="System.Reflection.FieldInfo"></see> and <paramref name="member">member</paramref> is not <see langword="null"></see>.</exception>
544 <member name="M:System.Runtime.Serialization.ObjectManager.RegisterObject(System.Object,System.Int64,System.Runtime.Serialization.SerializationInfo,System.Int64,System.Reflection.MemberInfo,System.Int32[])">
545 <summary>Registers a member of an array contained in an object while it is deserialized, associating it with <paramref name="objectID">objectID</paramref>, and recording the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see>.</summary>
546 <param name="obj">The object to register.</param>
547 <param name="objectID">The ID of the object to register.</param>
548 <param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> used if obj implements <see cref="T:System.Runtime.Serialization.ISerializable"></see> or has a <see cref="T:System.Runtime.Serialization.ISerializationSurrogate"></see>. info will be completed with any required fixup information and then passed to the required object when that object is completed.</param>
549 <param name="idOfContainingObj">The ID of the object that contains obj. This parameter is required only if obj is a value type.</param>
550 <param name="member">The field in the containing object where obj exists. This parameter has meaning only if obj is a value type.</param>
551 <param name="arrayIndex">If obj is a <see cref="T:System.ValueType"></see> and a member of an array, arrayIndex contains the index within that array where obj exists. arrayIndex is ignored if obj is not both a <see cref="T:System.ValueType"></see> and a member of an array.</param>
552 <exception cref="T:System.ArgumentNullException">The <paramref name="obj">obj</paramref> parameter is <see langword="null"></see>.</exception>
553 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="objectID">objectID</paramref> parameter is less than or equal to zero.</exception>
554 <exception cref="T:System.Runtime.Serialization.SerializationException">The <paramref name="objectID">objectID</paramref> has already been registered for an object other than <paramref name="obj">obj</paramref>, or <paramref name="member">member</paramref> is not a <see cref="System.Reflection.FieldInfo"></see> and <paramref name="member">member</paramref> isn&#39;t <see langword="null"></see>.</exception>
556 <member name="T:System.Runtime.Serialization.ObjectIDGenerator">
557 <summary>Generates IDs for objects.</summary>
559 <member name="M:System.Runtime.Serialization.ObjectIDGenerator.#ctor">
560 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.ObjectIDGenerator"></see> class.</summary>
562 <member name="M:System.Runtime.Serialization.ObjectIDGenerator.GetId(System.Object,System.Boolean@)">
563 <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"></see>.</summary>
564 <param name="obj">The object you want an ID for.</param>
565 <param name="firstTime"><see langword="true"></see> if obj was not previously known to the <see cref="T:System.Runtime.Serialization.ObjectIDGenerator"></see>; otherwise, <see langword="false"></see>.</param>
566 <returns>The object&#39;s ID is used for serialization. <paramref name="firstTime">firstTime</paramref> is set to <see langword="true"></see> if this is the first time the object has been identified; otherwise, it is set to <see langword="false"></see>.</returns>
567 <exception cref="T:System.ArgumentNullException">The <paramref name="obj">obj</paramref> parameter is <see langword="null"></see>.</exception>
568 <exception cref="T:System.Runtime.Serialization.SerializationException">The <see cref="System.Runtime.Serialization.ObjectIDGenerator"></see> has been asked to keep track of too many objects.</exception>
570 <member name="M:System.Runtime.Serialization.ObjectIDGenerator.HasId(System.Object,System.Boolean@)">
571 <summary>Determines whether an object has already been assigned an ID.</summary>
572 <param name="obj">The object you are asking for.</param>
573 <param name="firstTime"><see langword="true"></see> if obj was not previously known to the <see cref="T:System.Runtime.Serialization.ObjectIDGenerator"></see>; otherwise, <see langword="false"></see>.</param>
574 <returns>The object ID of <paramref name="obj">obj</paramref> if previously known to the <see cref="T:System.Runtime.Serialization.ObjectIDGenerator"></see>; otherwise, zero.</returns>
575 <exception cref="T:System.ArgumentNullException">The <paramref name="obj">obj</paramref> parameter is <see langword="null"></see>.</exception>
577 <member name="T:System.Runtime.Serialization.ISurrogateSelector">
578 <summary>Indicates a serialization surrogate selector class.</summary>
580 <member name="M:System.Runtime.Serialization.ISurrogateSelector.ChainSelector(System.Runtime.Serialization.ISurrogateSelector)">
581 <summary>Specifies the next <see cref="T:System.Runtime.Serialization.ISurrogateSelector"></see> for surrogates to examine if the current instance does not have a surrogate for the specified type and assembly in the specified context.</summary>
582 <param name="selector">The next surrogate selector to examine.</param>
583 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
585 <member name="M:System.Runtime.Serialization.ISurrogateSelector.GetNextSelector">
586 <summary>Returns the next surrogate selector in the chain.</summary>
587 <returns>The next surrogate selector in the chain or <see langword="null"></see>.</returns>
588 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
590 <member name="M:System.Runtime.Serialization.ISurrogateSelector.GetSurrogate(System.Type,System.Runtime.Serialization.StreamingContext,System.Runtime.Serialization.ISurrogateSelector@)">
591 <summary>Finds the surrogate that represents the specified object&#39;s type, starting with the specified surrogate selector for the specified serialization context.</summary>
592 <param name="type">The <see cref="T:System.Type"></see> of object (class) that needs a surrogate.</param>
593 <param name="context">The source or destination context for the current serialization.</param>
594 <param name="selector">When this method returns, contains a <see cref="T:System.Runtime.Serialization.ISurrogateSelector"></see> that holds a reference to the surrogate selector where the appropriate surrogate was found. This parameter is passed uninitialized.</param>
595 <returns>The appropriate surrogate for the given type in the given context.</returns>
596 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
598 <member name="T:System.Runtime.Serialization.ISerializationSurrogate">
599 <summary>Implements a serialization surrogate selector that allows one object to perform serialization and deserialization of another.</summary>
601 <member name="M:System.Runtime.Serialization.ISerializationSurrogate.GetObjectData(System.Object,System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
602 <summary>Populates the provided <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> with the data needed to serialize the object.</summary>
603 <param name="obj">The object to serialize.</param>
604 <param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> to populate with data.</param>
605 <param name="context">The destination (see <see cref="T:System.Runtime.Serialization.StreamingContext"></see>) for this serialization.</param>
606 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
608 <member name="M:System.Runtime.Serialization.ISerializationSurrogate.SetObjectData(System.Object,System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext,System.Runtime.Serialization.ISurrogateSelector)">
609 <summary>Populates the object using the information in the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see>.</summary>
610 <param name="obj">The object to populate.</param>
611 <param name="info">The information to populate the object.</param>
612 <param name="context">The source from which the object is deserialized.</param>
613 <param name="selector">The surrogate selector where the search for a compatible surrogate begins.</param>
614 <returns>The populated deserialized object.</returns>
615 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
617 <member name="T:System.Runtime.Serialization.ISerializable">
618 <summary>Allows an object to control its own serialization and deserialization.</summary>
620 <member name="M:System.Runtime.Serialization.ISerializable.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
621 <summary>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> with the data needed to serialize the target object.</summary>
622 <param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> to populate with data.</param>
623 <param name="context">The destination (see <see cref="T:System.Runtime.Serialization.StreamingContext"></see>) for this serialization.</param>
624 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
626 <member name="T:System.Runtime.Serialization.IFormatterConverter">
627 <summary>Provides the connection between an instance of <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> and the formatter-provided class best suited to parse the data inside the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see>.</summary>
629 <member name="M:System.Runtime.Serialization.IFormatterConverter.Convert(System.Object,System.Type)">
630 <summary>Converts a value to the given <see cref="T:System.Type"></see>.</summary>
631 <param name="value">The object to be converted.</param>
632 <param name="type">The <see cref="T:System.Type"></see> into which value is to be converted.</param>
633 <returns>The converted <paramref name="value">value</paramref>.</returns>
635 <member name="M:System.Runtime.Serialization.IFormatterConverter.Convert(System.Object,System.TypeCode)">
636 <summary>Converts a value to the given <see cref="T:System.TypeCode"></see>.</summary>
637 <param name="value">The object to be converted.</param>
638 <param name="typeCode">The <see cref="T:System.TypeCode"></see> into which value is to be converted.</param>
639 <returns>The converted <paramref name="value">value</paramref>.</returns>
641 <member name="M:System.Runtime.Serialization.IFormatterConverter.ToBoolean(System.Object)">
642 <summary>Converts a value to a <see cref="T:System.Boolean"></see>.</summary>
643 <param name="value">The object to be converted.</param>
644 <returns>The converted <paramref name="value">value</paramref>.</returns>
646 <member name="M:System.Runtime.Serialization.IFormatterConverter.ToByte(System.Object)">
647 <summary>Converts a value to an 8-bit unsigned integer.</summary>
648 <param name="value">The object to be converted.</param>
649 <returns>The converted <paramref name="value">value</paramref>.</returns>
651 <member name="M:System.Runtime.Serialization.IFormatterConverter.ToChar(System.Object)">
652 <summary>Converts a value to a Unicode character.</summary>
653 <param name="value">The object to be converted.</param>
654 <returns>The converted <paramref name="value">value</paramref>.</returns>
656 <member name="M:System.Runtime.Serialization.IFormatterConverter.ToDateTime(System.Object)">
657 <summary>Converts a value to a <see cref="T:System.DateTime"></see>.</summary>
658 <param name="value">The object to be converted.</param>
659 <returns>The converted <paramref name="value">value</paramref>.</returns>
661 <member name="M:System.Runtime.Serialization.IFormatterConverter.ToDecimal(System.Object)">
662 <summary>Converts a value to a <see cref="T:System.Decimal"></see>.</summary>
663 <param name="value">The object to be converted.</param>
664 <returns>The converted <paramref name="value">value</paramref>.</returns>
666 <member name="M:System.Runtime.Serialization.IFormatterConverter.ToDouble(System.Object)">
667 <summary>Converts a value to a double-precision floating-point number.</summary>
668 <param name="value">The object to be converted.</param>
669 <returns>The converted <paramref name="value">value</paramref>.</returns>
671 <member name="M:System.Runtime.Serialization.IFormatterConverter.ToInt16(System.Object)">
672 <summary>Converts a value to a 16-bit signed integer.</summary>
673 <param name="value">The object to be converted.</param>
674 <returns>The converted <paramref name="value">value</paramref>.</returns>
676 <member name="M:System.Runtime.Serialization.IFormatterConverter.ToInt32(System.Object)">
677 <summary>Converts a value to a 32-bit signed integer.</summary>
678 <param name="value">The object to be converted.</param>
679 <returns>The converted <paramref name="value">value</paramref>.</returns>
681 <member name="M:System.Runtime.Serialization.IFormatterConverter.ToInt64(System.Object)">
682 <summary>Converts a value to a 64-bit signed integer.</summary>
683 <param name="value">The object to be converted.</param>
684 <returns>The converted <paramref name="value">value</paramref>.</returns>
686 <member name="M:System.Runtime.Serialization.IFormatterConverter.ToSByte(System.Object)">
687 <summary>Converts a value to a <see cref="T:System.SByte"></see>.</summary>
688 <param name="value">The object to be converted.</param>
689 <returns>The converted <paramref name="value">value</paramref>.</returns>
691 <member name="M:System.Runtime.Serialization.IFormatterConverter.ToSingle(System.Object)">
692 <summary>Converts a value to a single-precision floating-point number.</summary>
693 <param name="value">The object to be converted.</param>
694 <returns>The converted <paramref name="value">value</paramref>.</returns>
696 <member name="M:System.Runtime.Serialization.IFormatterConverter.ToString(System.Object)">
697 <summary>Converts a value to a <see cref="T:System.String"></see>.</summary>
698 <param name="value">The object to be converted.</param>
699 <returns>The converted <paramref name="value">value</paramref>.</returns>
701 <member name="M:System.Runtime.Serialization.IFormatterConverter.ToUInt16(System.Object)">
702 <summary>Converts a value to a 16-bit unsigned integer.</summary>
703 <param name="value">The object to be converted.</param>
704 <returns>The converted <paramref name="value">value</paramref>.</returns>
706 <member name="M:System.Runtime.Serialization.IFormatterConverter.ToUInt32(System.Object)">
707 <summary>Converts a value to a 32-bit unsigned integer.</summary>
708 <param name="value">The object to be converted.</param>
709 <returns>The converted <paramref name="value">value</paramref>.</returns>
711 <member name="M:System.Runtime.Serialization.IFormatterConverter.ToUInt64(System.Object)">
712 <summary>Converts a value to a 64-bit unsigned integer.</summary>
713 <param name="value">The object to be converted.</param>
714 <returns>The converted <paramref name="value">value</paramref>.</returns>
716 <member name="T:System.Runtime.Serialization.IFormatter">
717 <summary>Provides functionality for formatting serialized objects.</summary>
719 <member name="P:System.Runtime.Serialization.IFormatter.Binder">
720 <summary>Gets or sets the <see cref="T:System.Runtime.Serialization.SerializationBinder"></see> that performs type lookups during deserialization.</summary>
721 <returns>The <see cref="T:System.Runtime.Serialization.SerializationBinder"></see> that performs type lookups during deserialization.</returns>
723 <member name="P:System.Runtime.Serialization.IFormatter.Context">
724 <summary>Gets or sets the <see cref="T:System.Runtime.Serialization.StreamingContext"></see> used for serialization and deserialization.</summary>
725 <returns>The <see cref="T:System.Runtime.Serialization.StreamingContext"></see> used for serialization and deserialization.</returns>
727 <member name="M:System.Runtime.Serialization.IFormatter.Deserialize(System.IO.Stream)">
728 <summary>Deserializes the data on the provided stream and reconstitutes the graph of objects.</summary>
729 <param name="serializationStream">The stream that contains the data to deserialize.</param>
730 <returns>The top object of the deserialized graph.</returns>
732 <member name="M:System.Runtime.Serialization.IFormatter.Serialize(System.IO.Stream,System.Object)">
733 <summary>Serializes an object, or graph of objects with the given root to the provided stream.</summary>
734 <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>
735 <param name="graph">The object, or root of the object graph, to serialize. All child objects of this root object are automatically serialized.</param>
737 <member name="P:System.Runtime.Serialization.IFormatter.SurrogateSelector">
738 <summary>Gets or sets the <see cref="T:System.Runtime.Serialization.SurrogateSelector"></see> used by the current formatter.</summary>
739 <returns>The <see cref="T:System.Runtime.Serialization.SurrogateSelector"></see> used by this formatter.</returns>
741 <member name="T:System.Runtime.Serialization.IDeserializationCallback">
742 <summary>Indicates that a class is to be notified when deserialization of the entire object graph has been completed. Note that this interface is not called when deserializing with the XmlSerializer (System.Xml.Serialization.XmlSerializer).</summary>
744 <member name="M:System.Runtime.Serialization.IDeserializationCallback.OnDeserialization(System.Object)">
745 <summary>Runs when the entire object graph has been deserialized.</summary>
746 <param name="sender">The object that initiated the callback. The functionality for this parameter is not currently implemented.</param>
748 <member name="T:System.Runtime.Serialization.FormatterServices">
749 <summary>Provides static methods to aid with the implementation of a <see cref="T:System.Runtime.Serialization.Formatter"></see> for serialization. This class cannot be inherited.</summary>
751 <member name="M:System.Runtime.Serialization.FormatterServices.CheckTypeSecurity(System.Type,System.Runtime.Serialization.Formatters.TypeFilterLevel)">
752 <summary>Determines whether the specified <see cref="T:System.Type"></see> can be deserialized with the <see cref="T:System.Runtime.Serialization.Formatters.TypeFilterLevel"></see> property set to <see langword="Low"></see>.</summary>
753 <param name="t">The <see cref="T:System.Type"></see> to check for the ability to deserialize.</param>
754 <param name="securityLevel">The <see cref="T:System.Runtime.Serialization.Formatters.TypeFilterLevel"></see> property value.</param>
755 <exception cref="T:System.Security.SecurityException">The <paramref name="t">t</paramref> parameter is an advanced type and cannot be deserialized when the <see cref="System.Runtime.Serialization.Formatters.TypeFilterLevel"></see> property is set to <see langword="Low"></see>.</exception>
757 <member name="M:System.Runtime.Serialization.FormatterServices.GetObjectData(System.Object,System.Reflection.MemberInfo[])">
758 <summary>Extracts the data from the specified object and returns it as an array of objects.</summary>
759 <param name="obj">The object to write to the formatter.</param>
760 <param name="members">The members to extract from the object.</param>
761 <returns>An array of <see cref="T:System.Object"></see> that contains data stored in <paramref name="members">members</paramref> and associated with <paramref name="obj">obj</paramref>.</returns>
762 <exception cref="T:System.ArgumentNullException">The <paramref name="obj">obj</paramref> or <paramref name="members">members</paramref> parameter is <see langword="null"></see>.
763 An element of <paramref name="members">members</paramref> is <see langword="null"></see>.</exception>
764 <exception cref="T:System.Runtime.Serialization.SerializationException">An element of <paramref name="members">members</paramref> does not represent a field.</exception>
766 <member name="M:System.Runtime.Serialization.FormatterServices.GetSafeUninitializedObject(System.Type)">
767 <summary>Creates a new instance of the specified object type.</summary>
768 <param name="type">The type of object to create.</param>
769 <returns>A zeroed object of the specified type.</returns>
770 <exception cref="T:System.ArgumentNullException">The <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</exception>
771 <exception cref="T:System.Runtime.Serialization.SerializationException">The <paramref name="type">type</paramref> parameter is not a valid common language runtime type.</exception>
772 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
774 <member name="M:System.Runtime.Serialization.FormatterServices.GetSerializableMembers(System.Type)">
775 <summary>Gets all the serializable members for a class of the specified <see cref="T:System.Type"></see>.</summary>
776 <param name="type">The type being serialized.</param>
777 <returns>An array of type <see cref="T:System.Reflection.MemberInfo"></see> of the non-transient, non-static members.</returns>
778 <exception cref="T:System.ArgumentNullException">The <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</exception>
779 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
781 <member name="M:System.Runtime.Serialization.FormatterServices.GetSerializableMembers(System.Type,System.Runtime.Serialization.StreamingContext)">
782 <summary>Gets all the serializable members for a class of the specified <see cref="T:System.Type"></see> and in the provided <see cref="T:System.Runtime.Serialization.StreamingContext"></see>.</summary>
783 <param name="type">The type being serialized or cloned.</param>
784 <param name="context">The context where the serialization occurs.</param>
785 <returns>An array of type <see cref="T:System.Reflection.MemberInfo"></see> of the non-transient, non-static members.</returns>
786 <exception cref="T:System.ArgumentNullException">The <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</exception>
787 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
789 <member name="M:System.Runtime.Serialization.FormatterServices.GetSurrogateForCyclicalReference(System.Runtime.Serialization.ISerializationSurrogate)">
790 <summary>Returns a serialization surrogate for the specified <see cref="T:System.Runtime.Serialization.ISerializationSurrogate"></see>.</summary>
791 <param name="innerSurrogate">The specified surrogate.</param>
792 <returns>An <see cref="T:System.Runtime.Serialization.ISerializationSurrogate"></see> for the specified <paramref name="innerSurrogate">innerSurrogate</paramref>.</returns>
794 <member name="M:System.Runtime.Serialization.FormatterServices.GetTypeFromAssembly(System.Reflection.Assembly,System.String)">
795 <summary>Looks up the <see cref="T:System.Type"></see> of the specified object in the provided <see cref="T:System.Reflection.Assembly"></see>.</summary>
796 <param name="assem">The assembly where you want to look up the object.</param>
797 <param name="name">The name of the object.</param>
798 <returns>The <see cref="T:System.Type"></see> of the named object.</returns>
799 <exception cref="T:System.ArgumentNullException">The <paramref name="assem">assem</paramref> parameter is <see langword="null"></see>.</exception>
800 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
802 <member name="M:System.Runtime.Serialization.FormatterServices.GetUninitializedObject(System.Type)">
803 <summary>Creates a new instance of the specified object type.</summary>
804 <param name="type">The type of object to create.</param>
805 <returns>A zeroed object of the specified type.</returns>
806 <exception cref="T:System.ArgumentNullException">The <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</exception>
807 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
809 <member name="M:System.Runtime.Serialization.FormatterServices.PopulateObjectMembers(System.Object,System.Reflection.MemberInfo[],System.Object[])">
810 <summary>Populates the specified object with values for each field drawn from the data array of objects.</summary>
811 <param name="obj">The object to populate.</param>
812 <param name="members">An array of <see cref="T:System.Reflection.MemberInfo"></see> that describes which fields and properties to populate.</param>
813 <param name="data">An array of <see cref="T:System.Object"></see> that specifies the values for each field and property to populate.</param>
814 <returns>The newly populated object.</returns>
815 <exception cref="T:System.ArgumentNullException">The <paramref name="obj">obj</paramref>, <paramref name="members">members</paramref>, or <paramref name="data">data</paramref> parameter is <see langword="null"></see>.
816 An element of <paramref name="members">members</paramref> is <see langword="null"></see>.</exception>
817 <exception cref="T:System.ArgumentException">The length of <paramref name="members">members</paramref> does not match the length of <paramref name="data">data</paramref>.</exception>
818 <exception cref="T:System.Runtime.Serialization.SerializationException">An element of <paramref name="members">members</paramref> is not an instance of <see cref="System.Reflection.FieldInfo"></see>.</exception>
819 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
821 <member name="T:System.Runtime.Serialization.Formatters.FormatterAssemblyStyle">
822 <summary>Indicates the method that will be used during deserialization for locating and loading assemblies.</summary>
824 <member name="F:System.Runtime.Serialization.Formatters.FormatterAssemblyStyle.Full">
825 <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"></see> method of the <see cref="T:System.Reflection.Assembly"></see> class is used to load the assembly.</summary>
828 <member name="F:System.Runtime.Serialization.Formatters.FormatterAssemblyStyle.Simple">
829 <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"></see> method is used to load the assembly.</summary>
832 <member name="T:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter">
833 <summary>Serializes and deserializes an object, or an entire graph of connected objects, in binary format.</summary>
835 <member name="M:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.#ctor">
836 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter"></see> class with default values.</summary>
838 <member name="M:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.#ctor(System.Runtime.Serialization.ISurrogateSelector,System.Runtime.Serialization.StreamingContext)">
839 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter"></see> class with a given surrogate selector and streaming context.</summary>
840 <param name="selector">The <see cref="T:System.Runtime.Serialization.ISurrogateSelector"></see> to use. Can be <see langword="null"></see>.</param>
841 <param name="context">The source and destination for the serialized data.</param>
843 <member name="P:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.AssemblyFormat">
844 <summary>Gets or sets the behavior of the deserializer with regards to finding and loading assemblies.</summary>
845 <returns>One of the <see cref="T:System.Runtime.Serialization.Formatters.FormatterAssemblyStyle"></see> values that specifies the deserializer behavior.</returns>
847 <member name="P:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.Binder">
848 <summary>Gets or sets an object of type <see cref="T:System.Runtime.Serialization.SerializationBinder"></see> that controls the binding of a serialized object to a type.</summary>
849 <returns>The serialization binder to use with this formatter.</returns>
851 <member name="P:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.Context">
852 <summary>Gets or sets the <see cref="T:System.Runtime.Serialization.StreamingContext"></see> for this formatter.</summary>
853 <returns>The streaming context to use with this formatter.</returns>
855 <member name="M:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.Deserialize(System.IO.Stream)">
856 <summary>Deserializes the specified stream into an object graph.</summary>
857 <param name="serializationStream">The stream from which to deserialize the object graph.</param>
858 <returns>The top (root) of the object graph.</returns>
859 <exception cref="T:System.ArgumentNullException">The <paramref name="serializationStream">serializationStream</paramref> is <see langword="null"></see>.</exception>
860 <exception cref="T:System.Runtime.Serialization.SerializationException">The <paramref name="serializationStream">serializationStream</paramref> supports seeking, but its length is 0.
862 The target type is a <see cref="System.Decimal"></see>, but the value is out of range of the <see cref="System.Decimal"></see> type.</exception>
863 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
865 <member name="P:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.FilterLevel">
866 <summary>Gets or sets the <see cref="T:System.Runtime.Serialization.Formatters.TypeFilterLevel"></see> of automatic deserialization the <see cref="T:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter"></see> performs.</summary>
867 <returns>The <see cref="T:System.Runtime.Serialization.Formatters.TypeFilterLevel"></see> that represents the current automatic deserialization level.</returns>
869 <member name="M:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.Serialize(System.IO.Stream,System.Object)">
870 <summary>Serializes the object, or graph of objects with the specified top (root), to the given stream.</summary>
871 <param name="serializationStream">The stream to which the graph is to be serialized.</param>
872 <param name="graph">The object at the root of the graph to serialize.</param>
873 <exception cref="T:System.ArgumentNullException">The <paramref name="serializationStream">serializationStream</paramref> is <see langword="null"></see>.
875 The <paramref name="graph">graph</paramref> is null.</exception>
876 <exception cref="T:System.Runtime.Serialization.SerializationException">An error has occurred during serialization, such as if an object in the <paramref name="graph">graph</paramref> parameter is not marked as serializable.</exception>
877 <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
879 <member name="P:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.SurrogateSelector">
880 <summary>Gets or sets a <see cref="T:System.Runtime.Serialization.ISurrogateSelector"></see> that controls type substitution during serialization and deserialization.</summary>
881 <returns>The surrogate selector to use with this formatter.</returns>
883 <member name="P:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.TypeFormat">
884 <summary>Gets or sets the format in which type descriptions are laid out in the serialized stream.</summary>
885 <returns>The style of type layouts to use.</returns>
887 <member name="T:System.Runtime.Serialization.FormatterConverter">
888 <summary>Represents a base implementation of the <see cref="T:System.Runtime.Serialization.IFormatterConverter"></see> interface that uses the <see cref="T:System.Convert"></see> class and the <see cref="T:System.IConvertible"></see> interface.</summary>
890 <member name="M:System.Runtime.Serialization.FormatterConverter.#ctor">
891 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.FormatterConverter"></see> class.</summary>
893 <member name="M:System.Runtime.Serialization.FormatterConverter.Convert(System.Object,System.Type)">
894 <summary>Converts a value to the given <see cref="T:System.Type"></see>.</summary>
895 <param name="value">The object to convert.</param>
896 <param name="type">The <see cref="T:System.Type"></see> into which value is converted.</param>
897 <returns>The converted <paramref name="value">value</paramref> or <see langword="null"></see> if the <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</returns>
898 <exception cref="T:System.ArgumentNullException">The <paramref name="value">value</paramref> parameter is <see langword="null"></see>.</exception>
900 <member name="M:System.Runtime.Serialization.FormatterConverter.Convert(System.Object,System.TypeCode)">
901 <summary>Converts a value to the given <see cref="T:System.TypeCode"></see>.</summary>
902 <param name="value">The object to convert.</param>
903 <param name="typeCode">The <see cref="T:System.TypeCode"></see> into which value is converted.</param>
904 <returns>The converted <paramref name="value">value</paramref>, or <see langword="null"></see> if the <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</returns>
905 <exception cref="T:System.ArgumentNullException">The <paramref name="value">value</paramref> parameter is <see langword="null"></see>.</exception>
907 <member name="M:System.Runtime.Serialization.FormatterConverter.ToBoolean(System.Object)">
908 <summary>Converts a value to a <see cref="T:System.Boolean"></see>.</summary>
909 <param name="value">The object to convert.</param>
910 <returns>The converted <paramref name="value">value</paramref> or <see langword="null"></see> if the <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</returns>
911 <exception cref="T:System.ArgumentNullException">The <paramref name="value">value</paramref> parameter is <see langword="null"></see>.</exception>
913 <member name="M:System.Runtime.Serialization.FormatterConverter.ToByte(System.Object)">
914 <summary>Converts a value to an 8-bit unsigned integer.</summary>
915 <param name="value">The object to convert.</param>
916 <returns>The converted <paramref name="value">value</paramref> or <see langword="null"></see> if the <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</returns>
917 <exception cref="T:System.ArgumentNullException">The <paramref name="value">value</paramref> parameter is <see langword="null"></see>.</exception>
919 <member name="M:System.Runtime.Serialization.FormatterConverter.ToChar(System.Object)">
920 <summary>Converts a value to a Unicode character.</summary>
921 <param name="value">The object to convert.</param>
922 <returns>The converted <paramref name="value">value</paramref> or <see langword="null"></see> if the <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</returns>
923 <exception cref="T:System.ArgumentNullException">The <paramref name="value">value</paramref> parameter is <see langword="null"></see>.</exception>
925 <member name="M:System.Runtime.Serialization.FormatterConverter.ToDateTime(System.Object)">
926 <summary>Converts a value to a <see cref="T:System.DateTime"></see>.</summary>
927 <param name="value">The object to convert.</param>
928 <returns>The converted <paramref name="value">value</paramref> or <see langword="null"></see> if the <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</returns>
929 <exception cref="T:System.ArgumentNullException">The <paramref name="value">value</paramref> parameter is <see langword="null"></see>.</exception>
931 <member name="M:System.Runtime.Serialization.FormatterConverter.ToDecimal(System.Object)">
932 <summary>Converts a value to a <see cref="T:System.Decimal"></see>.</summary>
933 <param name="value">The object to convert.</param>
934 <returns>The converted <paramref name="value">value</paramref> or <see langword="null"></see> if the <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</returns>
935 <exception cref="T:System.ArgumentNullException">The <paramref name="value">value</paramref> parameter is <see langword="null"></see>.</exception>
937 <member name="M:System.Runtime.Serialization.FormatterConverter.ToDouble(System.Object)">
938 <summary>Converts a value to a double-precision floating-point number.</summary>
939 <param name="value">The object to convert.</param>
940 <returns>The converted <paramref name="value">value</paramref> or <see langword="null"></see> if the <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</returns>
941 <exception cref="T:System.ArgumentNullException">The <paramref name="value">value</paramref> parameter is <see langword="null"></see>.</exception>
943 <member name="M:System.Runtime.Serialization.FormatterConverter.ToInt16(System.Object)">
944 <summary>Converts a value to a 16-bit signed integer.</summary>
945 <param name="value">The object to convert.</param>
946 <returns>The converted <paramref name="value">value</paramref> or <see langword="null"></see> if the <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</returns>
947 <exception cref="T:System.ArgumentNullException">The <paramref name="value">value</paramref> parameter is <see langword="null"></see>.</exception>
949 <member name="M:System.Runtime.Serialization.FormatterConverter.ToInt32(System.Object)">
950 <summary>Converts a value to a 32-bit signed integer.</summary>
951 <param name="value">The object to convert.</param>
952 <returns>The converted <paramref name="value">value</paramref> or <see langword="null"></see> if the <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</returns>
953 <exception cref="T:System.ArgumentNullException">The <paramref name="value">value</paramref> parameter is <see langword="null"></see>.</exception>
955 <member name="M:System.Runtime.Serialization.FormatterConverter.ToInt64(System.Object)">
956 <summary>Converts a value to a 64-bit signed integer.</summary>
957 <param name="value">The object to convert.</param>
958 <returns>The converted <paramref name="value">value</paramref> or <see langword="null"></see> if the <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</returns>
959 <exception cref="T:System.ArgumentNullException">The <paramref name="value">value</paramref> parameter is <see langword="null"></see>.</exception>
961 <member name="M:System.Runtime.Serialization.FormatterConverter.ToSByte(System.Object)">
962 <summary>Converts a value to a <see cref="T:System.SByte"></see>.</summary>
963 <param name="value">The object to convert.</param>
964 <returns>The converted <paramref name="value">value</paramref> or <see langword="null"></see> if the <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</returns>
965 <exception cref="T:System.ArgumentNullException">The <paramref name="value">value</paramref> parameter is <see langword="null"></see>.</exception>
967 <member name="M:System.Runtime.Serialization.FormatterConverter.ToSingle(System.Object)">
968 <summary>Converts a value to a single-precision floating-point number.</summary>
969 <param name="value">The object to convert.</param>
970 <returns>The converted <paramref name="value">value</paramref> or <see langword="null"></see> if the <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</returns>
971 <exception cref="T:System.ArgumentNullException">The <paramref name="value">value</paramref> parameter is <see langword="null"></see>.</exception>
973 <member name="M:System.Runtime.Serialization.FormatterConverter.ToString(System.Object)">
974 <summary>Converts the specified object to a <see cref="T:System.String"></see>.</summary>
975 <param name="value">The object to convert.</param>
976 <returns>The converted <paramref name="value">value</paramref> or <see langword="null"></see> if the <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</returns>
977 <exception cref="T:System.ArgumentNullException">The <paramref name="value">value</paramref> parameter is <see langword="null"></see>.</exception>
979 <member name="M:System.Runtime.Serialization.FormatterConverter.ToUInt16(System.Object)">
980 <summary>Converts a value to a 16-bit unsigned integer.</summary>
981 <param name="value">The object to convert.</param>
982 <returns>The converted <paramref name="value">value</paramref> or <see langword="null"></see> if the <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</returns>
983 <exception cref="T:System.ArgumentNullException">The <paramref name="value">value</paramref> parameter is <see langword="null"></see>.</exception>
985 <member name="M:System.Runtime.Serialization.FormatterConverter.ToUInt32(System.Object)">
986 <summary>Converts a value to a 32-bit unsigned integer.</summary>
987 <param name="value">The object to convert.</param>
988 <returns>The converted <paramref name="value">value</paramref> or <see langword="null"></see> if the <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</returns>
989 <exception cref="T:System.ArgumentNullException">The <paramref name="value">value</paramref> parameter is <see langword="null"></see>.</exception>
991 <member name="M:System.Runtime.Serialization.FormatterConverter.ToUInt64(System.Object)">
992 <summary>Converts a value to a 64-bit unsigned integer.</summary>
993 <param name="value">The object to convert.</param>
994 <returns>The converted <paramref name="value">value</paramref> or <see langword="null"></see> if the <paramref name="type">type</paramref> parameter is <see langword="null"></see>.</returns>
995 <exception cref="T:System.ArgumentNullException">The <paramref name="value">value</paramref> parameter is <see langword="null"></see>.</exception>
997 <member name="T:System.Runtime.Serialization.Formatter">
998 <summary>Provides base functionality for the common language runtime serialization formatters.</summary>
1000 <member name="M:System.Runtime.Serialization.Formatter.#ctor">
1001 <summary>Initializes a new instance of the <see cref="T:System.Runtime.Serialization.Formatter"></see> class.</summary>
1003 <member name="P:System.Runtime.Serialization.Formatter.Binder">
1004 <summary>When overridden in a derived class, gets or sets the <see cref="T:System.Runtime.Serialization.SerializationBinder"></see> used with the current formatter.</summary>
1005 <returns>The <see cref="T:System.Runtime.Serialization.SerializationBinder"></see> used with the current formatter.</returns>
1007 <member name="P:System.Runtime.Serialization.Formatter.Context">
1008 <summary>When overridden in a derived class, gets or sets the <see cref="T:System.Runtime.Serialization.StreamingContext"></see> used for the current serialization.</summary>
1009 <returns>The <see cref="T:System.Runtime.Serialization.StreamingContext"></see> used for the current serialization.</returns>
1011 <member name="M:System.Runtime.Serialization.Formatter.Deserialize(System.IO.Stream)">
1012 <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>
1013 <param name="serializationStream">The stream to deserialize.</param>
1014 <returns>The top object of the deserialized graph of objects.</returns>
1016 <member name="M:System.Runtime.Serialization.Formatter.GetNext(System.Int64@)">
1017 <summary>Returns the next object to serialize, from the formatter&#39;s internal work queue.</summary>
1018 <param name="objID">The ID assigned to the current object during serialization.</param>
1019 <returns>The next object to serialize.</returns>
1020 <exception cref="T:System.Runtime.Serialization.SerializationException">The next object retrieved from the work queue did not have an assigned ID.</exception>
1022 <member name="F:System.Runtime.Serialization.Formatter.m_idGenerator">
1023 <summary>Contains the <see cref="T:System.Runtime.Serialization.ObjectIDGenerator"></see> used with the current formatter.</summary>
1026 <member name="F:System.Runtime.Serialization.Formatter.m_objectQueue">
1027 <summary>Contains a <see cref="T:System.Collections.Queue"></see> of the objects left to serialize.</summary>
1030 <member name="M:System.Runtime.Serialization.Formatter.Schedule(System.Object)">
1031 <summary>Schedules an object for later serialization.</summary>
1032 <param name="obj">The object to schedule for serialization.</param>
1033 <returns>The object ID assigned to the object.</returns>
1035 <member name="M:System.Runtime.Serialization.Formatter.Serialize(System.IO.Stream,System.Object)">
1036 <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>
1037 <param name="serializationStream">The stream to which the objects are serialized.</param>
1038 <param name="graph">The object at the root of the graph to serialize.</param>
1040 <member name="P:System.Runtime.Serialization.Formatter.SurrogateSelector">
1041 <summary>When overridden in a derived class, gets or sets the <see cref="T:System.Runtime.Serialization.ISurrogateSelector"></see> used with the current formatter.</summary>
1042 <returns>The <see cref="T:System.Runtime.Serialization.ISurrogateSelector"></see> used with the current formatter.</returns>
1044 <member name="M:System.Runtime.Serialization.Formatter.WriteArray(System.Object,System.String,System.Type)">
1045 <summary>When overridden in a derived class, writes an array to the stream already attached to the formatter.</summary>
1046 <param name="obj">The array to write.</param>
1047 <param name="name">The name of the array.</param>
1048 <param name="memberType">The type of elements that the array holds.</param>
1050 <member name="M:System.Runtime.Serialization.Formatter.WriteBoolean(System.Boolean,System.String)">
1051 <summary>When overridden in a derived class, writes a Boolean value to the stream already attached to the formatter.</summary>
1052 <param name="val">The value to write.</param>
1053 <param name="name">The name of the member.</param>
1055 <member name="M:System.Runtime.Serialization.Formatter.WriteByte(System.Byte,System.String)">
1056 <summary>When overridden in a derived class, writes an 8-bit unsigned integer to the stream already attached to the formatter.</summary>
1057 <param name="val">The value to write.</param>
1058 <param name="name">The name of the member.</param>
1060 <member name="M:System.Runtime.Serialization.Formatter.WriteChar(System.Char,System.String)">
1061 <summary>When overridden in a derived class, writes a Unicode character to the stream already attached to the formatter.</summary>
1062 <param name="val">The value to write.</param>
1063 <param name="name">The name of the member.</param>
1065 <member name="M:System.Runtime.Serialization.Formatter.WriteDateTime(System.DateTime,System.String)">
1066 <summary>When overridden in a derived class, writes a <see cref="T:System.DateTime"></see> value to the stream already attached to the formatter.</summary>
1067 <param name="val">The value to write.</param>
1068 <param name="name">The name of the member.</param>
1070 <member name="M:System.Runtime.Serialization.Formatter.WriteDecimal(System.Decimal,System.String)">
1071 <summary>When overridden in a derived class, writes a <see cref="T:System.Decimal"></see> value to the stream already attached to the formatter.</summary>
1072 <param name="val">The value to write.</param>
1073 <param name="name">The name of the member.</param>
1075 <member name="M:System.Runtime.Serialization.Formatter.WriteDouble(System.Double,System.String)">
1076 <summary>When overridden in a derived class, writes a double-precision floating-point number to the stream already attached to the formatter.</summary>
1077 <param name="val">The value to write.</param>
1078 <param name="name">The name of the member.</param>
1080 <member name="M:System.Runtime.Serialization.Formatter.WriteInt16(System.Int16,System.String)">
1081 <summary>When overridden in a derived class, writes a 16-bit signed integer to the stream already attached to the formatter.</summary>
1082 <param name="val">The value to write.</param>
1083 <param name="name">The name of the member.</param>
1085 <member name="M:System.Runtime.Serialization.Formatter.WriteInt32(System.Int32,System.String)">
1086 <summary>When overridden in a derived class, writes a 32-bit signed integer to the stream.</summary>
1087 <param name="val">The value to write.</param>
1088 <param name="name">The name of the member.</param>
1090 <member name="M:System.Runtime.Serialization.Formatter.WriteInt64(System.Int64,System.String)">
1091 <summary>When overridden in a derived class, writes a 64-bit signed integer to the stream.</summary>
1092 <param name="val">The value to write.</param>
1093 <param name="name">The name of the member.</param>
1095 <member name="M:System.Runtime.Serialization.Formatter.WriteMember(System.String,System.Object)">
1096 <summary>Inspects the type of data received, and calls the appropriate <see langword="Write"></see> method to perform the write to the stream already attached to the formatter.</summary>
1097 <param name="memberName">The name of the member to serialize.</param>
1098 <param name="data">The object to write to the stream attached to the formatter.</param>
1100 <member name="M:System.Runtime.Serialization.Formatter.WriteObjectRef(System.Object,System.String,System.Type)">
1101 <summary>When overridden in a derived class, writes an object reference to the stream already attached to the formatter.</summary>
1102 <param name="obj">The object reference to write.</param>
1103 <param name="name">The name of the member.</param>
1104 <param name="memberType">The type of object the reference points to.</param>
1106 <member name="M:System.Runtime.Serialization.Formatter.WriteSByte(System.SByte,System.String)">
1107 <summary>When overridden in a derived class, writes an 8-bit signed integer to the stream already attached to the formatter.</summary>
1108 <param name="val">The value to write.</param>
1109 <param name="name">The name of the member.</param>
1111 <member name="M:System.Runtime.Serialization.Formatter.WriteSingle(System.Single,System.String)">
1112 <summary>When overridden in a derived class, writes a single-precision floating-point number to the stream already attached to the formatter.</summary>
1113 <param name="val">The value to write.</param>
1114 <param name="name">The name of the member.</param>
1116 <member name="M:System.Runtime.Serialization.Formatter.WriteTimeSpan(System.TimeSpan,System.String)">
1117 <summary>When overridden in a derived class, writes a <see cref="T:System.TimeSpan"></see> value to the stream already attached to the formatter.</summary>
1118 <param name="val">The value to write.</param>
1119 <param name="name">The name of the member.</param>
1121 <member name="M:System.Runtime.Serialization.Formatter.WriteUInt16(System.UInt16,System.String)">
1122 <summary>When overridden in a derived class, writes a 16-bit unsigned integer to the stream already attached to the formatter.</summary>
1123 <param name="val">The value to write.</param>
1124 <param name="name">The name of the member.</param>
1126 <member name="M:System.Runtime.Serialization.Formatter.WriteUInt32(System.UInt32,System.String)">
1127 <summary>When overridden in a derived class, writes a 32-bit unsigned integer to the stream already attached to the formatter.</summary>
1128 <param name="val">The value to write.</param>
1129 <param name="name">The name of the member.</param>
1131 <member name="M:System.Runtime.Serialization.Formatter.WriteUInt64(System.UInt64,System.String)">
1132 <summary>When overridden in a derived class, writes a 64-bit unsigned integer to the stream already attached to the formatter.</summary>
1133 <param name="val">The value to write.</param>
1134 <param name="name">The name of the member.</param>
1136 <member name="M:System.Runtime.Serialization.Formatter.WriteValueType(System.Object,System.String,System.Type)">
1137 <summary>When overridden in a derived class, writes a value of the given type to the stream already attached to the formatter.</summary>
1138 <param name="obj">The object representing the value type.</param>
1139 <param name="name">The name of the member.</param>
1140 <param name="memberType">The <see cref="T:System.Type"></see> of the value type.</param>