PrinterSettings.IsValid Propriété

Définition

Espace de noms:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Source:

PrinterSettings.cs

Obtient une valeur indiquant si la propriété PrinterName désigne une imprimante valide.

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

public bool IsValid { get; }

member this.IsValid : bool

Public ReadOnly Property IsValid As Boolean

Valeur de propriété

Boolean

true si la propriété PrinterName désigne une imprimante valide ; sinon, false.

Exemples

L’exemple de code suivant spécifie l’imprimante cible en définissant la PrinterName propriété et, si est IsValidtrue, imprime le document sur l’imprimante spécifiée. L’exemple présente trois conditions préalables :

• Une variable nommée filePath a été définie sur le chemin du fichier à imprimer.

• Une méthode nommée pd_PrintPage, qui gère l’événement PrintPage , a été définie.

• Une variable nommée printer a été définie sur le nom de l’imprimante.

Utilisez les System.Drawingespaces de noms , System.Drawing.Printinget System.IO pour cet exemple.

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

Remarques

Lorsque vous obtenez ou définissez certaines propriétés, une imprimante valide est requise, sinon une exception est levée. Pour éviter les exceptions, utilisez la IsValid propriété après avoir défini pour PrinterName déterminer en toute sécurité si l’imprimante est valide.

Voir aussi

• PrinterName