Entwerfen für die CSV-Ausgabe

Die CSV-Renderingerweiterung (Comma-Separated Value) rendert Berichte in durch Trennzeichen getrennte Nur-Text-Dateien ohne jede Formatierung. Dabei werden Felder und Zeilen durch ein Trennzeichen getrennt, für das auch ein anderes Zeichen als ein Komma gewählt werden kann. Die resultierende Datei kann in einem Tabellenkalkulationsprogramm wie Microsoft Excel geöffnet werden oder als Importformat für andere Programme verwendet werden. Der exportierte Bericht wird zu einer CSV-Datei und gibt den MIME-Typ text/plain zurück. Die Dateien haben die MIME-Version 1.0.

CSV-Rendering

Ein CSV-Bericht, der mit den Standardeinstellungen gerendert wurde, hat folgende Merkmale:

• Der erste Datensatz enthält Header für alle Spalten in dem Bericht.
• Alle Zeilen haben die gleiche Anzahl von Spalten.
• Das standardmäßige Feldtrennzeichen ist ein Komma (,).
• Die Trennzeichenfolge für Datensätze ist Wagenrücklauf, gefolgt von Zeilenvorschub (<cr><lf>).
• Als Textqualifizierer-Zeichenfolge dient das Anführungszeichen (").
• Falls der Text eine eingebettete Trennzeichenfolge oder Qualifiziererzeichenfolge enthält, wird der Text in den Textqualifizierer eingeschlossen, und die eingebetteten Qualifiziererzeichenfolgen werden verdoppelt.
• Formatierung und Layout werden ignoriert.

Beim Rendern eines Berichts iteriert die CSV-Renderingerweiterung durch das vom Berichtsprozessor erzeugte Renderingobjektmodell. Die folgenden Elemente werden bei der Verarbeitung ignoriert:

• PageHeader
• PageFooter
• Benutzerdefiniert
• Liniendiagramm
• Image
• ActiveX-Steuerelement

Die verbleibenden Berichtselemente werden von oben nach unten und dann von links nach rechts sortiert. Anschließend wird jedes Element in eine Spalte gerendert. Enthält der Bericht geschachtelte Datenelemente, wie Listen oder Tabellen, werden die übergeordneten Elemente in jedem Datensatz wiederholt.

In der folgenden Tabelle sind Aspekte des CSV-Renderings von Elementen aufgeführt.

Element	Renderingverhalten
Textfeld	Der Inhalt des Textfeldes wird gerendert. Die Daten werden entsprechend der Format-Eigenschaft des Elements formatiert.
Tabelle	Das Rendering erfolgt durch Erweitern der Tabelle und Erstellen einer Zeile und Spalte für jede Zeile und Spalte auf der untersten Detailebene. Teilergebniszeilen und -spalten weisen keine Zeilen- und Spaltenüberschriften auf. Drillthroughberichte werden nicht unterstützt.
Matrix	Das Rendering erfolgt durch Erweitern der Matrix und Erstellen einer Zeile und Spalte für jede Zeile und Spalte auf der untersten Detailebene. Teilergebniszeilen und -spalten weisen keine Zeilen- und Spaltenüberschriften auf.
Liste	Für jede Detailzeile oder Instanz in der Liste wird ein Datensatz gerendert.
Rechteck	Der Inhalt wird als geschachtelte Elemente gerendert. Das übergeordnete Element wird für jede Instanz des Inhalts wiederholt.
Eingebetteter Bericht	Der Inhalt wird als geschachtelte Elemente gerendert. Das übergeordnete Element wird für jede Instanz des Inhalts wiederholt.
Diagramm	Für einen Satz der Datenwerte wird eine Zeile gerendert, für den anderen Satz von Datenwerten werden Spalten gerendert.

Die CSV-Renderingerweiterung verwendet Standardwerte für verschiedene konfigurierbare Geräteinformationseinstellungen, z. B. das zu verwendende Feldtrennzeichen, das Datensatz-Trennzeichen und den Qualifizierer. Der Zugriff auf diese Geräteinformationseinstellungen bzw. ihre Änderung können über eine benutzerdefinierte Anwendung erfolgen. Durch die Verwendung der Geräteinformationseinstellungen können Sie das Rendering der Daten, die Standardtrennzeichen und Seitenumbrüche steuern. Das Feldtrennzeichen, das Datensatz-Trennzeichen und der Textqualifizierer können mit den Geräteinformationseinstellungen FieldDelimiter, RecordDelimiter und Qualifier geändert werden.

Zur Steuerung der Seitenumbrüche gibt die boolesche SuppressLineBreaks-Einstellung an, ob Zeilenumbrüche beim Rendering der Daten entfernt werden. Wenn SuppressLineBreaks den Wert true hat, werden Zeilenumbrüche und Wagenrücklaufzeichen durch ein einzelnes Leerzeichen ersetzt. Mit der Extension-Einstellung können Sie die Dateierweiterung für die Textdatei angeben, und mit der Encoding-Einstellung können Sie die Codierung vom Standardwert Unicode in ASCII, UTF-7 oder UTF-8 ändern. Die NoHeader-Einstellung gibt an, ob die Kopfzeile beim Rendering ausgelassen werden soll. Weitere Informationen zu den Geräteinformationseinstellungen finden Sie unter Reporting Services Device Information Settings.

Hinweis:
Die Struktur des Matrixdatenbereichs in CSV wird möglicherweise in zukünftigen Versionen von Reporting Services geändert.

Siehe auch

Konzepte

Entwurfsaspekte für das Rendern von Berichten

Andere Ressourcen

Reporting Services Programming

Hilfe und Informationen

Informationsquellen für SQL Server 2005