PrintQueue.AddJob Metode

Referensi

Definisi

Ruang nama:: System.Printing

Rakitan:: System.Printing.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Sisipkan tugas cetak baru ke dalam antrean.

Overload

AddJob(String, String, Boolean, PrintTicket)	Menyisipkan tugas cetak baru untuk Dokumen Spesifikasi Kertas XML (XPS) ke dalam antrean, memberinya nama dan pengaturan yang ditentukan, dan menentukan apakah dokumen tersebut harus divalidasi atau tidak.
AddJob(String, PrintTicket)	Menyisipkan tugas cetak baru untuk Dokumen Spesifikasi Kertas XML (XPS) ke dalam antrean, dan memberinya nama dan pengaturan yang ditentukan.
AddJob(String, String, Boolean)	Menyisipkan pekerjaan cetak baru untuk Dokumen Spesifikasi Kertas XML (XPS) ke dalam antrean, memberinya nama yang ditentukan, dan menentukan apakah dokumen tersebut harus divalidasi atau tidak.
AddJob()	Menyisipkan pekerjaan cetak baru (bernama generik), yang kontennya adalah Byte array, ke dalam antrean.
AddJob(String)	Menyisipkan pekerjaan cetak baru, yang kontennya adalah Byte array, ke dalam antrean.

Keterangan

Kecuali antrean dijeda atau dalam status kesalahan, pekerjaan mencetak ketika mencapai bagian atas antrean, jadi ini adalah fungsi pencetakan.

Cara lain untuk mencetak di Windows Presentation Foundation (WPF) termasuk PrintDialog.PrintDocument metode , yang dapat digunakan dengan atau tanpa membuka dialog, dan banyak Write metode dan WriteAsync dari XpsDocumentWriter.

AddJob(String, String, Boolean, PrintTicket)

Menyisipkan tugas cetak baru untuk Dokumen Spesifikasi Kertas XML (XPS) ke dalam antrean, memberinya nama dan pengaturan yang ditentukan, dan menentukan apakah dokumen tersebut harus divalidasi atau tidak.

public:
 System::Printing::PrintSystemJobInfo ^ AddJob(System::String ^ jobName, System::String ^ documentPath, bool fastCopy, System::Printing::PrintTicket ^ printTicket);

public System.Printing.PrintSystemJobInfo AddJob (string jobName, string documentPath, bool fastCopy, System.Printing.PrintTicket printTicket);

member this.AddJob : string * string * bool * System.Printing.PrintTicket -> System.Printing.PrintSystemJobInfo

Public Function AddJob (jobName As String, documentPath As String, fastCopy As Boolean, printTicket As PrintTicket) As PrintSystemJobInfo

Parameter

jobName: String

Jalur dan nama dokumen yang sedang dicetak.

documentPath: String

Jalur dan nama dokumen yang sedang dicetak.

fastCopy: Boolean

true untuk melakukan penampungan dengan cepat tanpa umpan balik kemajuan halaman demi halaman dan tanpa memvalidasi bahwa file tersebut adalah XPS yang valid; jika tidak, false.

printTicket: PrintTicket

Pengaturan pekerjaan cetak.

Mengembalikan

PrintSystemJobInfo

PrintSystemJobInfo yang mewakili pekerjaan cetak dan statusnya.

Keterangan

Untuk informasi selengkapnya, lihat AddJob(String, String, Boolean).

Berlaku untuk

AddJob(String, PrintTicket)

Menyisipkan tugas cetak baru untuk Dokumen Spesifikasi Kertas XML (XPS) ke dalam antrean, dan memberinya nama dan pengaturan yang ditentukan.

public:
 System::Printing::PrintSystemJobInfo ^ AddJob(System::String ^ jobName, System::Printing::PrintTicket ^ printTicket);

public System.Printing.PrintSystemJobInfo AddJob (string jobName, System.Printing.PrintTicket printTicket);

member this.AddJob : string * System.Printing.PrintTicket -> System.Printing.PrintSystemJobInfo

Public Function AddJob (jobName As String, printTicket As PrintTicket) As PrintSystemJobInfo

Parameter

jobName: String

Jalur dan nama dokumen yang sedang dicetak.

printTicket: PrintTicket

Pengaturan pekerjaan cetak.

Mengembalikan

PrintSystemJobInfo

PrintSystemJobInfo yang mewakili pekerjaan cetak dan statusnya.

Keterangan

Untuk informasi selengkapnya, lihat AddJob(String).

Berlaku untuk

AddJob(String, String, Boolean)

Menyisipkan pekerjaan cetak baru untuk Dokumen Spesifikasi Kertas XML (XPS) ke dalam antrean, memberinya nama yang ditentukan, dan menentukan apakah dokumen tersebut harus divalidasi atau tidak.

public:
 System::Printing::PrintSystemJobInfo ^ AddJob(System::String ^ jobName, System::String ^ documentPath, bool fastCopy);

public System.Printing.PrintSystemJobInfo AddJob (string jobName, string documentPath, bool fastCopy);

member this.AddJob : string * string * bool -> System.Printing.PrintSystemJobInfo

Public Function AddJob (jobName As String, documentPath As String, fastCopy As Boolean) As PrintSystemJobInfo

Parameter

jobName: String

Nama pekerjaan cetak.

documentPath: String

Jalur dan nama dokumen yang sedang dicetak.

fastCopy: Boolean

true untuk melakukan penampungan dengan cepat tanpa umpan balik kemajuan halaman demi halaman dan tanpa memvalidasi bahwa file tersebut adalah XPS yang valid; jika tidak, false.

Mengembalikan

PrintSystemJobInfo

PrintSystemJobInfo yang mewakili pekerjaan cetak dan statusnya.

Contoh

Contoh berikut menunjukkan cara menggunakan AddJob(String, String, Boolean) untuk mencetak batch semua file Spesifikasi Kertas XML (XPS) dalam direktori.

class Program
{
    [System.MTAThreadAttribute()] // Added for clarity, but this line is redundant because MTA is the default.
    static void Main(string[] args)
    {
        // Create the secondary thread and pass the printing method for 
        // the constructor's ThreadStart delegate parameter. The BatchXPSPrinter
        // class is defined below.
        Thread printingThread = new Thread(BatchXPSPrinter.PrintXPS);

        // Set the thread that will use PrintQueue.AddJob to single threading.
        printingThread.SetApartmentState(ApartmentState.STA);

        // Start the printing thread. The method passed to the Thread 
        // constructor will execute.
        printingThread.Start();
    }
}

public class BatchXPSPrinter
{
    public static void PrintXPS()
    {
        // Create print server and print queue.
        LocalPrintServer localPrintServer = new LocalPrintServer();
        PrintQueue defaultPrintQueue = LocalPrintServer.GetDefaultPrintQueue();

        // Prompt user to identify the directory, and then create the directory object.
        Console.Write("Enter the directory containing the XPS files: ");
        String directoryPath = Console.ReadLine();
        DirectoryInfo dir = new DirectoryInfo(directoryPath);

        // If the user mistyped, end the thread and return to the Main thread.
        if (!dir.Exists)
        {
            Console.WriteLine("There is no such directory.");
        }
        else
        {
            // If there are no XPS files in the directory, end the thread 
            // and return to the Main thread.
            if (dir.GetFiles("*.xps").Length == 0)
            {
                Console.WriteLine("There are no XPS files in the directory.");
            }
            else
            {
                Console.WriteLine("\nJobs will now be added to the print queue.");
                Console.WriteLine("If the queue is not paused and the printer is working, jobs will begin printing.");

                // Batch process all XPS files in the directory.
                foreach (FileInfo f in dir.GetFiles("*.xps"))
                {
                    String nextFile = directoryPath + "\\" + f.Name;
                    Console.WriteLine("Adding {0} to queue.", nextFile);

                    try
                    {
                        // Print the Xps file while providing XPS validation and progress notifications.
                        PrintSystemJobInfo xpsPrintJob = defaultPrintQueue.AddJob(f.Name, nextFile, false);
                    }
                    catch (PrintJobException e)
                    {
                        Console.WriteLine("\n\t{0} could not be added to the print queue.", f.Name);
                        if (e.InnerException.Message == "File contains corrupted data.")
                        {
                            Console.WriteLine("\tIt is not a valid XPS file. Use the isXPS Conformance Tool to debug it.");
                        }
                        Console.WriteLine("\tContinuing with next XPS file.\n");
                    }
                }
            }
        }

        Console.WriteLine("Press Enter to end program.");
        Console.ReadLine();
    }
}

Friend Class Program
    <System.MTAThreadAttribute()>
    Shared Sub Main(ByVal args() As String) ' Added for clarity, but this line is redundant because MTA is the default.
        ' Create the secondary thread and pass the printing method for 
        ' the constructor's ThreadStart delegate parameter. The BatchXPSPrinter
        ' class is defined below.
        Dim printingThread As New Thread(AddressOf BatchXPSPrinter.PrintXPS)

        ' Set the thread that will use PrintQueue.AddJob to single threading.
        printingThread.SetApartmentState(ApartmentState.STA)

        ' Start the printing thread. The method passed to the Thread 
        ' constructor will execute.
        printingThread.Start()

    End Sub

End Class

Public Class BatchXPSPrinter
    Public Shared Sub PrintXPS()
        ' Create print server and print queue.
        Dim localPrintServer As New LocalPrintServer()
        Dim defaultPrintQueue As PrintQueue = LocalPrintServer.GetDefaultPrintQueue()

        ' Prompt user to identify the directory, and then create the directory object.
        Console.Write("Enter the directory containing the XPS files: ")
        Dim directoryPath As String = Console.ReadLine()
        Dim dir As New DirectoryInfo(directoryPath)

        ' If the user mistyped, end the thread and return to the Main thread.
        If Not dir.Exists Then
            Console.WriteLine("There is no such directory.")
        Else
            ' If there are no XPS files in the directory, end the thread 
            ' and return to the Main thread.
            If dir.GetFiles("*.xps").Length = 0 Then
                Console.WriteLine("There are no XPS files in the directory.")
            Else
                Console.WriteLine(vbLf & "Jobs will now be added to the print queue.")
                Console.WriteLine("If the queue is not paused and the printer is working, jobs will begin printing.")

                ' Batch process all XPS files in the directory.
                For Each f As FileInfo In dir.GetFiles("*.xps")
                    Dim nextFile As String = directoryPath & "\" & f.Name
                    Console.WriteLine("Adding {0} to queue.", nextFile)

                    Try
                        ' Print the Xps file while providing XPS validation and progress notifications.
                        Dim xpsPrintJob As PrintSystemJobInfo = defaultPrintQueue.AddJob(f.Name, nextFile, False)
                    Catch e As PrintJobException
                        Console.WriteLine(vbLf & vbTab & "{0} could not be added to the print queue.", f.Name)
                        If e.InnerException.Message = "File contains corrupted data." Then
                            Console.WriteLine(vbTab & "It is not a valid XPS file. Use the isXPS Conformance Tool to debug it.")
                        End If
                        Console.WriteLine(vbTab & "Continuing with next XPS file." & vbLf)
                    End Try

                Next f ' end for each XPS file

            End If 'end if there are no XPS files in the directory

        End If 'end if the directory does not exist

        Console.WriteLine("Press Enter to end program.")
        Console.ReadLine()

    End Sub

End Class

Keterangan

Jika fastCopy adalah true, maka printer harus berupa Gambaran Umum Pencetakan. Jika tidak, AddJob(String, String, Boolean) metode melemparkan pengecualian.

Jika fastCopy adalah false, maka tidak perlu menggunakan printer XPSDrv. File XPS yang ditambahkan ke antrean dikonversi ke bahasa deskripsi halaman printer, seperti PCL atau Postscript. Namun, pencetakan semacam ini melakukan panggilan ke Model Objek Komponen (COM). Panggilan ke COM mengharuskan utas panggilan memiliki apartemen berulir tunggal (STA) alih-alih apartemen multi-utas (MTA) yang merupakan default di Microsoft .NET 2.0 dan yang lebih baru. (Untuk informasi selengkapnya tentang threading dan status apartemen, lihat Threading Terkelola dan Tidak Terkelola, dan ApartmentState.) Ada dua cara untuk melakukan ini:

Cara paling sederhana adalah menambahkan STAThreadAttribute (yaitu, "[System.STAThreadAttribute()]") tepat di atas baris pertama metode aplikasi Main (biasanya "static void Main(string[] args)").
Jika Anda membutuhkan status apartemen utas Anda Main menjadi MTA, Anda dapat menampung panggilan ke AddJob(String, String, Boolean) dalam utas terpisah yang status apartemennya diatur ke STA dengan SetApartmentState. Contoh di bawah ini menggambarkan teknik kedua ini.

Catatan

Anda tidak dapat menerapkan ke STAThreadAttribute metode apa pun kecuali Main dan Anda tidak dapat menggunakan SetApartmentState untuk Main utas.

Lihat juga

Berlaku untuk

AddJob()

Menyisipkan pekerjaan cetak baru (bernama generik), yang kontennya adalah Byte array, ke dalam antrean.

public:
 System::Printing::PrintSystemJobInfo ^ AddJob();

public System.Printing.PrintSystemJobInfo AddJob ();

member this.AddJob : unit -> System.Printing.PrintSystemJobInfo

Public Function AddJob () As PrintSystemJobInfo

Mengembalikan

PrintSystemJobInfo

PrintSystemJobInfo yang mewakili pekerjaan cetak dan statusnya.

Contoh

Contoh berikut menunjukkan cara menggunakan AddJob() untuk mengirim Byte array ke antrean cetak. Kode ini hanya berfungsi dengan printer yang dapat mendeteksi dan mencetak teks biasa. Beberapa dari mereka tidak bisa.

// Create the printer server and print queue objects
LocalPrintServer localPrintServer = new LocalPrintServer();
PrintQueue defaultPrintQueue = LocalPrintServer.GetDefaultPrintQueue();

// Call AddJob
PrintSystemJobInfo myPrintJob = defaultPrintQueue.AddJob();

// Write a Byte buffer to the JobStream and close the stream
Stream myStream = myPrintJob.JobStream;
Byte[] myByteBuffer = UnicodeEncoding.Unicode.GetBytes("This is a test string for the print job stream.");
myStream.Write(myByteBuffer, 0, myByteBuffer.Length);
myStream.Close();

' Create the printer server and print queue objects
Dim localPrintServer As New LocalPrintServer()
Dim defaultPrintQueue As PrintQueue = LocalPrintServer.GetDefaultPrintQueue()

' Call AddJob
Dim myPrintJob As PrintSystemJobInfo = defaultPrintQueue.AddJob()

' Write a Byte buffer to the JobStream and close the stream
Dim myStream As Stream = myPrintJob.JobStream
Dim myByteBuffer() As Byte = UnicodeEncoding.Unicode.GetBytes("This is a test string for the print job stream.")
myStream.Write(myByteBuffer, 0, myByteBuffer.Length)
myStream.Close()

Keterangan

Gunakan metode ini untuk menulis informasi spesifik perangkat, ke file penampung, yang tidak secara otomatis disertakan oleh penampung Microsoft Windows. Tentu saja, Anda perlu mengetahui apakah file spool adalah Enhanced Metafile (EMF) atau Xml Paper Specification (XPS). Jika Anda lebih suka bekerja dengan Stream API, Anda dapat menggunakan PrintQueueStream kelas alih-alih metode ini.

Setelah metode dipanggil AddJob , Anda harus menulis Byte array ke JobStream properti PrintSystemJobInfo yang dikembalikan oleh AddJob atau tidak ada pekerjaan cetak yang dibuat. Array inilah yang mencetak jika printer berfungsi dan tidak dijeda.

Perhatian

JobStream Jika tidak ditutup dengan Close sebelum akhir utas yang AddJob dipanggil, maka InvalidOperationException dilemparkan ketika utas tersebut berakhir karena utas penampung tidak dapat memperoleh kontrol atas Stream objek.

Di antarmuka pengguna grafis (GUI) antrean cetak, pekerjaan memiliki nama "Cetak Dokumen Sistem". Untuk memberi nama yang berbeda pada pekerjaan, gunakan AddJob(String) kelebihan beban.

Berlaku untuk

AddJob(String)

Menyisipkan pekerjaan cetak baru, yang kontennya adalah Byte array, ke dalam antrean.

public:
 System::Printing::PrintSystemJobInfo ^ AddJob(System::String ^ jobName);

public System.Printing.PrintSystemJobInfo AddJob (string jobName);

member this.AddJob : string -> System.Printing.PrintSystemJobInfo

Public Function AddJob (jobName As String) As PrintSystemJobInfo

Parameter

jobName: String

Nama pekerjaan cetak.

Mengembalikan

PrintSystemJobInfo

PrintSystemJobInfo yang mewakili pekerjaan cetak dan statusnya.

Contoh

Contoh berikut menunjukkan cara menggunakan AddJob(String) untuk membaca file ke dalam Byte array dan mengirim array ke antrean cetak. Kode ini mengasumsikan bahwa ada file yang disebut test.txt di akar drive C: . Kode ini hanya berfungsi dengan printer yang dapat mendeteksi dan mencetak teks biasa. Beberapa dari mereka tidak bisa.

// Create the printer server and print queue objects
LocalPrintServer localPrintServer2 = new LocalPrintServer();
PrintQueue defaultPrintQueue2 = LocalPrintServer.GetDefaultPrintQueue();

// Call AddJob 
PrintSystemJobInfo anotherPrintJob = defaultPrintQueue2.AddJob("MyJob");

// Read a file into a StreamReader
StreamReader myStreamReader = new StreamReader("C:\\test.txt");

// Write a Byte buffer to the JobStream and close the stream
Stream anotherStream = anotherPrintJob.JobStream;
Byte[] anotherByteBuffer = UnicodeEncoding.Unicode.GetBytes(myStreamReader.ReadToEnd());
anotherStream.Write(anotherByteBuffer, 0, anotherByteBuffer.Length);
anotherStream.Close();

' Create the printer server and print queue objects
Dim localPrintServer2 As New LocalPrintServer()
Dim defaultPrintQueue2 As PrintQueue = LocalPrintServer.GetDefaultPrintQueue()

' Call AddJob 
Dim anotherPrintJob As PrintSystemJobInfo = defaultPrintQueue2.AddJob("MyJob")

' Read a file into a StreamReader
Dim myStreamReader As New StreamReader("C:\test.txt")

' Write a Byte buffer to the JobStream and close the stream
Dim anotherStream As Stream = anotherPrintJob.JobStream
Dim anotherByteBuffer() As Byte = UnicodeEncoding.Unicode.GetBytes(myStreamReader.ReadToEnd())
anotherStream.Write(anotherByteBuffer, 0, anotherByteBuffer.Length)
anotherStream.Close()

Keterangan

Perhatian

Berlaku untuk

Bagikan melalui

PrintQueue.AddJob Metode

Definisi

Overload

Keterangan

AddJob(String, String, Boolean, PrintTicket)

Parameter

Mengembalikan

Keterangan

Berlaku untuk

AddJob(String, PrintTicket)

Parameter

Mengembalikan

Keterangan

Berlaku untuk

AddJob(String, String, Boolean)

Parameter

Mengembalikan

Contoh

Keterangan

Lihat juga

Berlaku untuk

AddJob()

Mengembalikan

Contoh

Keterangan

Berlaku untuk

AddJob(String)

Parameter

Mengembalikan

Contoh

Keterangan

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: