Параметры сведений об устройстве CSV
Настройки сведений об устройстве для модуля подготовки отчетов CSV позволяет изменять разделители и квалификаторы, а также указывать правила обработки разрывов строк. Также можно указать расширение файла, кодировку и определить включение строк заголовка в выходные данные. Поскольку разделителями, скорее всего, будут специальные символы, их следует кодировать в разделе CDATA, если параметры записываются в формате XML.
В следующей таблице перечислены настройки сведений об устройстве для подготовки к просмотру в текстовом формате.
| Параметр | Значение |
|---|---|
| Кодирование | Определенное комитетом по цифровым адресам в Интернете (IANA) название кодировки символов, поддерживаемой платформой .NET Framework. Значение по умолчанию — UTF-8. В качестве примеров других значений можно привести ASCII, UTF-7 и UTF-16. |
| ExcelMode | Указывает, что выходные данные предназначены для Excel. Значение по умолчанию — true |
| FieldDelimiter | Строка-разделитель, помещаемая в результат. По умолчанию используется запятая (,). Во время передачи значения этого параметра сведений об устройстве в URL-адрес его необходимо закодировать в формат URL-адреса. Например, символ табуляции в качестве разделителя должен иметь вид «%09». Можно заменить разделитель полей по умолчанию на любой символ, в том числе символ табуляции. Для этого нужно изменить настройки сведений об устройстве в файле конфигурации. Например, чтобы использовать символ табуляции, измените параметр FieldDelimiter, указав значение <FieldDelimiter xml:space="preserve">[TAB]</FieldDelimiter>. В этом примере вместо [TAB] необходимо вставить символ табуляции, и в файле конфигурации появится пробел. Атрибут "xml:space" сообщает синтаксическому анализу сохранять пробелы. |
| FileExtension | Расширение файла, помещаемое в результат. Значение по умолчанию — .CSV. Если указаны и параметр FileExtension , и параметр Extension , приоритет имеет параметр FileExtension . |
| NoHeader | Показывает, исключается ли из выходных данных строка заголовка. Значение по умолчанию равно false. |
| Квалификатор | Строка-квалификатор, размещаемая вокруг результатов, содержащих разделитель полей или разделитель записей. Если результаты содержат квалификатор, квалификатор повторяется. Значение параметра Qualifier должно отличаться от значений параметров FieldDelimiter и RecordDelimiter . По умолчанию используется кавычка ("). |
| RecordDelimiter | Разделитель записей, помещаемый в конце каждой записи. По умолчанию используется значение <cr><lf>. |
| SuppressLineBreaks | Показывает, удаляются ли разрывы строк из данных, включаемых в выходной документ. Значение по умолчанию равно false. Если задано значение true, то значением параметров FieldDelimiter, RecordDelimiterи Qualifier не может быть пробельный символ. |
| UseFormattedValues | Показывает, помещаются ли форматированные строки в выходной CSV-документ. По умолчанию используется значение true , если параметр ExcelMode имеет значение true. В противном случае используется значение false. |