PrinterSettings.IsValid 屬性

定義

命名空間:

System.Drawing.Printing

組件:

System.Drawing.Common.dll

套件:

System.Drawing.Common v8.0.0

來源:

PrinterSettings.cs

取得值，指出 PrinterName 屬性是否指定有效印表機。

public:
 property bool IsValid { bool get(); };

public bool IsValid { get; }

member this.IsValid : bool

Public ReadOnly Property IsValid As Boolean

屬性值

Boolean

如果 PrinterName 屬性指定有效印表機，則為 true，否則為 false。

範例

下列程式代碼範例會藉由設定 PrinterName 屬性來指定目標列印機，如果 IsValid 為 true，則會在指定的印表機上列印檔。 此範例有三個必要條件：

• 名為 filePath 的變數已設定為要列印的檔案路徑。

• 已定義名為 pd_PrintPage的方法，這個方法會處理 PrintPage 事件。

• 名為 printer 的變數已設定為印表機的名稱。

針對此範例， System.Drawing請使用、 System.Drawing.Printing和 System.IO 命名空間。

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.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 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

備註

當您取得或設定某些屬性時，需要有效的印表機，否則會引發例外狀況。 若要避免例外狀況，請在設定 PrinterName 之後使用 IsValid 屬性，以安全地判斷印表機是否有效。

另請參閱

• PrinterName