// // System.Data.Odbc.OdbcCommand // // Authors: // Brian Ritchie (brianlritchie@hotmail.com) // // Copyright (C) Brian Ritchie, 2002 // // // 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.ComponentModel; using System.Data; using System.Data.Common; using System.Collections; using System.Runtime.InteropServices; namespace System.Data.Odbc { /// /// Represents an SQL statement or stored procedure to execute against a data source. /// [DesignerAttribute ("Microsoft.VSDesigner.Data.VS.OdbcCommandDesigner, "+ Consts.AssemblyMicrosoft_VSDesigner, "System.ComponentModel.Design.IDesigner")] [ToolboxItemAttribute ("System.Drawing.Design.ToolboxItem, "+ Consts.AssemblySystem_Drawing)] public sealed class OdbcCommand : Component, ICloneable, IDbCommand { #region Fields string commandText; int timeout; CommandType commandType; OdbcConnection connection; OdbcParameterCollection parameters; OdbcTransaction transaction; bool designTimeVisible; bool prepared=false; OdbcDataReader dataReader; IntPtr hstmt; #endregion // Fields #region Constructors public OdbcCommand () { commandText = String.Empty; timeout = 30; // default timeout commandType = CommandType.Text; connection = null; parameters = new OdbcParameterCollection (); transaction = null; designTimeVisible = false; dataReader = null; } public OdbcCommand (string cmdText) : this () { CommandText = cmdText; } public OdbcCommand (string cmdText, OdbcConnection connection) : this (cmdText) { Connection = connection; } public OdbcCommand (string cmdText, OdbcConnection connection, OdbcTransaction transaction) : this (cmdText, connection) { this.transaction = transaction; } #endregion // Constructors #region Properties internal IntPtr hStmt { get { return hstmt; } } [OdbcCategory ("Data")] [DefaultValue ("")] [OdbcDescriptionAttribute ("Command text to execute")] [EditorAttribute ("Microsoft.VSDesigner.Data.Odbc.Design.OdbcCommandTextEditor, "+ Consts.AssemblyMicrosoft_VSDesigner, "System.Drawing.Design.UITypeEditor, "+ Consts.AssemblySystem_Drawing )] [RefreshPropertiesAttribute (RefreshProperties.All)] public string CommandText { get { return commandText; } set { prepared=false; commandText = value; } } [OdbcDescriptionAttribute ("Time to wait for command to execute")] [DefaultValue (30)] public int CommandTimeout { get { return timeout; } set { timeout = value; } } [OdbcCategory ("Data")] [DefaultValue ("Text")] [OdbcDescriptionAttribute ("How to interpret the CommandText")] [RefreshPropertiesAttribute (RefreshProperties.All)] public CommandType CommandType { get { return commandType; } set { commandType = value; } } [OdbcCategory ("Behavior")] [OdbcDescriptionAttribute ("Connection used by the command")] [DefaultValue (null)] [EditorAttribute ("Microsoft.VSDesigner.Data.Design.DbConnectionEditor, "+ Consts.AssemblyMicrosoft_VSDesigner, "System.Drawing.Design.UITypeEditor, "+ Consts.AssemblySystem_Drawing )] public OdbcConnection Connection { get { return connection; } set { connection = value; } } [BrowsableAttribute (false)] [DesignOnlyAttribute (true)] [DefaultValue (true)] public bool DesignTimeVisible { get { return designTimeVisible; } set { designTimeVisible = value; } } [OdbcCategory ("Data")] [OdbcDescriptionAttribute ("The parameters collection")] [DesignerSerializationVisibilityAttribute (DesignerSerializationVisibility.Content)] public OdbcParameterCollection Parameters { get { return parameters; } } [BrowsableAttribute (false)] [OdbcDescriptionAttribute ("The transaction used by the command")] [DesignerSerializationVisibilityAttribute (DesignerSerializationVisibility.Hidden)] public OdbcTransaction Transaction { get { return transaction; } set { transaction = value; } } [OdbcCategory ("Behavior")] [DefaultValue (UpdateRowSource.Both)] [OdbcDescriptionAttribute ("When used by a DataAdapter.Update, how command results are applied to the current DataRow")] public UpdateRowSource UpdatedRowSource { [MonoTODO] get { throw new NotImplementedException (); } [MonoTODO] set { throw new NotImplementedException (); } } IDbConnection IDbCommand.Connection { get { return Connection; } set { Connection = (OdbcConnection) value; } } IDataParameterCollection IDbCommand.Parameters { get { return Parameters; } } IDbTransaction IDbCommand.Transaction { get { return (IDbTransaction) Transaction; } set { if (value is OdbcTransaction) { Transaction = (OdbcTransaction)value; } else { throw new ArgumentException (); } } } #endregion // Properties #region Methods public void Cancel () { if (hstmt!=IntPtr.Zero) { OdbcReturn Ret=libodbc.SQLCancel(hstmt); if ((Ret!=OdbcReturn.Success) && (Ret!=OdbcReturn.SuccessWithInfo)) throw new OdbcException(new OdbcError("SQLCancel",OdbcHandleType.Stmt,hstmt)); } else throw new InvalidOperationException(); } public OdbcParameter CreateParameter () { return new OdbcParameter (); } IDbDataParameter IDbCommand.CreateParameter () { return CreateParameter (); } [MonoTODO] protected override void Dispose (bool disposing) { } private void ExecSQL(string sql) { OdbcReturn ret; if ((parameters.Count>0) && !prepared) Prepare(); if (prepared) { ret=libodbc.SQLExecute(hstmt); if ((ret!=OdbcReturn.Success) && (ret!=OdbcReturn.SuccessWithInfo)) throw new OdbcException(new OdbcError("SQLExecute",OdbcHandleType.Stmt,hstmt)); } else { ret=libodbc.SQLAllocHandle(OdbcHandleType.Stmt, Connection.hDbc, ref hstmt); if ((ret!=OdbcReturn.Success) && (ret!=OdbcReturn.SuccessWithInfo)) throw new OdbcException(new OdbcError("SQLAllocHandle",OdbcHandleType.Dbc,Connection.hDbc)); ret=libodbc.SQLExecDirect(hstmt, sql, sql.Length); if ((ret!=OdbcReturn.Success) && (ret!=OdbcReturn.SuccessWithInfo)) throw new OdbcException(new OdbcError("SQLExecDirect",OdbcHandleType.Stmt,hstmt)); } } public int ExecuteNonQuery () { if (connection == null) throw new InvalidOperationException (); if (connection.State == ConnectionState.Closed) throw new InvalidOperationException (); // FIXME: a third check is mentioned in .NET docs ExecSQL(CommandText); // if (!prepared) // libodbc.SQLFreeHandle( (ushort) OdbcHandleType.Stmt, hstmt); return 0; } public void Prepare() { OdbcReturn ret=libodbc.SQLAllocHandle(OdbcHandleType.Stmt, Connection.hDbc, ref hstmt); if ((ret!=OdbcReturn.Success) && (ret!=OdbcReturn.SuccessWithInfo)) throw new OdbcException(new OdbcError("SQLAllocHandle",OdbcHandleType.Dbc,Connection.hDbc)); ret=libodbc.SQLPrepare(hstmt, CommandText, CommandText.Length); if ((ret!=OdbcReturn.Success) && (ret!=OdbcReturn.SuccessWithInfo)) throw new OdbcException(new OdbcError("SQLPrepare",OdbcHandleType.Stmt,hstmt)); int i=1; foreach (OdbcParameter p in parameters) { p.Bind(hstmt, i); i++; } prepared=true; } public OdbcDataReader ExecuteReader () { return ExecuteReader (CommandBehavior.Default); } IDataReader IDbCommand.ExecuteReader () { return ExecuteReader (); } public OdbcDataReader ExecuteReader (CommandBehavior behavior) { ExecuteNonQuery(); dataReader=new OdbcDataReader(this,behavior); return dataReader; } IDataReader IDbCommand.ExecuteReader (CommandBehavior behavior) { return ExecuteReader (behavior); } public object ExecuteScalar () { object val = null; OdbcDataReader reader=ExecuteReader(); try { if (reader.Read ()) val=reader[0]; } finally { reader.Close(); } return val; } [MonoTODO] object ICloneable.Clone () { throw new NotImplementedException (); } public void ResetCommandTimeout () { timeout = 30; } #endregion } }