#if MYSQL_6_10 // Copyright ?2004, 2016 Oracle and/or its affiliates. All rights reserved. // // MySQL Connector/NET is licensed under the terms of the GPLv2 // , like most // MySQL Connectors. There are special exceptions to the terms and // conditions of the GPLv2 as it is applied to this software, see the // FLOSS License Exception // . // // This program is free software; you can redistribute it and/or modify // it under the terms of the GNU General Public License as published // by the Free Software Foundation; version 2 of the License. // // This program is distributed in the hope that it will be useful, but // WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY // or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License // for more details. // // You should have received a copy of the GNU General Public License along // with this program; if not, write to the Free Software Foundation, Inc., // 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA using System; using System.Data.Common; using System.Collections.Generic; using System.Collections; namespace Externals.MySql.Data.MySqlClient { /// /// Represents a collection of parameters relevant to a as well as their respective mappings to columns in a . This class cannot be inherited. /// internal sealed partial class MySqlParameterCollection : DbParameterCollection { readonly List _items = new List(); private readonly Dictionary _indexHashCs; private readonly Dictionary _indexHashCi; //turns to true if any parameter is unnamed internal bool containsUnnamedParameters; internal MySqlParameterCollection(MySqlCommand cmd) { _indexHashCs = new Dictionary(); _indexHashCi = new Dictionary(StringComparer.CurrentCultureIgnoreCase); containsUnnamedParameters = false; Clear(); } /// /// Gets the number of MySqlParameter objects in the collection. /// public override int Count => _items.Count; #region Public Methods /// /// Gets the at the specified index. /// /// Gets the with a specified attribute. /// [C#] In C#, this property is the indexer for the class. /// public new MySqlParameter this[int index] { get { return InternalGetParameter(index); } set { InternalSetParameter(index, value); } } /// /// Gets the with the specified name. /// public new MySqlParameter this[string name] { get { return InternalGetParameter(name); } set { InternalSetParameter(name, value); } } /// /// Adds a to the with the parameter name, the data type, the column length, and the source column name. /// /// The name of the parameter. /// One of the values. /// The length of the column. /// The name of the source column. /// The newly added object. public MySqlParameter Add(string parameterName, MySqlDbType dbType, int size, string sourceColumn) { return Add(new MySqlParameter(parameterName, dbType, size, sourceColumn)); } /// /// Adds the specified object to the . /// /// The to add to the collection. /// The newly added object. public MySqlParameter Add(MySqlParameter value) { return InternalAdd(value, -1); } /// /// Adds a to the given the specified parameter name and value. /// /// The name of the parameter. /// The of the to add to the collection. /// The newly added object. [Obsolete("Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value)")] public MySqlParameter Add(string parameterName, object value) { return Add(new MySqlParameter(parameterName, value)); } /// /// Adds a parameter and its value. /// /// The name of the parameter. /// The value of the parameter. /// A object representing the provided values. public MySqlParameter AddWithValue(string parameterName, object value) { return Add(new MySqlParameter(parameterName, value)); } /// /// Adds a to the given the parameter name and the data type. /// /// The name of the parameter. /// One of the values. /// The newly added object. public MySqlParameter Add(string parameterName, MySqlDbType dbType) { return Add(new MySqlParameter(parameterName, dbType)); } /// /// Adds a to the with the parameter name, the data type, and the column length. /// /// The name of the parameter. /// One of the values. /// The length of the column. /// The newly added object. public MySqlParameter Add(string parameterName, MySqlDbType dbType, int size) { return Add(new MySqlParameter(parameterName, dbType, size)); } #endregion /// /// Removes all items from the collection. /// public override void Clear() { foreach (MySqlParameter p in _items) p.Collection = null; _items.Clear(); _indexHashCs.Clear(); _indexHashCi.Clear(); } void CheckIndex(int index) { if (index < 0 || index >= Count) throw new IndexOutOfRangeException("Parameter index is out of range."); } private MySqlParameter InternalGetParameter(int index) { CheckIndex(index); return _items[index]; } private MySqlParameter InternalGetParameter(string parameterName) { int index = IndexOf(parameterName); if (index < 0) { // check to see if the user has added the parameter without a // parameter marker. If so, kindly tell them what they did. if (parameterName.StartsWith("@", StringComparison.Ordinal) || parameterName.StartsWith("?", StringComparison.Ordinal)) { string newParameterName = parameterName.Substring(1); index = IndexOf(newParameterName); if (index != -1) return _items[index]; } throw new ArgumentException("Parameter '" + parameterName + "' not found in the collection."); } return _items[index]; } private void InternalSetParameter(string parameterName, MySqlParameter value) { int index = IndexOf(parameterName); if (index < 0) throw new ArgumentException("Parameter '" + parameterName + "' not found in the collection."); InternalSetParameter(index, value); } private void InternalSetParameter(int index, MySqlParameter value) { MySqlParameter newParameter = value; if (newParameter == null) throw new ArgumentException(Resources.NewValueShouldBeMySqlParameter); CheckIndex(index); MySqlParameter p = _items[index]; // first we remove the old parameter from our hashes _indexHashCs.Remove(p.ParameterName); _indexHashCi.Remove(p.ParameterName); // then we add in the new parameter _items[index] = newParameter; _indexHashCs.Add(value.ParameterName, index); _indexHashCi.Add(value.ParameterName, index); } /// /// Gets the location of the in the collection with a specific parameter name. /// /// The name of the object to retrieve. /// The zero-based location of the in the collection. public override int IndexOf(string parameterName) { int i = -1; if (!_indexHashCs.TryGetValue(parameterName, out i) && !_indexHashCi.TryGetValue(parameterName, out i)) return -1; return i; } /// /// Gets the location of a in the collection. /// /// The object to locate. /// The zero-based location of the in the collection. /// Gets the location of a in the collection. public override int IndexOf(object value) { MySqlParameter parameter = value as MySqlParameter; if (null == parameter) throw new ArgumentException("Argument must be of type DbParameter", "value"); return _items.IndexOf(parameter); } internal void ParameterNameChanged(MySqlParameter p, string oldName, string newName) { int index = IndexOf(oldName); _indexHashCs.Remove(oldName); _indexHashCi.Remove(oldName); _indexHashCs.Add(newName, index); _indexHashCi.Add(newName, index); } private MySqlParameter InternalAdd(MySqlParameter value, int index) { if (value == null) throw new ArgumentException("The MySqlParameterCollection only accepts non-null MySqlParameter type objects.", "value"); // if the parameter is unnamed, then assign a default name if (String.IsNullOrEmpty(value.ParameterName)) value.ParameterName = String.Format("Parameter{0}", GetNextIndex()); // make sure we don't already have a parameter with this name if (IndexOf(value.ParameterName) >= 0) { throw new MySqlException( String.Format(Resources.ParameterAlreadyDefined, value.ParameterName)); } else { string inComingName = value.ParameterName; if (inComingName[0] == '@' || inComingName[0] == '?') inComingName = inComingName.Substring(1, inComingName.Length - 1); if (IndexOf(inComingName) >= 0) throw new MySqlException( String.Format(Resources.ParameterAlreadyDefined, value.ParameterName)); } if (index == -1) { _items.Add(value); index = _items.Count - 1; } else { _items.Insert(index, value); AdjustHashes(index, true); } _indexHashCs.Add(value.ParameterName, index); _indexHashCi.Add(value.ParameterName, index); value.Collection = this; return value; } private int GetNextIndex() { int index = Count + 1; while (true) { string name = "Parameter" + index.ToString(); if (!_indexHashCi.ContainsKey(name)) break; index++; } return index; } private static void AdjustHash(Dictionary hash, string parameterName, int keyIndex, bool addEntry) { if (!hash.ContainsKey(parameterName)) return; int index = hash[parameterName]; if (index < keyIndex) return; hash[parameterName] = addEntry ? ++index : --index; } /// /// This method will update all the items in the index hashes when /// we insert a parameter somewhere in the middle /// /// /// private void AdjustHashes(int keyIndex, bool addEntry) { for (int i = 0; i < Count; i++) { string name = _items[i].ParameterName; AdjustHash(_indexHashCi, name, keyIndex, addEntry); AdjustHash(_indexHashCs, name, keyIndex, addEntry); } } private MySqlParameter GetParameterFlexibleInternal(string baseName) { int index = IndexOf(baseName); if (-1 == index) index = IndexOf("?" + baseName); if (-1 == index) index = IndexOf("@" + baseName); if (-1 != index) return this[index]; return null; } internal MySqlParameter GetParameterFlexible(string parameterName, bool throwOnNotFound) { string baseName = parameterName; MySqlParameter p = GetParameterFlexibleInternal(baseName); if (p != null) return p; if (parameterName.StartsWith("@", StringComparison.Ordinal) || parameterName.StartsWith("?", StringComparison.Ordinal)) baseName = parameterName.Substring(1); p = GetParameterFlexibleInternal(baseName); if (p != null) return p; if (throwOnNotFound) throw new ArgumentException("Parameter '" + parameterName + "' not found in the collection."); return null; } #region DbParameterCollection Implementation /// /// Adds an array of values to the end of the . /// /// public override void AddRange(Array values) { foreach (DbParameter p in values) Add(p); } /// /// Retrieve the parameter with the given name. /// /// /// protected override DbParameter GetParameter(string parameterName) { return InternalGetParameter(parameterName); } protected override DbParameter GetParameter(int index) { return InternalGetParameter(index); } protected override void SetParameter(string parameterName, DbParameter value) { InternalSetParameter(parameterName, value as MySqlParameter); } protected override void SetParameter(int index, DbParameter value) { InternalSetParameter(index, value as MySqlParameter); } /// /// Adds the specified object to the . /// /// The to add to the collection. /// The index of the new object. public override int Add(object value) { MySqlParameter parameter = value as MySqlParameter; if (parameter == null) throw new MySqlException("Only MySqlParameter objects may be stored"); parameter = Add(parameter); return IndexOf(parameter); } /// /// Gets a value indicating whether a with the specified parameter name exists in the collection. /// /// The name of the object to find. /// true if the collection contains the parameter; otherwise, false. public override bool Contains(string parameterName) { return IndexOf(parameterName) != -1; } /// /// Gets a value indicating whether a MySqlParameter exists in the collection. /// /// The value of the object to find. /// true if the collection contains the object; otherwise, false. /// Gets a value indicating whether a exists in the collection. public override bool Contains(object value) { MySqlParameter parameter = value as MySqlParameter; if (null == parameter) throw new ArgumentException("Argument must be of type DbParameter", nameof(value)); return _items.Contains(parameter); } /// /// Copies MySqlParameter objects from the MySqlParameterCollection to the specified array. /// /// /// public override void CopyTo(Array array, int index) { _items.ToArray().CopyTo(array, index); } /// /// Returns an enumerator that iterates through the . /// /// public override IEnumerator GetEnumerator() { return _items.GetEnumerator(); } /// /// Inserts a MySqlParameter into the collection at the specified index. /// /// /// public override void Insert(int index, object value) { MySqlParameter parameter = value as MySqlParameter; if (parameter == null) throw new MySqlException("Only MySqlParameter objects may be stored"); InternalAdd(parameter, index); } /// /// Removes the specified MySqlParameter from the collection. /// /// public override void Remove(object value) { MySqlParameter p = (value as MySqlParameter); p.Collection = null; int index = IndexOf(p); _items.Remove(p); _indexHashCs.Remove(p.ParameterName); _indexHashCi.Remove(p.ParameterName); AdjustHashes(index, false); } /// /// Removes the specified from the collection using the parameter name. /// /// The name of the object to retrieve. public override void RemoveAt(string parameterName) { DbParameter p = GetParameter(parameterName); Remove(p); } /// /// Removes the specified from the collection using a specific index. /// /// The zero-based index of the parameter. /// Removes the specified from the collection. public override void RemoveAt(int index) { object o = _items[index]; Remove(o); } /// /// Gets an object that can be used to synchronize access to the /// . /// public override object SyncRoot => (_items as IList).SyncRoot; #endregion } } #endif