Updated

Author: kichalla

src/Microsoft.AspNet.Mvc.Core/ActionResults/ContentResult.cs

@@ -20,6 +20,9 @@ public class ContentResult : ActionResult
 
         public string Content { get; set; }
 
+        /// <summary>
+        /// Gets or sets the <see cref="MediaTypeHeaderValue"/> representing the Content-Type header of the response.
+        /// </summary>
         public MediaTypeHeaderValue ContentType { get; set; }
 
         /// <summary>

src/Microsoft.AspNet.Mvc.Core/ActionResults/FileResult.cs

@@ -40,7 +40,7 @@ protected FileResult([NotNull] MediaTypeHeaderValue contentType)
         }
 
         /// <summary>
-        /// Gets or sets the Content-Type header value that will be written to the response.
+        /// Gets the <see cref="MediaTypeHeaderValue"/> representing the Content-Type header of the response.
         /// </summary>
         public MediaTypeHeaderValue ContentType { get; }
 

src/Microsoft.AspNet.Mvc.Core/ActionResults/ViewExecutor.cs

@@ -62,6 +62,9 @@ public static async Task ExecuteAsync([NotNull] IView view,
 
             var wrappedStream = new StreamWrapper(response.Body);
 
+            // StreamWriter writes the preamble or BOM bytes to the response if the encoding requires it.
+            // Since preamble bytes are unnecessary when generating dynamic content, wrap the original encoding
+            // to avoid writing the preamble bytes.
             using (var writer = new StreamWriter(
                 wrappedStream,
                 new ResponseEncodingWrapper(encoding),

test/Microsoft.AspNet.Mvc.Core.Test/ActionResults/ContentResultTest.cs

@@ -1,8 +1,6 @@
-
-// Copyright (c) Microsoft Open Technologies, Inc. All rights reserved.
+// Copyright (c) Microsoft Open Technologies, Inc. All rights reserved.
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 
-using System;
 using System.IO;
 using System.Text;
 using System.Threading.Tasks;

test/Microsoft.AspNet.Mvc.Core.Test/ActionResults/FilePathResultTest.cs

@@ -2,17 +2,17 @@
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 
 using System.IO;
+using System.Text;
 using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.AspNet.FileProviders;
 using Microsoft.AspNet.Hosting;
 using Microsoft.AspNet.Http;
 using Microsoft.AspNet.Routing;
 using Microsoft.Framework.DependencyInjection;
+using Microsoft.Net.Http.Headers;
 using Moq;
 using Xunit;
-using System.Text;
-using Microsoft.Net.Http.Headers;
 
 namespace Microsoft.AspNet.Mvc
 {
@@ -117,7 +117,7 @@ public async Task ExecuteResultAsync_SetsSuppliedContentTypeAndEncoding()
         {
             // Arrange
             var expectedContentType = "text/foo; charset=us-ascii";
-            // path will be C:/.../TestFiles/FilePathResultTestFile.txt
+            // path will be C:/.../TestFiles/FilePathResultTestFile_ASCII.txt
             var path = Path.GetFullPath(Path.Combine(".", "TestFiles", "FilePathResultTestFile_ASCII.txt"));
             path = path.Replace(@"\", "/");