2 // System.Runtime.Serialization.ISurrogateSelector
\r
5 // David Dawkins (david@dawkins.st)
\r
11 // Copyright (C) 2004 Novell, Inc (http://www.novell.com)
13 // Permission is hereby granted, free of charge, to any person obtaining
14 // a copy of this software and associated documentation files (the
15 // "Software"), to deal in the Software without restriction, including
16 // without limitation the rights to use, copy, modify, merge, publish,
17 // distribute, sublicense, and/or sell copies of the Software, and to
18 // permit persons to whom the Software is furnished to do so, subject to
19 // the following conditions:
21 // The above copyright notice and this permission notice shall be
22 // included in all copies or substantial portions of the Software.
24 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
25 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
26 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
27 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
28 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
29 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
30 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
33 namespace System.Runtime.Serialization {
\r
36 /// Creation of serialization surrogate selectors</summary>
\r
37 public interface ISurrogateSelector {
\r
40 /// Insert specified selector into available surrogates</summary>
\r
41 void ChainSelector( ISurrogateSelector selector );
\r
44 /// Return next surrogate in the surrogate chain</summary>
\r
45 ISurrogateSelector GetNextSelector();
\r
48 /// Fetch the surrogate according the specified type, starting
\r
49 /// the search from the surrogate selector for the specified
\r
50 /// StreamingContext</summary>
\r
51 /// <param name="type">Type of the object to be serialized</param>
\r
52 /// <param name="context">Context for the serialization/deserialization</para,>
\r
53 /// <param name="selector">Upon return, contains a reference to the selector where the returned surrogate was found</param>
\r
54 /// <returns>The surrogate for the specified type and context</returns>
\r
55 ISerializationSurrogate GetSurrogate(
\r
57 StreamingContext context,
\r
58 out ISurrogateSelector selector
\r