Параметры сведений об устройстве 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.

Связанный контент