combit List & Label 30 - .NET Hilfe
combit.Reporting Namespace / PreviewFile Klasse / ConvertTo Methode / ConvertTo(String,String) Methode

Name der Zieldatei. Dieser kann auch den Formatierungsplatzhalter "%d" enthalten (z.B. "Seite %d"). Dies ist wichtig z.B. für Export-Formate, die mehrere Dateien pro Seite erzeugen würden wie bspw. bei der JPEG-Konvertierung, da sonst nur eine einzige Seite erzeugt werden würde.

Gewünschtes Zielformat. Erlaubte Werte: 

Über diesen Parameter kann eine semikolonseparierte Liste mit darin enthaltenen exporterspezifischen Optionen für die Konvertierung gesetzt werden. Die möglichen Parameter finden Sie im Kapitel über die Export-Module in der Programmierer-Referenz dokumentiert.

Beachten Sie, dass nicht alle dort angegebenen Parameter berücksichtigt werden können. Ein Beispiel dafür wäre die Übergabe von "PDF;PDF.Encryption.EncryptFile=1".

Zusätzlich zu den im Kapitel über die Export-Module in der Programmierer-Referenz beschriebenen Parametern können die folgenden Parameter übergeben werden:

Wert Bedeutung
PageIndexRange Analog zum Druckdialog kann ein Bereich für die Seiten angegeben werden.
JobIndexRange Analog zum Druckdialog kann ein Bereich für den Job angegeben werden.
IssueIndexRange Analog zum Druckdialog kann ein Bereich für die Ausfertigungen angegeben werden.

Ein Beispiel hierfür wäre die Verwendung von "PDF;Export.PageIndexRange=2-3". Damit werden lediglich die Seiten 2 und 3 in das erzeugte PDF aufgenommen.

Der Export auf das Format "PRN" erzeugt eine Datei, die speziell für den angegebenen Drucker (Parameter "PRN.Device=") aufbereitet wird und über direktes Kopieren auf den Drucker ausgegeben werden kann. Daher muss der Druckername (Device-Name) auch explizit übergeben werden.



ConvertTo(String,String) Methode

Konvertiert die Preview-Datei in den angegebenen Dateinamen. Erlaubt die Angabe des Formates sowie zusätzlicher Optionen.

Syntax
'Deklaration
 
Public Overloads Sub ConvertTo( _
   ByVal filename As String, _
   ByVal targetFormat As String _
) 
 

Parameter

filename

Name der Zieldatei. Dieser kann auch den Formatierungsplatzhalter "%d" enthalten (z.B. "Seite %d"). Dies ist wichtig z.B. für Export-Formate, die mehrere Dateien pro Seite erzeugen würden wie bspw. bei der JPEG-Konvertierung, da sonst nur eine einzige Seite erzeugt werden würde.

targetFormat

Gewünschtes Zielformat. Erlaubte Werte: 

  • "TIFF" (auch als "PICTURE_MULTITIFF")
  • "JPEG" (auch als "PICTURE_JPEG")
  • "PNG" (auch als "PICTURE_PNG")
  • "EMF"       
  • "TTY"       
  • "PDF"       
  • "XPS"       
  • "PRN"
  • "TXT"
  • "LL" (auch als "PRV")

Über diesen Parameter kann eine semikolonseparierte Liste mit darin enthaltenen exporterspezifischen Optionen für die Konvertierung gesetzt werden. Die möglichen Parameter finden Sie im Kapitel über die Export-Module in der Programmierer-Referenz dokumentiert.

Beachten Sie, dass nicht alle dort angegebenen Parameter berücksichtigt werden können. Ein Beispiel dafür wäre die Übergabe von "PDF;PDF.Encryption.EncryptFile=1".

Zusätzlich zu den im Kapitel über die Export-Module in der Programmierer-Referenz beschriebenen Parametern können die folgenden Parameter übergeben werden:

Wert Bedeutung
PageIndexRange Analog zum Druckdialog kann ein Bereich für die Seiten angegeben werden.
JobIndexRange Analog zum Druckdialog kann ein Bereich für den Job angegeben werden.
IssueIndexRange Analog zum Druckdialog kann ein Bereich für die Ausfertigungen angegeben werden.

Ein Beispiel hierfür wäre die Verwendung von "PDF;Export.PageIndexRange=2-3". Damit werden lediglich die Seiten 2 und 3 in das erzeugte PDF aufgenommen.

Der Export auf das Format "PRN" erzeugt eine Datei, die speziell für den angegebenen Drucker (Parameter "PRN.Device=") aufbereitet wird und über direktes Kopieren auf den Drucker ausgegeben werden kann. Daher muss der Druckername (Device-Name) auch explizit übergeben werden.

Bemerkungen

Es können zusätzliche Formate aus der Vorschaudatei heraus konvertiert werden, wenn diese zuvor mit der Option LlOptionString.EmbeddedExportFormats in die Vorschaudatei eingebettet wurden. Der Blog-Artikel Export direkt aus der Vorschau beschreibt das Vorgehen im Detail. Dabei stehen dann diese Formate bei der Konvertierung zusätzlich zur Verfügung:

  • "XHMTL"
  • "MHTML"
  • "DOCX"
  • "XLS"
Beispiele

Ein Beispiel hierfür wäre die Verwendung von "PDF;Export.PageIndexRange=2-3". Damit werden lediglich die Seiten 2 und 3 in das erzeugte PDF aufgenommen.

// Existierende Vorschaudatei auf dem System öffnen
PreviewFile previewFile = new PreviewFile(@"C:\preview.ll");

// Vorschaudatei mit den folgenden Optionen nach PDF konvertieren:
// - aber nur Seite 2-3
// - TrueType-Schriftarten einbetten
previewFile.ConvertTo(@"C:\preview.pdf","PDF;Export.PageIndexRange=2-3");

// Vorschaudatei schließen und freigeben
previewFile.Close();
previewFile.Dispose();
Anforderungen

Plattformen: Windows 10 (Version 21H2 - 22H2), Windows 11 (21H2 - 23H2), Windows Server 2016 - 2022
.NET: .NET Framework 4.8, .NET 6, .NET 8, .NET 9

Siehe auch