PrintForm.PrintFileName-Eigenschaft

Artikel
10/24/2012

Ruft den Text ab oder legt den Dateinamen einer gekapselten PostScript-Datei und Pfad fest, an dem die Datei gespeichert wird, wenn die PrintAction-Eigenschaft auf PrintToFilefestgelegt ist.

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

Syntax

'Declaration
<BrowsableAttribute(True)> _
Public Property PrintFileName As String

[BrowsableAttribute(true)]
public string PrintFileName { get; set; }

[BrowsableAttribute(true)]
public:
property String^ PrintFileName {
    String^ get ();
    void set (String^ value);
}

[<BrowsableAttribute(true)>]
member PrintFileName : string with get, set

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

Eigenschaftswert

Typ: System.String
Gibt String zurück, der einen Dateipfad und einen Namen enthält.

Hinweise

Wenn die PrintAction-Eigenschaft auf PrintToFilefestgelegt ist, wird das Bild eines Formulars auf eine gekapselten PostScript-Datei gespeichert (.eps, .ps oder .ai).Die PrintFileName-Eigenschaft gibt den Pfad der Datei an.

Hinweis
Um andere Anwendungen zu ermöglichen die Datei als PostScript-Datei zu erkennen, müssen Sie eine gültige PostScript-Dateinamenerweiterung (.eps, .ps oder .ai) in der PrintFileName-Eigenschaft verwenden.

Wenn kein PrintFileName angegeben ist, wird der Benutzer zur Eingabe eines Dateinamens zur Laufzeit aufgefordert.

Hinweis der Benutzer wird nicht für einen Pfad oder eine Dateinamenerweiterung aufgefordert.Um sicherzustellen, dass die Datei einen gültigen Pfad und einer Erweiterung verfügt, können Sie implementieren Dialogfeld besitzen.Hierzu verwenden Sie eine SaveFileDialog Komponente und weisen Sie den Rückgabewert der PrintFileName-Eigenschaft zu, bevor Sie die Print-Methode aufrufen.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein Dialogfeld angezeigt, um den Benutzer aufzufordern und einen Dateinamen für sie der PrintFileName-Eigenschaft zugewiesen werden soll.Dieses Beispiel setzt voraus, dass Sie eine PrintForm Komponente verfügen, die in einem Formular PrintForm1.

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)|"
fileDialog.InitialDirectory = _
  My.Computer.FileSystem.SpecialDirectories.CurrentUserApplicationData
fileDialog.ShowDialog()
fileToSave = fileDialog.FileName & ".eps"
PrintForm1.PrintFileName = filePath

.NET Framework-Sicherheit

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.