PrinterSettings.PrinterName-Eigenschaft
Ruft den Namen des zu verwendenden Druckers ab oder legt diesen fest.
Namespace: System.Drawing.Printing
Assembly: System.Drawing (in system.drawing.dll)
Syntax
'Declaration
Public Property PrinterName As String
'Usage
Dim instance As PrinterSettings
Dim value As String
value = instance.PrinterName
instance.PrinterName = value
public string PrinterName { get; set; }
public:
property String^ PrinterName {
String^ get ();
void set (String^ value);
}
/** @property */
public String get_PrinterName ()
/** @property */
public void set_PrinterName (String value)
public function get PrinterName () : String
public function set PrinterName (value : String)
Eigenschaftenwert
Der Name des zu verwendenden Druckers.
Hinweise
Rufen Sie nach Festlegen des Druckernamens IsValid auf, um zu bestimmen, ob der Druckername als ein im System gültiger Drucker erkannt wird.
Sie können auch mit der InstalledPrinters-Eigenschaft eine Liste der im System installierten Drucker abrufen.
Beispiel
Im folgenden Codebeispiel wird der Zieldrucker durch Festlegen der PrinterName-Eigenschaft angegeben und das Dokument auf dem angegebenen Drucker gedruckt, wenn IsValid gleich true ist. Für das Beispiel müssen drei Voraussetzungen erfüllt sein:
Die Variable
filePath
wurde auf den Pfad der zu druckenden Datei festgelegt.Die Methode
pd_PrintPage
, die das PrintPage-Ereignis behandelt, wurde definiert.Die Variable
printer
wurde auf den Namen des Druckers festgelegt.
Verwenden Sie für dieses Beispiel die Namespaces System.Drawing, System.Drawing.Printing und System.IO.
Public Sub Printing(printer As String)
Try
streamToPrint = New StreamReader(filePath)
Try
printFont = New Font("Arial", 10)
Dim pd As New PrintDocument()
AddHandler pd.PrintPage, AddressOf pd_PrintPage
' Specify the printer to use.
pd.PrinterSettings.PrinterName = printer
If pd.PrinterSettings.IsValid then
pd.Print()
Else
MessageBox.Show("Printer is invalid.")
End If
Finally
streamToPrint.Close()
End Try
Catch ex As Exception
MessageBox.Show(ex.Message)
End Try
End Sub
public void Printing(string printer) {
try {
streamToPrint = new StreamReader (filePath);
try {
printFont = new Font("Arial", 10);
PrintDocument pd = new PrintDocument();
pd.PrintPage += new PrintPageEventHandler(pd_PrintPage);
// Specify the printer to use.
pd.PrinterSettings.PrinterName = printer;
if (pd.PrinterSettings.IsValid) {
pd.Print();
}
else {
MessageBox.Show("Printer is invalid.");
}
}
finally {
streamToPrint.Close();
}
}
catch(Exception ex) {
MessageBox.Show(ex.Message);
}
}
public:
void Printing( String^ printer )
{
try
{
streamToPrint = gcnew StreamReader( filePath );
try
{
printFont = gcnew System::Drawing::Font( "Arial",10 );
PrintDocument^ pd = gcnew PrintDocument;
pd->PrintPage += gcnew PrintPageEventHandler(
this, &Form1::pd_PrintPage );
// Specify the printer to use.
pd->PrinterSettings->PrinterName = printer;
if ( pd->PrinterSettings->IsValid )
{
pd->Print();
}
else
{
MessageBox::Show( "Printer is invalid." );
}
}
finally
{
streamToPrint->Close();
}
}
catch ( Exception^ ex )
{
MessageBox::Show( ex->Message );
}
}
public void Printing(String printer)
{
try {
streamToPrint = new StreamReader(filePath);
try {
printFont = new Font("Arial", 10);
PrintDocument pd = new PrintDocument();
pd.add_PrintPage(new PrintPageEventHandler(pd_PrintPage));
// Specify the printer to use.
pd.get_PrinterSettings().set_PrinterName(printer);
if (pd.get_PrinterSettings().get_IsValid()) {
pd.Print();
}
else {
MessageBox.Show("Printer is invalid.");
}
}
finally {
streamToPrint.Close();
}
}
catch (System.Exception ex) {
MessageBox.Show(ex.get_Message());
}
} //Printing
.NET Framework-Sicherheit
- PrintingPermission für das Drucken und den Zugriff auf alle Drucker im Netzwerk. Zugeordnete Enumeration: PrintingPermissionLevel.AllPrinting
Plattformen
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
PrinterSettings-Klasse
PrinterSettings-Member
System.Drawing.Printing-Namespace
PrinterSettings.IsValid-Eigenschaft
PrinterSettings.InstalledPrinters-Eigenschaft
PrinterSettings.Duplex-Eigenschaft
PrinterSettings.MaximumCopies-Eigenschaft