PrinterSettings.IsValid 속성

정의

PrinterName 속성이 올바른 프린터를 지정할지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the PrinterName property designates a valid printer.

public:
 property bool IsValid { bool get(); };
public bool IsValid { get; }
member this.IsValid : bool
Public ReadOnly Property IsValid As Boolean

속성 값

true 속성이 올바른 프린터를 지정하면 PrinterName이고, 그렇지 않으면 false입니다.true if the PrinterName property designates a valid printer; otherwise, false.

예제

다음 코드 예제에서는 PrinterName 속성을 설정 하 여 대상 프린터를 지정 하 고 IsValid true경우 지정 된 프린터에 문서를 인쇄 합니다.The following code example specifies the target printer by setting the PrinterName property, and if the IsValid is true, prints the document on the specified printer. 예제에는 세 가지 필수 조건이 있습니다.The example has three prerequisites:

  • filePath 라는 변수가 인쇄할 파일의 경로로 설정 되었습니다.A variable named filePath has been set to the path of the file to print.

  • PrintPage 이벤트를 처리 하는 pd_PrintPage라는 메서드가 정의 되었습니다.A method named pd_PrintPage, which handles the PrintPage event, has been defined.

  • printer 라는 변수가 프린터 이름으로 설정 되었습니다.A variable named printer has been set to the printer's name.

이 예에서는 System.Drawing, System.Drawing.PrintingSystem.IO 네임 스페이스를 사용 합니다.Use the System.Drawing, System.Drawing.Printing, and System.IO namespaces for this example.

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
   

설명

가져오거나 일부 속성을 설정할 때 올바른 프린터를 반드시 그렇지 않으면 예외가 발생 합니다.When you get or set some properties, a valid printer is required or else an exception is raised. 예외를 방지 하려면 PrinterName 설정한 후 IsValid 속성을 사용 하 여 프린터가 유효한 지 여부를 안전 하 게 확인 합니다.To avoid exceptions, use the IsValid property after setting the PrinterName to safely determine if the printer is valid.

적용 대상

추가 정보