PrinterSettings.IsValid プロパティ

.NET Framework クラス ライブラリ リファレンス

PrinterSettings.IsValid プロパティ

PrinterName プロパティが有効なプリンタに指定されているかどうかを示す値を取得します。

名前空間: System.Drawing.Printing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 IsValid As Boolean

Visual Basic (使用法)

Dim instance As PrinterSettings
Dim value As Boolean

value = instance.IsValid

C#

public bool IsValid { get;
 }

C++

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

J#

/** @property */
public boolean get_IsValid ()

JScript

public function get IsValid
 () : boolean

プロパティ値
PrinterName プロパティが有効なプリンタの場合は true。それ以外の場合は false。

解説

一部のプロパティを取得または設定する際に有効なプリンタが指定されていないと、例外が発生します。例外が発生しないように、PrinterName を設定した後で IsValid プロパティを使用して、プリンタが有効かどうかを安全に判断します。

使用例

PrinterName プロパティを設定して印刷先プリンタを指定するコード例を次に示します。IsValid が true の場合は、指定したプリンタでドキュメントが印刷されます。この例には、次の 3 つの必要条件があります。

• 変数 filePath が印刷するファイルのパスに設定されていること。

• PrintPage イベントを処理する pd_PrintPage メソッドが定義されていること。

• 変数 printer がプリンタ名に設定されていること。

この例では、System.Drawing、System.Drawing.Printing、および System.IO の各名前空間を使用します。

Visual Basic

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
   

C#

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);
  }
}

C++

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 );
      }
   }

J#

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

プラットフォーム

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 名前空間
PrinterName