Files
mono/mcs/class/System.Data/System.Data.SqlClient/SqlCommand.cs
T
Tim Coleman db177b4a47 2002-11-26 Tim Coleman <[email protected]>
* System.Data.SqlClient/SqlCommand.cs:
        * System.Data.SqlClient/SqlConnection.cs:
        * System.Data.SqlClient/SqlDataReader.cs:
        * System.Data.SqlClient/SqlParameter.cs:
        * System.Data.SqlClient/SqlParameterCollection.cs:
        * System.Data.SqlClient/SqlTransaction.cs:
                Many changes around restructuring of parameter
                information so that the Sybase provider supports
                PREPAREs too.

svn path=/trunk/mcs/; revision=9193
2002-11-26 06:33:28 +00:00

424 lines
12 KiB
C#

//
// System.Data.SqlClient.SqlCommand.cs
//
// Author:
// Rodrigo Moya ([email protected])
// Daniel Morgan ([email protected])
// Tim Coleman ([email protected])
//
// (C) Ximian, Inc 2002 http://www.ximian.com/
// (C) Daniel Morgan, 2002
// Copyright (C) Tim Coleman, 2002
//
using Mono.Data.Tds;
using Mono.Data.Tds.Protocol;
using System;
using System.Collections;
using System.Collections.Specialized;
using System.ComponentModel;
using System.Data;
using System.Data.Common;
using System.Runtime.InteropServices;
using System.Text;
using System.Xml;
namespace System.Data.SqlClient {
public sealed class SqlCommand : Component, IDbCommand, ICloneable
{
#region Fields
bool disposed = false;
int commandTimeout;
bool designTimeVisible;
string commandText;
CommandType commandType;
SqlConnection connection;
SqlTransaction transaction;
UpdateRowSource updatedRowSource;
CommandBehavior behavior = CommandBehavior.Default;
SqlParameterCollection parameters;
string preparedStatement = null;
#endregion // Fields
#region Constructors
public SqlCommand()
: this (String.Empty, null, null)
{
}
public SqlCommand (string commandText)
: this (commandText, null, null)
{
commandText = commandText;
}
public SqlCommand (string commandText, SqlConnection connection)
: this (commandText, connection, null)
{
Connection = connection;
}
public SqlCommand (string commandText, SqlConnection connection, SqlTransaction transaction)
{
this.commandText = commandText;
this.connection = connection;
this.transaction = transaction;
this.commandType = CommandType.Text;
this.updatedRowSource = UpdateRowSource.Both;
this.designTimeVisible = false;
this.commandTimeout = 30;
parameters = new SqlParameterCollection (this);
}
#endregion // Constructors
#region Properties
internal CommandBehavior CommandBehavior {
get { return behavior; }
}
[DataCategory ("Data")]
[DataSysDescription ("Command text to execute.")]
[DefaultValue ("")]
[RefreshProperties (RefreshProperties.All)]
public string CommandText {
get { return commandText; }
set {
if (value != commandText && preparedStatement != null)
Unprepare ();
commandText = value;
}
}
[DataSysDescription ("Time to wait for command to execute.")]
[DefaultValue (30)]
public int CommandTimeout {
get { return commandTimeout; }
set {
if (commandTimeout < 0)
throw new ArgumentException ("The property value assigned is less than 0.");
commandTimeout = value;
}
}
[DataCategory ("Data")]
[DataSysDescription ("How to interpret the CommandText.")]
[DefaultValue (CommandType.Text)]
[RefreshProperties (RefreshProperties.All)]
public CommandType CommandType {
get { return commandType; }
set {
if (value == CommandType.TableDirect)
throw new ArgumentException ("CommandType.TableDirect is not supported by the Mono SqlClient Data Provider.");
commandType = value;
}
}
[DataCategory ("Behavior")]
[DefaultValue (null)]
[DataSysDescription ("Connection used by the command.")]
public SqlConnection Connection {
get { return connection; }
set {
if (transaction != null && connection.Transaction != null && connection.Transaction.IsOpen)
throw new InvalidOperationException ("The Connection property was changed while a transaction was in progress.");
transaction = null;
connection = value;
}
}
[Browsable (false)]
[DefaultValue (true)]
[DesignOnly (true)]
public bool DesignTimeVisible {
get { return designTimeVisible; }
set { designTimeVisible = value; }
}
[DataCategory ("Data")]
[DataSysDescription ("The parameters collection.")]
[DesignerSerializationVisibility (DesignerSerializationVisibility.Content)]
public SqlParameterCollection Parameters {
get { return parameters; }
}
internal ITds Tds {
get { return Connection.Tds; }
}
IDbConnection IDbCommand.Connection {
get { return Connection; }
set {
if (!(value is SqlConnection))
throw new InvalidCastException ("The value was not a valid SqlConnection.");
Connection = (SqlConnection) value;
}
}
IDataParameterCollection IDbCommand.Parameters {
get { return Parameters; }
}
IDbTransaction IDbCommand.Transaction {
get { return Transaction; }
set {
if (!(value is SqlTransaction))
throw new ArgumentException ();
Transaction = (SqlTransaction) value;
}
}
[Browsable (false)]
[DataSysDescription ("The transaction used by the command.")]
[DesignerSerializationVisibility (DesignerSerializationVisibility.Hidden)]
public SqlTransaction Transaction {
get { return transaction; }
set { transaction = value; }
}
[DataCategory ("Behavior")]
[DataSysDescription ("When used by a DataAdapter.Update, how command results are applied to the current DataRow.")]
[DefaultValue (UpdateRowSource.Both)]
public UpdateRowSource UpdatedRowSource {
get { return updatedRowSource; }
set { updatedRowSource = value; }
}
#endregion // Fields
#region Methods
public void Cancel ()
{
if (Connection == null || Connection.Tds == null)
return;
Connection.Tds.Cancel ();
}
internal void CloseDataReader (bool moreResults)
{
GetOutputParameters ();
Connection.DataReader = null;
if ((behavior & CommandBehavior.CloseConnection) != 0)
Connection.Close ();
}
public SqlParameter CreateParameter ()
{
return new SqlParameter ();
}
internal void DeriveParameters ()
{
if (commandType != CommandType.StoredProcedure)
throw new InvalidOperationException (String.Format ("SqlCommand DeriveParameters only supports CommandType.StoredProcedure, not CommandType.{0}", commandType));
ValidateCommand ("DeriveParameters");
SqlParameterCollection localParameters = new SqlParameterCollection (this);
localParameters.Add ("@P1", SqlDbType.NVarChar, commandText.Length).Value = commandText;
string sql = "sp_procedure_params_rowset";
Connection.Tds.ExecProc (sql, localParameters.MetaParameters, 0, true);
SqlDataReader reader = new SqlDataReader (this);
parameters.Clear ();
object[] dbValues = new object[reader.FieldCount];
while (reader.Read ()) {
reader.GetValues (dbValues);
parameters.Add (new SqlParameter (dbValues));
}
reader.Close ();
}
private void Execute (CommandBehavior behavior, bool wantResults)
{
TdsMetaParameterCollection parms = Parameters.MetaParameters;
if (preparedStatement == null) {
bool schemaOnly = ((CommandBehavior & CommandBehavior.SchemaOnly) > 0);
bool keyInfo = ((CommandBehavior & CommandBehavior.SchemaOnly) > 0);
StringBuilder sql1 = new StringBuilder ();
StringBuilder sql2 = new StringBuilder ();
if (schemaOnly || keyInfo)
sql1.Append ("SET FMTONLY OFF;");
if (keyInfo) {
sql1.Append ("SET NO_BROWSETABLE ON;");
sql2.Append ("SET NO_BROWSETABLE OFF;");
}
if (schemaOnly) {
sql1.Append ("SET FMTONLY ON;");
sql2.Append ("SET FMTONLY OFF;");
}
switch (CommandType) {
case CommandType.StoredProcedure:
if (keyInfo || schemaOnly)
Connection.Tds.Execute (sql1.ToString ());
Connection.Tds.ExecProc (CommandText, parms, CommandTimeout, wantResults);
if (keyInfo || schemaOnly)
Connection.Tds.Execute (sql2.ToString ());
break;
case CommandType.Text:
string sql = String.Format ("{0}{1}{2}", sql1.ToString (), CommandText, sql2.ToString ());
Connection.Tds.Execute (sql, parms, CommandTimeout, wantResults);
break;
}
}
else
Connection.Tds.ExecPrepared (preparedStatement, parms, CommandTimeout, wantResults);
}
public int ExecuteNonQuery ()
{
ValidateCommand ("ExecuteNonQuery");
int result = 0;
try {
Execute (CommandBehavior.Default, false);
}
catch (TdsTimeoutException e) {
throw SqlException.FromTdsInternalException ((TdsInternalException) e);
}
GetOutputParameters ();
return result;
}
public SqlDataReader ExecuteReader ()
{
return ExecuteReader (CommandBehavior.Default);
}
public SqlDataReader ExecuteReader (CommandBehavior behavior)
{
ValidateCommand ("ExecuteReader");
try {
Execute (behavior, true);
}
catch (TdsTimeoutException e) {
throw SqlException.FromTdsInternalException ((TdsInternalException) e);
}
Connection.DataReader = new SqlDataReader (this);
return Connection.DataReader;
}
public object ExecuteScalar ()
{
ValidateCommand ("ExecuteScalar");
try {
Execute (CommandBehavior.Default, true);
}
catch (TdsTimeoutException e) {
throw SqlException.FromTdsInternalException ((TdsInternalException) e);
}
if (!Connection.Tds.NextResult () || !Connection.Tds.NextRow ())
return null;
object result = Connection.Tds.ColumnValues [0];
CloseDataReader (true);
return result;
}
public XmlReader ExecuteXmlReader ()
{
ValidateCommand ("ExecuteXmlReader");
try {
Execute (CommandBehavior.Default, true);
}
catch (TdsTimeoutException e) {
throw SqlException.FromTdsInternalException ((TdsInternalException) e);
}
SqlDataReader dataReader = new SqlDataReader (this);
SqlXmlTextReader textReader = new SqlXmlTextReader (dataReader);
XmlReader xmlReader = new XmlTextReader (textReader);
return xmlReader;
}
private void GetOutputParameters ()
{
Connection.Tds.SkipToEnd ();
IList list = Connection.Tds.ColumnValues;
if (list != null && list.Count > 0) {
int index = 0;
foreach (SqlParameter parameter in parameters) {
if (parameter.Direction != ParameterDirection.Input) {
parameter.Value = list [index];
index += 1;
}
if (index >= list.Count)
break;
}
}
}
object ICloneable.Clone ()
{
return new SqlCommand (commandText, Connection);
}
IDbDataParameter IDbCommand.CreateParameter ()
{
return CreateParameter ();
}
IDataReader IDbCommand.ExecuteReader ()
{
return ExecuteReader ();
}
IDataReader IDbCommand.ExecuteReader (CommandBehavior behavior)
{
return ExecuteReader (behavior);
}
public void Prepare ()
{
ValidateCommand ("Prepare");
if (CommandType == CommandType.Text)
preparedStatement = Connection.Tds.Prepare (CommandText, Parameters.MetaParameters);
}
public void ResetCommandTimeout ()
{
commandTimeout = 30;
}
private void Unprepare ()
{
Connection.Tds.Unprepare (preparedStatement);
preparedStatement = null;
}
private void ValidateCommand (string method)
{
if (Connection == null)
throw new InvalidOperationException (String.Format ("{0} requires a Connection object to continue.", method));
if (Connection.Transaction != null && transaction != Connection.Transaction)
throw new InvalidOperationException ("The Connection object does not have the same transaction as the command object.");
if (Connection.State != ConnectionState.Open)
throw new InvalidOperationException (String.Format ("ExecuteNonQuery requires an open Connection object to continue. This connection is closed.", method));
if (commandText == String.Empty || commandText == null)
throw new InvalidOperationException ("The command text for this Command has not been set.");
if (Connection.DataReader != null)
throw new InvalidOperationException ("There is already an open DataReader associated with this Connection which must be closed first.");
if (Connection.XmlReader != null)
throw new InvalidOperationException ("There is already an open XmlReader associated with this Connection which must be closed first.");
}
#endregion // Methods
}
}