PrinterSettings.IsValid Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
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.