mcs/class/System.Web/System.Web.UI/INonBindingContainer.cs

   1 //
   2 // System.Web.UI.INonBindingContainer
   3 //
   4 // Authors:
   5 //   Marek Habersack (mhabersack@novell.com)
   6 //
   7 // (C) 2008 Novell, Inc. (http://www.novell.com)
   8 //
   9
  10 //
  11 // Permission is hereby granted, free of charge, to any person obtaining
  12 // a copy of this software and associated documentation files (the
  13 // "Software"), to deal in the Software without restriction, including
  14 // without limitation the rights to use, copy, modify, merge, publish,
  15 // distribute, sublicense, and/or sell copies of the Software, and to
  16 // permit persons to whom the Software is furnished to do so, subject to
  17 // the following conditions:
  18 //
  19 // The above copyright notice and this permission notice shall be
  20 // included in all copies or substantial portions of the Software.
  21 //
  22 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  23 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  24 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  25 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  26 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  27 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  28 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  29 //
  30 namespace System.Web.UI
  31 {
  32         // Apparently this attribute is used in place of our BINDING_CONTAINER control mask bit,
  33         // which makes sense as in certain scenarios (e.g. TemplateControlAttribute naming a
  34         // container type which cannot be used for two-way binding) the check must be made on type,
  35         // not on object.
  36         //
  37         // This interface is briefly mentioned in:
  38         //  http://www.developmentnow.com/g/10_2006_6_0_0_776419/DataBinding-to-SubProperties.htm
  39         //
  40         // For a sample of why this is needed, see:
  41         //
  42         //  http://msdn.microsoft.com/en-us/library/system.web.ui.webcontrols.templatepagerfield.pagertemplate.aspx
  43         //  The C# code on the above page won't work without this interface being implemented and
  44         //  used in ControlBuilder.BindingContainerType. The reason why the sample wouldn't work is
  45         //  that the TemplatePagerField.PagerTemplate property carries a custom TemplateContainer
  46         //  (typeof (DataPagerFieldItem)) attribute and, without INonBindingContainer interface
  47         //  attached to DataPagerFieldItem, mono would generate code with the Container and
  48         //  BindingContainer referring to DataPagerFieldItem. In such case, attempting to access
  49         //  DataPager properties would obviously fail. Looking at the MS.NET generated code,
  50         //  Container and BindingContainer are of the DataPager type in this instance.
  51         //
  52         internal interface INonBindingContainer
  53         {
  54         }
  55 }