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

public void ConvertTo( 
   string filename,
   string targetFormat
)

public:
void ConvertTo( 
   String^ filename,
   String^ targetFormat
) 

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.

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"

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();

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

Referenz

PreviewFile Klasse
PreviewFile Member
Overload-Liste