mcs/class/corlib/System.Runtime.Serialization/IFormatter.cs

   1 //
   2 // System.Runtime.Serialization.IFormatter
   3 //
   4 // Author:
   5 //   David Dawkins (david@dawkins.st)
   6 //
   7 // (C) David Dawkins
   8 //
   9
  10 //
  11 // Copyright (C) 2004 Novell, Inc (http://www.novell.com)
  12 //
  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:
  20 //
  21 // The above copyright notice and this permission notice shall be
  22 // included in all copies or substantial portions of the Software.
  23 //
  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.
  31 //
  32
  33 using System.IO;
  34
  35 namespace System.Runtime.Serialization {
  36
  37         /// <summary>
  38         /// Formatting for serialized objects</summary>
  39 #if NET_2_0
  40         [System.Runtime.InteropServices.ComVisibleAttribute (true)]
  41 #endif
  42         public interface IFormatter {
  43
  44                 //
  45                 // Properties
  46                 //
  47
  48                 /// <summary>
  49                 /// Get or set the SerializationBinder used
  50                 /// for looking up types during deserialization</summary>
  51                 SerializationBinder Binder
  52                 {
  53                         get;
  54                         set;
  55                 }
  56
  57                 /// <summary>
  58                 /// Get or set the StreamingContext used for serialization
  59                 /// and deserialization</summary>
  60                 StreamingContext Context
  61                 {
  62                         get;
  63                         set;
  64                 }
  65
  66                 /// <summary>
  67                 /// Get or set the SurrogateSelector used by the current
  68                 /// formatter</summary>
  69                 ISurrogateSelector SurrogateSelector
  70                 {
  71                         get;
  72                         set;
  73                 }
  74
  75                 /// <summary>
  76                 /// Deserialize data from the specified stream, rebuilding
  77                 /// the object hierarchy</summary>
  78                 object Deserialize(
  79                         Stream serializationStream
  80                 );
  81
  82                 /// <summary>
  83                 /// Serialize the specified object to the specified stream.
  84                 /// Object may be the root of a graph of objects to be
  85                 /// serialized</summary>
  86                 void Serialize(
  87                         Stream serializationStream,
  88                         object graph
  89                 );
  90         }
  91
  92 }