svn path=/trunk/mcs/; revision=104772
[mono.git] / mcs / class / System.Data / System.Data.Odbc / OdbcParameterCollection.cs
index 07497dadcd4c7ba8e21a31baf0abd354cfacba1b..a7fc66f7c79b01bcfb8b64c7ed55c86e5874d833 100644 (file)
 //
 // System.Data.Odbc.OdbcParameterCollection
 //
-// Author:
+// Authors:
 //   Brian Ritchie (brianlritchie@hotmail.com) 
+//   Umadevi S (sumadevi@novell.com)
+//   Amit Biswas (amit@amitbiswas.com)
 //
 // Copyright (C) Brian Ritchie, 2002
+// Copyright (C) Novell,Inc 
+//
+
+//
+// Copyright (C) 2004 Novell, Inc (http://www.novell.com)
+//
+// Permission is hereby granted, free of charge, to any person obtaining
+// a copy of this software and associated documentation files (the
+// "Software"), to deal in the Software without restriction, including
+// without limitation the rights to use, copy, modify, merge, publish,
+// distribute, sublicense, and/or sell copies of the Software, and to
+// permit persons to whom the Software is furnished to do so, subject to
+// the following conditions:
+// 
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// 
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 //
 
 using System.Collections;
+using System.ComponentModel;
 using System.Data;
 using System.Data.Common;
 
 namespace System.Data.Odbc
 {
+       [ListBindable (false)]
+       [EditorAttribute ("Microsoft.VSDesigner.Data.Design.DBParametersEditor, "+ Consts.AssemblyMicrosoft_VSDesigner, "System.Drawing.Design.UITypeEditor, "+ Consts.AssemblySystem_Drawing )]
+#if NET_2_0
+       public sealed class OdbcParameterCollection : DbParameterCollection
+#else
        public sealed class OdbcParameterCollection : MarshalByRefObject,
                IDataParameterCollection, IList, ICollection, IEnumerable
+#endif // NET_2_0
        {
                #region Fields
 
-               ArrayList list = new ArrayList ();
+               readonly ArrayList list = new ArrayList ();
+               int nullParamCount = 1;
 
                #endregion // Fields
-               
-               #region Properties
+       
+               #region Constructors
 
-               public int Count {
-                       get { return list.Count; }
+               internal OdbcParameterCollection ()
+               {
                }
 
-               public OdbcParameter this[int index] {
-                       get { return (OdbcParameter) list[index]; }
-                       set { list[index] = value; }
+               #endregion // Constructors
+       
+               #region Properties
+
+#if ONLY_1_1
+               [Browsable (false)]
+               [DesignerSerializationVisibility (DesignerSerializationVisibility.Hidden)]
+#endif
+               public
+#if NET_2_0
+               override
+#endif
+               int Count {
+                       get { return list.Count; }
                }
 
-               public OdbcParameter this[string parameterName] {
-                       [MonoTODO]
-                       get { throw new NotImplementedException (); }
-                       [MonoTODO]
-                       set { throw new NotImplementedException (); }
+               [Browsable (false)]
+               [DesignerSerializationVisibility (DesignerSerializationVisibility.Hidden)]
+               public new OdbcParameter this [int index] {
+                       get { return (OdbcParameter) list [index]; }
+                       set { list [index] = value; }
                }
 
-               int ICollection.Count {
-                       get { return list.Count; }
+               [Browsable (false)]
+               [DesignerSerializationVisibility (DesignerSerializationVisibility.Hidden)]
+               public new OdbcParameter this [string parameterName] {
+                       get {
+                               foreach (OdbcParameter p in list)
+                                       if (p.ParameterName.Equals (parameterName))
+                                               return p;
+                               throw new IndexOutOfRangeException ("The specified name does not exist: " + parameterName);
+                       }
+                       set {
+                               if (!Contains (parameterName))
+                                       throw new IndexOutOfRangeException("The specified name does not exist: " + parameterName);
+                               this [IndexOf (parameterName)] = value;
+                       }
                }
 
+#if ONLY_1_1
                bool IList.IsFixedSize {
+#else
+               public override bool IsFixedSize {
+#endif
                        get { return false; }
                }
-               
+
+#if ONLY_1_1
                bool IList.IsReadOnly {
+#else
+               public override bool IsReadOnly {
+#endif
                        get { return false; }
                }
-               
+
+#if ONLY_1_1
                bool ICollection.IsSynchronized {
+#else
+               public override bool IsSynchronized {
+#endif
                        get { return list.IsSynchronized; }
                }
 
+#if ONLY_1_1
                object ICollection.SyncRoot {
+#else
+               public override object SyncRoot {
+#endif
                        get { return list.SyncRoot; }
                }
                
-               object IList.this[int index] {
-                       get { return list[index]; }
-                       set { list[index] = value; }
+#if ONLY_1_1
+               object IList.this [int index] {
+                       get { return list [index]; }
+                       set { list [index] = value; }
                }
 
-               object IDataParameterCollection.this[string name]
+               object IDataParameterCollection.this [string index]
                {
-                       [MonoTODO]
-                       get {
-                               throw new NotImplementedException ();
-                       }
-                       [MonoTODO]
+                       get { return this [index]; }
                        set {
-                               throw new NotImplementedException ();
+                               if (!(value is OdbcParameter))
+                                       throw new InvalidCastException ("Only OdbcParameter objects can be used.");
+                               this [index] = (OdbcParameter) value;
                        }
                }
+#endif // ONLY_1_1
 
                #endregion // Properties
 
                #region Methods
 
+#if NET_2_0
+               [EditorBrowsableAttribute (EditorBrowsableState.Never)]
+#endif
+               public
+#if NET_2_0
+               override
+#endif
+               int Add (object value)
+               {
+                       if (!(value is OdbcParameter))
+                               throw new InvalidCastException ("The parameter was not an OdbcParameter.");
+                       Add ((OdbcParameter) value);
+                       return IndexOf (value);
+               }
 
-               public OdbcParameter Add (OdbcParameter parameter)
+               public OdbcParameter Add (OdbcParameter value)
                {
-                       list.Add (parameter);
-                       return parameter;
+                       if (value.Container != null)
+                               throw new ArgumentException ("The OdbcParameter specified in " +
+                                                            "the value parameter is already " +
+                                                            "added to this or another OdbcParameterCollection.");
+                       if (value.ParameterName == null || value.ParameterName.Length == 0) {
+                               value.ParameterName = "Parameter" + nullParamCount;
+                               nullParamCount++;
+                       }
+                       value.Container = this;
+                       list.Add (value);
+                       return value;
                }
 
-               public OdbcParameter Add (string name, object value)
+#if NET_2_0
+               [EditorBrowsableAttribute (EditorBrowsableState.Never)]
+               [Obsolete ("Add(String parameterName, Object value) has been deprecated.  Use AddWithValue(String parameterName, Object value).")]
+#endif
+               public OdbcParameter Add (string parameterName, object value)
                {
-                       OdbcParameter parameter = new OdbcParameter (name, value);
-                       list.Add (parameter);
-                       return parameter;
+                       return Add (new OdbcParameter (parameterName, value));
                }
 
-               public OdbcParameter Add (string name, OdbcType type)
-               {
-                       OdbcParameter parameter = new OdbcParameter (name, type);
-                       list.Add (parameter);
-                       return parameter;
+               public OdbcParameter Add (string parameterName, OdbcType odbcType)
+               {
+                       return Add (new OdbcParameter (parameterName, odbcType));
                }
 
-               public OdbcParameter Add (string name, OdbcType type, int width)
+               public OdbcParameter Add (string parameterName, OdbcType odbcType, int size)
                {
-                       OdbcParameter parameter = new OdbcParameter (name, type, width);
-                       list.Add (parameter);
-                       return parameter;
+                       return Add (new OdbcParameter (parameterName, odbcType, size));
                }
 
-               public OdbcParameter Add (string name, OdbcType type,
-                                          int width, string src_col)
+               public OdbcParameter Add (string parameterName, OdbcType odbcType,
+                                          int size, string sourceColumn)
                {
-                       OdbcParameter parameter = new OdbcParameter (name, type, width, src_col);
-                       list.Add (parameter);
-                       return parameter;
+                       return Add (new OdbcParameter (parameterName, odbcType,
+                               size, sourceColumn));
                }
 
+               public
+#if NET_2_0
+               override
+#endif
+               void Clear()
+               {
+                       foreach (OdbcParameter p in list)
+                               p.Container = null;
+                       list.Clear ();
+               }
 
-               public void Bind(IntPtr hstmt)
+               public
+#if NET_2_0
+               override
+#endif // NET_2_0
+               bool Contains (object value)
                {
-                       for (int i=0;i<Count;i++)
-                       {
-                               this[i].Bind(hstmt,i+1);
-                               
-                       }
+                       if (value == null)
+                               //should not throw ArgumentNullException
+                               return false;
+                       if (!(value is OdbcParameter))
+                               throw new InvalidCastException ("The parameter was not an OdbcParameter.");
+                       return Contains (((OdbcParameter) value).ParameterName);
                }
 
-               int IList.Add (object value)
+               public
+#if NET_2_0
+               override
+#endif // NET_2_0
+               bool Contains (string value)
                {
-                       if (!(value is IDataParameter))
-                               throw new InvalidCastException ();
+                       if (value == null || value.Length == 0)
+                               //should not throw ArgumentNullException
+                               return false;
+                       string value_upper = value.ToUpper ();
+                       foreach (OdbcParameter p in this)
+                               if (p.ParameterName.ToUpper ().Equals (value_upper))
+                                       return true;
+                       return false;
+               }
 
+               public
+#if NET_2_0
+               override
+#endif // NET_2_0
+               void CopyTo (Array array, int index)
+               {
+                       list.CopyTo (array, index);
+               }
 
-                       list.Add (value);
+               public
+#if NET_2_0
+               override
+#endif // NET_2_0
+               IEnumerator GetEnumerator()
+               {
+                       return list.GetEnumerator ();
+               }
+
+               public
+#if NET_2_0
+               override
+#endif // NET_2_0
+               int IndexOf (object value)
+               {
+                       if (value == null)
+                               return -1;
+                       if (!(value is OdbcParameter))
+                               throw new InvalidCastException ("The parameter was not an OdbcParameter.");
                        return list.IndexOf (value);
                }
 
-               void IList.Clear ()
+               public
+#if NET_2_0
+               override
+#endif // NET_2_0
+               int IndexOf (string parameterName)
                {
-                       list.Clear ();
+                       if (parameterName == null || parameterName.Length == 0)
+                               return -1;
+                       string parameterName_upper = parameterName.ToUpper ();
+                       for (int i = 0; i < Count; i += 1)
+                               if (this [i].ParameterName.ToUpper ().Equals (parameterName_upper))
+                                       return i;
+                       return -1;
                }
 
-               bool IList.Contains (object value)
+               public
+#if NET_2_0
+               override
+#endif // NET_2_0
+               void Insert (int index, object value)
                {
-                       return list.Contains (value);
+                       if (value == null)
+                               throw new ArgumentNullException ("value");
+                       if (!(value is OdbcParameter))
+                               throw new InvalidCastException ("The parameter was not an OdbcParameter.");
+                       Insert (index, (OdbcParameter) value);
                }
 
-               bool IDataParameterCollection.Contains (string value)
+               public
+#if NET_2_0
+               override
+#endif // NET_2_0
+               void Remove (object value)
                {
-                       for (int i = 0; i < list.Count; i++) {
-                               IDataParameter parameter;
+                       if (value == null)
+                               throw new ArgumentNullException ("value");
+                       if (!(value is OdbcParameter))
+                               throw new InvalidCastException ("The parameter was not an OdbcParameter.");
+                       Remove ((OdbcParameter) value);
+               }
 
-                               parameter = (IDataParameter) list[i];
-                               if (parameter.ParameterName == value)
-                                       return true;
-                       }
+               public
+#if NET_2_0
+               override
+#endif // NET_2_0
+               void RemoveAt (int index)
+               {
+                       if (index >= list.Count || index < 0)
+                               throw new IndexOutOfRangeException (String.Format ("Invalid index {0} for this OdbcParameterCollection with count = {1}", index, list.Count));
+                       this [index].Container = null;
+                       list.RemoveAt (index);
+               }
 
-                       return false;
+               public
+#if NET_2_0
+               override
+#endif // NET_2_0
+               void RemoveAt (string parameterName)
+               {
+                       RemoveAt (IndexOf (parameterName));
                }
 
-               void ICollection.CopyTo (Array array, int index)
+#if NET_2_0
+               protected override DbParameter GetParameter (string name)
                {
-                       ((OdbcParameter[])(list.ToArray ())).CopyTo (array, index);
+                       return this [name];
                }
 
-               IEnumerator IEnumerable.GetEnumerator ()
+               protected override DbParameter GetParameter (int index)
                {
-                       return list.GetEnumerator ();
+                       return this [index];
                }
-               
-               int IList.IndexOf (object value)
+
+               protected override void SetParameter (string name, DbParameter value)
                {
-                       return list.IndexOf (value);
+                       this [name] = (OdbcParameter) value;
+               }
+
+               protected override void SetParameter (int index, DbParameter value)
+               {
+                       this [index] = (OdbcParameter) value;
+               }
+
+
+               public override void AddRange (Array values)
+               {
+                       if (values == null)
+                               throw new ArgumentNullException ("values");
+                       foreach (OdbcParameter p in values)
+                               if (p == null)
+                                       throw new ArgumentNullException ("values", "The OdbcParameterCollection only accepts non-null OdbcParameter type objects");
+                       // no need to check if parameter is already contained
+                       foreach (OdbcParameter p in values)
+                               Add (p);
                }
 
-               int IDataParameterCollection.IndexOf (string name)
+               public void AddRange (OdbcParameter [] values)
                {
-                       return list.IndexOf (((IDataParameterCollection) this)[name]);
+                       AddRange ((Array) values);
                }
 
-               void IList.Insert (int index, object value)
-               {
+               public void Insert (int index, OdbcParameter value)
+               {
+                       if (index > list.Count || index < 0)
+                               throw new ArgumentOutOfRangeException ("index", "The index must be non-negative and less than or equal to size of the collection");
+                       if (value == null)
+                               throw new ArgumentNullException ("value");
+                       if (value.Container != null)
+                               throw new ArgumentException ("The OdbcParameter is already contained by another collection");
+                       if (String.IsNullOrEmpty (value.ParameterName)) {
+                               value.ParameterName = "Parameter" + nullParamCount;
+                               nullParamCount++;
+                       }
+                       value.Container = this;
                        list.Insert (index, value);
                }
 
-               void IList.Remove (object value)
+               public OdbcParameter AddWithValue (string parameterName, Object value)
+               {
+                       if (value == null)
+                               return Add (new OdbcParameter (parameterName, OdbcType.NVarChar));
+                       return Add (new OdbcParameter (parameterName, value));
+               }
+
+               public void Remove (OdbcParameter value)
                {
+                       if (value == null)
+                               throw new ArgumentNullException ("value");
+                       if (value.Container != this)
+                               throw new ArgumentException ("values", "Attempted to remove an OdbcParameter that is not contained in this OdbcParameterCollection");
+                       value.Container = null;
                        list.Remove (value);
                }
 
-               void IList.RemoveAt (int index)
+               public bool Contains (OdbcParameter value)
+               {
+                       if (value == null)
+                               //should not throw ArgumentNullException
+                               return false;
+                       if (value.Container != this)
+                               return false;
+                       return Contains (value.ParameterName);
+               }
+
+               public int IndexOf (OdbcParameter value)
                {
-                       list.Remove ((object) list[index]);
+                       if (value == null)
+                               //should not throw ArgumentNullException
+                               return -1;
+                       return IndexOf ((Object) value);
                }
 
-               void IDataParameterCollection.RemoveAt (string name)
+               public void CopyTo (OdbcParameter [] array, int index)
                {
-                       list.Remove (((IDataParameterCollection) this)[name]);
+                       list.CopyTo (array, index);
                }
+#endif
 
                #endregion // Methods
        }