Aracılığıyla paylaş


PrintQueue.AddJob Yöntem

Tanım

Kuyruğa yeni bir yazdırma işi ekler.

Aşırı Yüklemeler

AddJob(String, String, Boolean, PrintTicket)

Bir XML Kağıt Belirtimi (XPS) Belgesi için kuyruğa yeni bir yazdırma işi ekler, belirtilen adı ve ayarları verir ve doğrulanıp doğrulanmayacağını belirtir.

AddJob(String, PrintTicket)

Kuyruğa XML Kağıt Belirtimi (XPS) Belgesi için yeni bir yazdırma işi ekler ve belirtilen adı ve ayarları verir.

AddJob(String, String, Boolean)

Bir XML Kağıt Belirtimi (XPS) Belgesi için kuyruğa yeni bir yazdırma işi ekler, belirtilen adı verir ve doğrulanıp doğrulanmayacağını belirtir.

AddJob()

kuyruğa içeriği dizi olan yeni (genel olarak adlandırılmış) bir Byte yazdırma işi ekler.

AddJob(String)

İçeriği Byte dizi olan yeni bir yazdırma işini kuyruğa ekler.

Açıklamalar

Kuyruk duraklatılmadığı veya hata durumunda olmadığı sürece, iş kuyruğun en üstüne ulaştığında yazdırılır, bu nedenle bu bir yazdırma işlevidir.

Windows Presentation Foundation(WPF) içinde yazdırmanın PrintDialog.PrintDocument diğer yolları arasında iletişim kutusunu açmadan veya açmadan kullanılabilecek yöntemi ve birçok Write ve WriteAsync yöntemi bulunurXpsDocumentWriter.

AddJob(String, String, Boolean, PrintTicket)

Bir XML Kağıt Belirtimi (XPS) Belgesi için kuyruğa yeni bir yazdırma işi ekler, belirtilen adı ve ayarları verir ve doğrulanıp doğrulanmayacağını belirtir.

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

Parametreler

jobName
String

Yazdırılmakta olan belgenin yolu ve adı.

documentPath
String

Yazdırılmakta olan belgenin yolu ve adı.

fastCopy
Boolean

true sayfa sayfa ilerleme geri bildirimi olmadan ve dosyanın geçerli XPS olduğunu doğrulamadan hızlı bir şekilde biriktirmek için; aksi takdirde , false.

printTicket
PrintTicket

Yazdırma işinin ayarları.

Döndürülenler

PrintSystemJobInfo Yazdırma işini ve durumunu temsil eden bir.

Açıklamalar

Daha fazla bilgi için bkz. AddJob(String, String, Boolean).

Şunlara uygulanır

AddJob(String, PrintTicket)

Kuyruğa XML Kağıt Belirtimi (XPS) Belgesi için yeni bir yazdırma işi ekler ve belirtilen adı ve ayarları verir.

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

Parametreler

jobName
String

Yazdırılmakta olan belgenin yolu ve adı.

printTicket
PrintTicket

Yazdırma işinin ayarları.

Döndürülenler

PrintSystemJobInfo Yazdırma işini ve durumunu temsil eden bir.

Açıklamalar

Daha fazla bilgi için bkz. AddJob(String).

Şunlara uygulanır

AddJob(String, String, Boolean)

Bir XML Kağıt Belirtimi (XPS) Belgesi için kuyruğa yeni bir yazdırma işi ekler, belirtilen adı verir ve doğrulanıp doğrulanmayacağını belirtir.

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

Parametreler

jobName
String

Yazdırma işinin adı.

documentPath
String

Yazdırılmakta olan belgenin yolu ve adı.

fastCopy
Boolean

true sayfa sayfa ilerleme geri bildirimi olmadan ve dosyanın geçerli XPS olduğunu doğrulamadan hızlı bir şekilde biriktirmek için; aksi takdirde , false.

Döndürülenler

PrintSystemJobInfo Yazdırma işini ve durumunu temsil eden bir.

Örnekler

Aşağıdaki örnekte, bir dizindeki tüm XML Kağıt Belirtimi (XPS) dosyalarını toplu olarak yazdırmak için nasıl kullanılacağı AddJob(String, String, Boolean) gösterilmektedir.

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

Açıklamalar

ise fastCopytrue, yazıcının Yazdırmaya Genel Bakış olması gerekir. Değilse, AddJob(String, String, Boolean) yöntemi bir özel durum oluşturur.

ise fastCopyfalse, XPSDrv yazıcısı kullanmak gerekmez. Kuyruğa eklenen XPS dosyası, yazıcının PCL veya Postscript gibi sayfa açıklama diline dönüştürülür. Ancak, bu tür yazdırma, Bileşen Nesne Modeli'ne (COM) bir çağrı yapar. COM çağrısı, çağıran iş parçacığının Microsoft .NET 2.0 ve sonraki sürümlerde varsayılan olan birden çok iş parçacıklı daire () yerine tek iş parçacıklı bir daireyeSTA (MTA) sahip olmasını gerektirir. (İş parçacığı oluşturma ve apartman durumları hakkında daha fazla bilgi için bkz. Yönetilen ve Yönetilmeyen İş Parçacığı Oluşturma ve ApartmentState.) Bunu yapmanın iki yolu vardır:

  • En basit yol, uygulama yönteminin STAThreadAttribute ilk satırının hemen üstüne ("") eklemektir (genellikle "static void Main(string[] args)").Main[System.STAThreadAttribute()]

  • İş parçacığınızın Main apartman durumunun olması MTAgerekiyorsa, çağrısını AddJob(String, String, Boolean) ile olarak ayarlanmış STASetApartmentStateayrı bir iş parçacığında barındırabilirsiniz. Aşağıdaki örnekte bu ikinci teknik gösterilmektedir.

Not

dışında herhangi bir yönteme uygulayamazsınız STAThreadAttribute ve iş parçacığı için Main kullanamazsınızSetApartmentState.Main

Windows Presentation Foundation(WPF) içinde yazdırmanın PrintDialog.PrintDocument diğer yolları arasında iletişim kutusunu açmadan veya açmadan kullanılabilecek yöntemi ve birçok Write ve WriteAsync yöntemi bulunurXpsDocumentWriter.

Ayrıca bkz.

Şunlara uygulanır

AddJob()

kuyruğa içeriği dizi olan yeni (genel olarak adlandırılmış) bir Byte yazdırma işi ekler.

public:
 System::Printing::PrintSystemJobInfo ^ AddJob();
public System.Printing.PrintSystemJobInfo AddJob ();
member this.AddJob : unit -> System.Printing.PrintSystemJobInfo
Public Function AddJob () As PrintSystemJobInfo

Döndürülenler

PrintSystemJobInfo Yazdırma işini ve durumunu temsil eden bir.

Örnekler

Aşağıdaki örnekte, bir Byte diziyi yazdırma kuyruğuna göndermek için nasıl kullanılacağı AddJob() gösterilmektedir. Bu kod yalnızca düz metin algılayıp yazdırabilen yazıcılarla çalışır. Bazıları yapamaz.

// 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()

Açıklamalar

Microsoft Windows biriktiricisi tarafından otomatik olarak dahil edilmeyen bir biriktirici dosyasına cihaza özgü bilgileri yazmak için bu yöntemi kullanın. Elbette, biriktirici dosyasının Gelişmiş Meta Dosyası (EMF) veya XML Kağıt Belirtimi (XPS) olup olmadığını bilmeniz gerekir. API ile Stream çalışmayı tercih ederseniz, bu yöntem yerine sınıfını PrintQueueStream kullanabilirsiniz.

AddJob yöntemi çağrıldıktan sonra, tarafından AddJob döndürülen veya hiçbir yazdırma işi oluşturulmamış olan özelliğine PrintSystemJobInfo bir Byte dizi JobStream yazmanız gerekir. Yazıcı çalışıyorsa ve duraklatılmıyorsa bu dizi yazdırılır.

Dikkat

JobStream çağrılan iş parçacığının AddJob sonundan önce ile Close kapatılmazsa, biriktirici iş parçacığı nesne üzerinde Stream denetim elde edemediğinden bu iş parçacığı sona erdiğinde bir InvalidOperationException oluşturulur.

Yazdırma kuyruğunun grafik kullanıcı arabiriminde (GUI), işin adı "Yazdırma Sistemi Belgesi". İşe farklı bir ad vermek için aşırı yüklemeyi kullanın AddJob(String) .

Windows Presentation Foundation(WPF) içinde yazdırmanın PrintDialog.PrintDocument diğer yolları arasında iletişim kutusunu açmadan veya açmadan kullanılabilecek yöntemi ve birçok Write ve WriteAsync yöntemi bulunurXpsDocumentWriter.

Şunlara uygulanır

AddJob(String)

İçeriği Byte dizi olan yeni bir yazdırma işini kuyruğa ekler.

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

Parametreler

jobName
String

Yazdırma işinin adı.

Döndürülenler

PrintSystemJobInfo Yazdırma işini ve durumunu temsil eden bir.

Örnekler

Aşağıdaki örnekte, bir dosyayı bir diziye Byte okumak ve diziyi yazdırma kuyruğuna göndermek için nasıl kullanılacağı AddJob(String) gösterilmektedir. Bu kod, C: sürücüsünün kökünde test.txt adlı bir dosya olduğunu varsayar. Bu kod yalnızca düz metin algılayıp yazdırabilen yazıcılarla çalışır. Bazıları yapamaz.

// 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()

Açıklamalar

Microsoft Windows biriktiricisi tarafından otomatik olarak dahil edilmeyen bir biriktirici dosyasına cihaza özgü bilgileri yazmak için bu yöntemi kullanın. Elbette, biriktirici dosyasının Gelişmiş Meta Dosyası (EMF) veya XML Kağıt Belirtimi (XPS) olup olmadığını bilmeniz gerekir. API ile Stream çalışmayı tercih ederseniz, bu yöntem yerine sınıfını PrintQueueStream kullanabilirsiniz.

AddJob yöntemi çağrıldıktan sonra, tarafından AddJob döndürülen veya hiçbir yazdırma işi oluşturulmamış olan özelliğine PrintSystemJobInfo bir Byte dizi JobStream yazmanız gerekir. Yazıcı çalışıyorsa ve duraklatılmıyorsa bu dizi yazdırılır.

Dikkat

JobStream çağrılan iş parçacığının AddJob sonundan önce ile Close kapatılmazsa, biriktirici iş parçacığı nesne üzerinde Stream denetim elde edemediğinden bu iş parçacığı sona erdiğinde bir InvalidOperationException oluşturulur.

Windows Presentation Foundation(WPF) içinde yazdırmanın PrintDialog.PrintDocument diğer yolları arasında iletişim kutusunu açmadan veya açmadan kullanılabilecek yöntemi ve birçok Write ve WriteAsync yöntemi bulunurXpsDocumentWriter.

Şunlara uygulanır