Impostazioni relative alle informazioni sul dispositivo CSV

  • Articolo

Le impostazioni relative alle informazioni sul dispositivo per l'estensione per il rendering CSV consentono di modificare i delimitatori e i qualificatori e di specificare il tipo di gestione delle interruzioni di riga. È anche possibile specificare l'estensione di file, nonché la codifica e l'inclusione delle righe di intestazione nell'output. Poiché in genere i delimitatori sono caratteri speciali, è necessario codificarli in una sezione CDATA, se le impostazioni sono scritte in formato XML.

Nella tabella seguente sono elencate le impostazioni relative alle informazioni sul dispositivo per il rendering in formato testo.

Impostazione Valore
Encoding Il nome IANA (Internet Assigned Numbers Authority) di una codifica dei caratteri supportata da .NET Framework. Il valore predefinito è UTF-8. Esempi di altri valori includono ASCII, UTF-7 e UTF-16.
ExcelMode Specifica che l'output di destinazione è destinato a Excel. Il valore predefinito è true.
FieldDelimiter Stringa di delimitazione da inserire nel risultato. Il valore predefinito è una virgola (,). Quando si passano queste informazioni sul dispositivo a un URL, è necessario codificarne il valore. Un carattere di tabulazione utilizzato come delimitatore corrisponde ad esempio a "%09".

È possibile modificare il delimitatore di campo predefinito impostandolo su qualsiasi carattere desiderato, incluso TAB, modificando le impostazioni relative alle informazioni sul dispositivo nel file di configurazione. Per usare TAB, aggiornare ad esempio l'impostazione FieldDelimiter impostandola su <FieldDelimiter xml:space="preserve">[TAB]</FieldDelimiter>

Nell'esempio [TAB] è un carattere di tabulazione effettivo, pertanto nel file di configurazione viene visualizzato una spazio vuoto. L'attributo "xml:space" indica al parser che lo spazio vuoto deve essere mantenuto.
FileExtension Estensione di file per il risultato. Il valore predefinito è .CSV. Se sono stati specificati sia FileExtension che Extension , FileExtension avrà la precedenza.
NoHeader Indica se la riga di intestazione è esclusa dall'output. Il valore predefinito è false.
Qualifier Qualificatore da inserire prima e dopo i risultati che contengono il delimitatore di campo o di record. Se i risultati contengono il qualificatore, il qualificatore viene ripetuto. L'impostazione Qualifier deve essere diversa da FieldDelimiter e RecordDelimiter . Il valore predefinito è costituito dalle virgolette (").
RecordDelimiter Delimitatore di record da inserire alla fine di ogni record. Il valore predefinito è <cr><lf>.
SuppressLineBreaks Indica se le interruzioni di riga vengono rimosse dai dati inclusi nell'output. Il valore predefinito è false. Se il valore è true, le impostazioni FieldDelimiter, RecordDelimitere Qualifier non possono essere un carattere di spazio.
UseFormattedValues Indica se le stringhe formattate vengono inserite nell'output CSV. Il valore predefinito è true quando ExcelMode è true, in caso contrario è false.

Contenuto correlato