Port SAP B1 ExtraProperties hook for stringized DateTime literals

Re-apply the GeneXus extension that lets consumers opt into wrapping
DateTime URI literals in single quotes (required by some SAP B1 services
that do not accept proper OData datetime syntax).

- ODataClientSettings: add a Properties bag and a static ExtraProperties
  helper exposing the STRINGIZE_DATETIME_VALUES key. The session-cloning
  constructor copies Properties.
- ODataExpression.Format.cs: when formatting a DateTime value, consult
  Settings.Properties for the opt-in flag and wrap the literal in single
  quotes when enabled.

Original commit: dc14c7f 'add support for Extra Properties on
ODataClientSettings'.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: claudiamurialdo

src/GXOdata.Client.All/GXOData.Client.All.xml

@@ -267,7 +267,15 @@ private string FormatValue(ExpressionContext context)
 		}
 		else
 		{
-			return context.Session.Adapter.GetCommandFormatter().ConvertValueToUriLiteral(Value, false);
+			var uriLiteral = context.Session.Adapter.GetCommandFormatter().ConvertValueToUriLiteral(Value, false);
+			// SAP B1 services do not accept proper OData datetime literals but do accept
+			// single-quoted ones. Consumers opt in via ODataClientSettings.Properties.
+			if (Value is DateTime &&
+				(context.Session.Settings.Properties?[ODataClientSettings.ExtraProperties.STRINGIZE_DATETIME_VALUES] as bool? == true))
+			{
+				return $"'{uriLiteral}'";
+			}
+			return uriLiteral;
 		}
 	}
 

src/Simple.OData.Client.Core/Expressions/ODataExpression.Format.cs

@@ -241,6 +241,12 @@ public INameMatchResolver NameMatchResolver
 	/// </value>
 	public ODataUpdateMethod PreferredUpdateMethod { get; set; }
 
+	/// <summary>
+	/// Gets or sets a bag of extra properties used to opt into provider-specific behaviors
+	/// (e.g. <see cref="ExtraProperties.STRINGIZE_DATETIME_VALUES"/> for SAP B1 services).
+	/// </summary>
+	public Dictionary<string, object>? Properties { get; set; }
+
 	/// <summary>
 	/// Gets or sets the value that indicates either to read untyped properties as strings.
 	/// </summary>
@@ -423,6 +429,7 @@ internal ODataClientSettings(ISession session)
 		OnTrace = session.Settings.OnTrace;
 		PayloadFormat = session.Settings.PayloadFormat;
 		PreferredUpdateMethod = session.Settings.PreferredUpdateMethod;
+		Properties = session.Settings.Properties is null ? null : new Dictionary<string, object>(session.Settings.Properties);
 		ReadUntypedAsString = session.Settings.ReadUntypedAsString;
 		RenewHttpConnection = session.Settings.RenewHttpConnection;
 		RequestExecutor = session.Settings.RequestExecutor;
@@ -435,4 +442,17 @@ internal ODataClientSettings(ISession session)
 
 	#endregion
 
+	/// <summary>
+	/// Keys for the <see cref="ODataClientSettings.Properties"/> bag, used to opt into
+	/// provider-specific behaviors.
+	/// </summary>
+	public static class ExtraProperties
+	{
+		/// <summary>
+		/// When set to a truthy value, the client renders DateTime literals as single-quoted
+		/// strings instead of the standard OData datetime syntax (required by some SAP B1
+		/// services that do not accept proper datetimes).
+		/// </summary>
+		public const string STRINGIZE_DATETIME_VALUES = "StringizeDatetimeValues";
+	}
 }