Настройки сведений об устройстве CSV
Настройки сведений об устройстве для модуля подготовки отчетов CSV позволяет изменять разделители и квалификаторы, а также указывать правила обработки разрывов строк. Также можно указать расширение файла, кодировку и определить включение строк заголовка в выходные данные. Поскольку разделителями, скорее всего, будут специальные символы, их следует кодировать в разделе CDATA, если параметры записываются в формате XML.
В следующей таблице перечислены настройки сведений об устройстве для подготовки к просмотру в текстовом формате.
Параметр |
Значение |
|---|---|
Encoding |
Интернет полномочия IANA (Assigned Numbers) имя кодировки символов, поддерживаемой .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 |
Строка-квалификатор, размещаемая вокруг результатов, содержащих разделитель полей или разделитель записей. Если результаты содержат квалификатор, квалификатор повторяется. Значение параметра Qualifier должно отличаться от значений параметров FieldDelimiter и RecordDelimiter. По умолчанию используется кавычка ("). |
RecordDelimiter |
Разделитель записей, помещаемый в конце каждой записи. Значение по умолчанию — <cr><lf>. |
SuppressLineBreaks |
Показывает, удаляются ли разрывы строк из данных, включаемых в выходной документ. По умолчанию устанавливается значение false. Если задано значение true, то значением параметров FieldDelimiter, RecordDelimiter и Qualifier не может быть пробельный символ. |
UseFormattedValues |
Показывает, помещаются ли форматированные строки в выходной CSV-документ. По умолчанию используется значение true, если параметр ExcelMode имеет значение true. В противном случае используется значение false. |