Updating EntityRequest.Base.template with code fix for response headers issue (#202)

* Updating template with response headers fix.
* New changes will propagate the fix for having response headers and status codes in request objects when UpdateAsync method is called in entities
* Adding the exception documentation in IEntityRequest.Base 
- Refactoring in EntityRequest.Base to include this if includeSendParams == true so that it shows in the async UpdateAsync() method.

Author: irvinesunday

Templates/CSharp/Base/EntityRequest.Base.template.tt

@@ -350,7 +350,9 @@ public void AppendUpdateAsyncHeader(string entityName, string lowerCaseEntityNam
     {
         stringBuilder.Append(Environment.NewLine);
         stringBuilder.Append("        /// <param name=\"cancellationToken\">The <see cref=\"CancellationToken\"/> for the request.</param>");
-    }
+		stringBuilder.Append(Environment.NewLine);
+		stringBuilder.Append("		/// <exception cref=\"ClientException\">Thrown when an object returned in a response is used for updating an object in Microsoft Graph.</exception>");
+	}
 
     stringBuilder.Append(Environment.NewLine);
     stringBuilder.AppendFormat("        /// <returns>The updated {0}.</returns>", entityName);
@@ -390,6 +392,32 @@ public string GetEntityUpdateAsyncMethod(OdcmClass odcmClass, bool initializeCol
     stringBuilder.AppendFormat("        public async System.Threading.Tasks.Task<{0}> UpdateAsync({0} {1}ToUpdate, CancellationToken cancellationToken)", entityName, lowerCaseEntityName);
     stringBuilder.Append(Environment.NewLine);
     stringBuilder.Append("        {");
+	stringBuilder.Append(Environment.NewLine);
+	stringBuilder.AppendFormat("			if ({0}ToUpdate.AdditionalData != null)", lowerCaseEntityName);
+	stringBuilder.Append(Environment.NewLine);
+	stringBuilder.Append("			{");
+	stringBuilder.Append(Environment.NewLine);
+    stringBuilder.AppendFormat("				if ({0}ToUpdate.AdditionalData.ContainsKey(Constants.HttpPropertyNames.ResponseHeaders) ||", lowerCaseEntityName);       
+    stringBuilder.Append(Environment.NewLine);           
+    stringBuilder.AppendFormat("					{0}ToUpdate.AdditionalData.ContainsKey(Constants.HttpPropertyNames.StatusCode))", lowerCaseEntityName);          
+	stringBuilder.Append(Environment.NewLine);
+    stringBuilder.Append("				{");         
+	stringBuilder.Append(Environment.NewLine);
+    stringBuilder.Append("					throw new ClientException(");                
+	stringBuilder.Append(Environment.NewLine);
+    stringBuilder.Append("						new Error");                  
+	stringBuilder.Append(Environment.NewLine);
+    stringBuilder.Append("						{");                    
+	stringBuilder.Append(Environment.NewLine);
+    stringBuilder.Append("							Code = GeneratedErrorConstants.Codes.NotAllowed,");                        
+	stringBuilder.Append(Environment.NewLine);
+    stringBuilder.AppendFormat("							Message = String.Format(GeneratedErrorConstants.Messages.ResponseObjectUsedForUpdate, {0}ToUpdate.GetType().Name)", lowerCaseEntityName);                        
+	stringBuilder.Append(Environment.NewLine);
+    stringBuilder.Append("						});");                   
+	stringBuilder.Append(Environment.NewLine);
+    stringBuilder.Append("				}");   
+	stringBuilder.Append(Environment.NewLine);
+    stringBuilder.Append("			}");	
     stringBuilder.Append(Environment.NewLine);
     stringBuilder.AppendFormat("            this.ContentType = \"{0}\";", templateWriter.jsonContentType);
     stringBuilder.Append(Environment.NewLine);

Templates/CSharp/Base/IEntityRequest.Base.template.tt

@@ -274,7 +274,9 @@ public void AppendUpdateAsyncMethodHeader(string entityName, string lowerCaseEnt
     {
         stringBuilder.Append(Environment.NewLine);
         stringBuilder.Append("        /// <param name=\"cancellationToken\">The <see cref=\"CancellationToken\"/> for the request.</param>");
-    }
+		stringBuilder.Append(Environment.NewLine);
+		stringBuilder.Append("		/// <exception cref=\"ClientException\">Thrown when an object returned in a response is used for updating an object in Microsoft Graph.</exception>");
+	}
 
     stringBuilder.Append(Environment.NewLine);
     stringBuilder.AppendFormat("        /// <returns>The updated {0}.</returns>", entityName);