PrinterSettings.PrinterName 属性

获取或设置要使用的打印机的名称。

**命名空间:**System.Drawing.Printing
**程序集:**System.Drawing（在 system.drawing.dll 中）

语法

声明
Public Property PrinterName As String
用法
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)

属性值

要使用的打印机的名称。

备注

设置打印机名称后，请调用 IsValid 以确定系统是否将该打印机名称识别为有效的打印机。

还可以使用 InstalledPrinters 属性来获取系统上安装的打印机列表。

示例

下面的代码示例通过设置 PrinterName 属性来指定目标打印机，并且如果 IsValid 为 true，则在指定的打印机上打印文档。此示例包括三个必备条件：

• 已经将名为 filePath 的变量设置为要打印的文件的路径。

• 已经定义名为 pd_PrintPage 的方法（该方法处理 PrintPage 事件）。

• 已经将名为 printer 的变量设置为打印机的名称。

在此示例中使用 System.Drawing、System.Drawing.Printing 和 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 安全性

• PrintingPermission  用于打印和访问网络上的所有打印机。关联的枚举：PrintingPermissionLevel.AllPrinting

平台

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 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

PrinterSettings 类
PrinterSettings 成员
System.Drawing.Printing 命名空间
PrinterSettings.IsValid 属性
PrinterSettings.InstalledPrinters 属性
PrinterSettings.Duplex 属性
PrinterSettings.MaximumCopies 属性