Printer.PrintFileName-Eigenschaft

Artikel
08/23/2008

Aktualisiert: November 2007

Ruft den Wert ab bzw. legt den Wert fest, der den Dateinamen einer Encapsulated PostScript-Datei und den Pfad angibt, in dem die Datei gespeichert werden soll, wenn die PrintAction-Eigenschaft auf PrintToFile festgelegt wurde.

Namespace: Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

Public Property PrintFileName As String

Dim instance As Printer
Dim value As String

value = instance.PrintFileName

instance.PrintFileName = value

public string PrintFileName { get; set; }

public:
property String^ PrintFileName {
    String^ get ();
    void set (String^ value);
}

public function get PrintFileName () : String
public function set PrintFileName (value : String)

Eigenschaftenwert

Typ: System.String

Gibt einen String zurück, der den Dateipfad und den Namen enthält.

Hinweise

Wenn die PrintAction-Eigenschaft auf PrintToFile festgelegt ist, wird die Druckausgabe in einer Encapsulated PostScript-Datei (.eps, .ps oder .ai) gespeichert. Die PrintFileName-Eigenschaft legt den Pfad und den Namen der Datei fest.

Hinweis:
Sie müssen eine PostScript-Dateierweiterung (.eps, .ps oder .ai) in der PrintFileName-Eigenschaft verwenden, damit die Datei von anderen Anwendungen als PostScript-Datei erkannt werden kann.

Wenn kein PrintFileName festgelegt ist, tritt eine Ausnahme auf.

Hinweis:
Der Benutzer erhält keine Aufforderung zur Eingabe eines Pfads oder einer Dateinamenerweiterung. Um sicherzustellen, dass die Datei über einen gültigen Pfad und eine gültige Erweiterung verfügt, können Sie ein eigenes Dialogfeld implementieren. Verwenden Sie hierfür eine SaveFileDialog-Komponente, und weisen Sie den zurückgegebenen Wert der PrintFileName-Eigenschaft zu, bevor Sie die Print-Methode aufrufen.

Der Benutzer erhält keine Aufforderung zur Eingabe eines Pfads oder einer Dateinamenerweiterung. Um sicherzustellen, dass die Datei über einen gültigen Pfad und eine gültige Erweiterung verfügt, können Sie ein eigenes Dialogfeld implementieren. Verwenden Sie hierfür eine SaveFileDialog-Komponente, und weisen Sie den zurückgegebenen Wert der PrintFileName-Eigenschaft zu, bevor Sie die Print-Methode aufrufen.

Hinweis:
Funktionen und Objekte im Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6-Namespace werden für die Tools zur Aktualisierung von Visual Basic 6.0 auf Visual Basic 2008 bereitgestellt. In den meisten Fällen duplizieren diese Funktionen und Objekte Funktionalitäten, die Sie in anderen Namespaces in .NET Framework finden können. Sie sind nur notwendig, wenn sich das Visual Basic 6.0-Codemodell erheblich von der .NET Framework-Implementierung unterscheidet.

Funktionen und Objekte im Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6-Namespace werden für die Tools zur Aktualisierung von Visual Basic 6.0 auf Visual Basic 2008 bereitgestellt. In den meisten Fällen duplizieren diese Funktionen und Objekte Funktionalitäten, die Sie in anderen Namespaces in .NET Framework finden können. Sie sind nur notwendig, wenn sich das Visual Basic 6.0-Codemodell erheblich von der .NET Framework-Implementierung unterscheidet.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein Dialogfeld mit der Aufforderung zur Eingabe eines Dateinamens angezeigt werden kann, der anschließend der PrintFileName-Eigenschaft zugewiesen wird.

Dim Printer As New Printer
Dim fileDialog As New Windows.Forms.SaveFileDialog
Dim fileToSave As String
fileDialog.Title = "Save to PostScript file"
fileDialog.AddExtension = True
fileDialog.Filter = "Encapsulated PostScript (*.eps)|"

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.