// // Copyright (c) Microsoft. All rights reserved. // Licensed under the MIT license. See LICENSE file in the project root for full license information. // using System; using System.Collections.Generic; using System.IO; using System.Linq; using System.Text; using Microsoft.SqlTools.ServiceLayer.QueryExecution.Contracts; namespace Microsoft.SqlTools.ServiceLayer.QueryExecution.DataStorage { /// /// Writer for writing rows of results to a CSV file /// public class SaveAsCsvFileStreamWriter : SaveAsStreamWriter { #region Member Variables private readonly SaveResultsAsCsvRequestParams saveParams; private bool headerWritten; #endregion /// /// Constructor, stores the CSV specific request params locally, chains into the base /// constructor /// /// FileStream to access the CSV file output /// CSV save as request parameters public SaveAsCsvFileStreamWriter(Stream stream, SaveResultsAsCsvRequestParams requestParams) : base(stream, requestParams) { saveParams = requestParams; } /// /// Writes a row of data as a CSV row. If this is the first row and the user has requested /// it, the headers for the column will be emitted as well. /// /// The data of the row to output to the file /// /// The entire list of columns for the result set. They will be filtered down as per the /// request params. /// public override void WriteRow(IList row, IList columns) { string delimiter = ","; if(!string.IsNullOrEmpty(saveParams.Delimiter)) { delimiter = saveParams.Delimiter; } // Write out the header if we haven't already and the user chose to have it if (saveParams.IncludeHeaders && !headerWritten) { // Build the string var selectedColumns = columns.Skip(ColumnStartIndex ?? 0).Take(ColumnCount ?? columns.Count) .Select(c => EncodeCsvField(c.ColumnName) ?? string.Empty); string headerLine = string.Join(delimiter, selectedColumns); // Encode it and write it out byte[] headerBytes = Encoding.UTF8.GetBytes(headerLine + Environment.NewLine); FileStream.Write(headerBytes, 0, headerBytes.Length); headerWritten = true; } // Build the string for the row var selectedCells = row.Skip(ColumnStartIndex ?? 0) .Take(ColumnCount ?? columns.Count) .Select(c => EncodeCsvField(c.DisplayValue)); string rowLine = string.Join(delimiter, selectedCells); // Encode it and write it out byte[] rowBytes = Encoding.UTF8.GetBytes(rowLine + Environment.NewLine); FileStream.Write(rowBytes, 0, rowBytes.Length); } /// /// Encodes a single field for inserting into a CSV record. The following rules are applied: /// /// All double quotes (") are replaced with a pair of consecutive double quotes /// /// The entire field is also surrounded by a pair of double quotes if any of the following conditions are met: /// /// The field begins or ends with a space /// The field begins or ends with a tab /// The field contains the ListSeparator string /// The field contains the '\n' character /// The field contains the '\r' character /// The field contains the '"' character /// /// /// The field to encode /// The CSV encoded version of the original field internal static string EncodeCsvField(string field) { // Special case for nulls if (field == null) { return "NULL"; } // Whether this field has special characters which require it to be embedded in quotes bool embedInQuotes = field.IndexOfAny(new[] {',', '\r', '\n', '"'}) >= 0 // Contains special characters || field.StartsWith(" ") || field.EndsWith(" ") // Start/Ends with space || field.StartsWith("\t") || field.EndsWith("\t"); // Starts/Ends with tab //Replace all quotes in the original field with double quotes string ret = field.Replace("\"", "\"\""); if (embedInQuotes) { ret = $"\"{ret}\""; } return ret; } } }