Поделиться через


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