Add IgnorePrepare connection string setting.

Author: bgrainger

src/MySqlConnector/Core/ConnectionSettings.cs

@@ -70,6 +70,7 @@ public ConnectionSettings(MySqlConnectionStringBuilder csb)
 			DefaultCommandTimeout = (int) csb.DefaultCommandTimeout;
 			ForceSynchronous = csb.ForceSynchronous;
 			IgnoreCommandTransaction = csb.IgnoreCommandTransaction;
+			IgnorePrepare = csb.IgnorePrepare;
 			InteractiveSession = csb.InteractiveSession;
 			GuidFormat = GetEffectiveGuidFormat(csb.GuidFormat, csb.OldGuids);
 			Keepalive = csb.Keepalive;
@@ -145,6 +146,7 @@ private static MySqlGuidFormat GetEffectiveGuidFormat(MySqlGuidFormat guidFormat
 		public bool ForceSynchronous { get; }
 		public MySqlGuidFormat GuidFormat { get; }
 		public bool IgnoreCommandTransaction { get; }
+		public bool IgnorePrepare { get; }
 		public bool InteractiveSession { get; }
 		public uint Keepalive { get; }
 		public bool PersistSecurityInfo { get; }

src/MySqlConnector/MySql.Data.MySqlClient/MySqlCommand.cs

@@ -78,11 +78,14 @@ public override void Prepare()
 				throw new InvalidOperationException("Connection must be Open; current state is {0}".FormatInvariant(Connection.State));
 			if (string.IsNullOrWhiteSpace(CommandText))
 				throw new InvalidOperationException("CommandText must be specified");
+			if (Connection.IgnorePrepare)
+				return;
 
 			// NOTE: Prepared statements in MySQL are not currently supported.
 			// 1) Only a subset of statements are actually preparable by the server: http://dev.mysql.com/worklog/task/?id=2871
 			// 2) Although CLIENT_MULTI_STATEMENTS is supposed to mean that the Server "Can handle multiple statements per COM_QUERY and COM_STMT_PREPARE" (https://dev.mysql.com/doc/internals/en/capability-flags.html#flag-CLIENT_MULTI_STATEMENTS),
 			//    this is not actually true because "Prepared statement handles are defined to work only with strings that contain a single statement" (http://dev.mysql.com/doc/refman/5.7/en/c-api-multiple-queries.html).
+			throw new NotSupportedException("Prepared commands are not supported.");
 		}
 
 		public override string CommandText

src/MySqlConnector/MySql.Data.MySqlClient/MySqlConnection.cs

@@ -352,6 +352,7 @@ internal async Task<CachedProcedure> GetCachedProcedure(IOBehavior ioBehavior, s
 		internal int DefaultCommandTimeout => GetConnectionSettings().DefaultCommandTimeout;
 		internal MySqlGuidFormat GuidFormat => m_connectionSettings.GuidFormat;
 		internal bool IgnoreCommandTransaction => m_connectionSettings.IgnoreCommandTransaction;
+		internal bool IgnorePrepare => m_connectionSettings.IgnorePrepare;
 		internal bool TreatTinyAsBoolean => m_connectionSettings.TreatTinyAsBoolean;
 		internal IOBehavior AsyncIOBehavior => GetConnectionSettings().ForceSynchronous ? IOBehavior.Synchronous : IOBehavior.Asynchronous;
 

src/MySqlConnector/MySql.Data.MySqlClient/MySqlConnectionStringBuilder.cs

@@ -207,6 +207,12 @@ public bool IgnoreCommandTransaction
 			set => MySqlConnectionStringOption.IgnoreCommandTransaction.SetValue(this, value);
 		}
 
+		public bool IgnorePrepare
+		{
+			get => MySqlConnectionStringOption.IgnorePrepare.GetValue(this);
+			set => MySqlConnectionStringOption.IgnorePrepare.SetValue(this, value);
+		}
+
 		public bool InteractiveSession
 		{
 			get => MySqlConnectionStringOption.InteractiveSession.GetValue(this);
@@ -338,6 +344,7 @@ internal abstract class MySqlConnectionStringOption
 		public static readonly MySqlConnectionStringOption<bool> ForceSynchronous;
 		public static readonly MySqlConnectionStringOption<MySqlGuidFormat> GuidFormat;
 		public static readonly MySqlConnectionStringOption<bool> IgnoreCommandTransaction;
+		public static readonly MySqlConnectionStringOption<bool> IgnorePrepare;
 		public static readonly MySqlConnectionStringOption<bool> InteractiveSession;
 		public static readonly MySqlConnectionStringOption<uint> Keepalive;
 		public static readonly MySqlConnectionStringOption<bool> OldGuids;
@@ -501,6 +508,10 @@ static MySqlConnectionStringOption()
 				keys: new[] { "IgnoreCommandTransaction", "Ignore Command Transaction" },
 				defaultValue: false));
 
+			AddOption(IgnorePrepare = new MySqlConnectionStringOption<bool>(
+				keys: new[] { "IgnorePrepare", "Ignore Prepare" },
+				defaultValue: true));
+
 			AddOption(InteractiveSession = new MySqlConnectionStringOption<bool>(
 				keys: new[] { "InteractiveSession", "Interactive", "Interactive Session" },
 				defaultValue: false));

tests/MySqlConnector.Tests/MySqlConnectionStringBuilderTests.cs

@@ -42,6 +42,7 @@ public void Defaults()
 			Assert.Null(csb.CACertificateFile);
 			Assert.Equal(MySqlLoadBalance.RoundRobin, csb.LoadBalance);
 #endif
+			Assert.True(csb.IgnorePrepare);
 			Assert.False(csb.InteractiveSession);
 			Assert.Equal(0u, csb.Keepalive);
 			Assert.Equal(100u, csb.MaximumPoolSize);
@@ -104,6 +105,7 @@ public void ParseConnectionString()
 					"load balance=random;" +
 					"guidformat=timeswapbinary16;" +
 #endif
+					"ignore prepare=false;" +
 					"interactive=true;" +
 					"Keep Alive=90;" +
 					"minpoolsize=5;" +
@@ -147,6 +149,7 @@ public void ParseConnectionString()
 			Assert.Equal(MySqlLoadBalance.Random, csb.LoadBalance);
 			Assert.Equal(MySqlGuidFormat.TimeSwapBinary16, csb.GuidFormat);
 #endif
+			Assert.False(csb.IgnorePrepare);
 			Assert.True(csb.InteractiveSession);
 			Assert.Equal(90u, csb.Keepalive);
 			Assert.Equal(15u, csb.MaximumPoolSize);