PrintQueue.AddJob Methode

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

Parameters

Retouren

Een PrintSystemJobInfo die de afdruktaak en de status vertegenwoordigt.

Opmerkingen

Zie AddJob(String, String, Boolean) voor meer informatie.

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

Parameters

Retouren

Een PrintSystemJobInfo die de afdruktaak en de status vertegenwoordigt.

Opmerkingen

Zie AddJob(String) voor meer informatie.

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

Parameters

Retouren

Een PrintSystemJobInfo die de afdruktaak en de status vertegenwoordigt.

Voorbeelden

In het volgende voorbeeld ziet u hoe AddJob(String, String, Boolean) u batchgewijs alle XPS-bestanden (XML Paper Specification) in een map afdrukt.

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

Opmerkingen

Als fastCopy dat het is true, moet de printer een afdrukoverzicht zijn. Als dat niet het is, genereert de AddJob(String, String, Boolean) methode een uitzondering.

Als fastCopy dat het is false, is het niet nodig om een XPSDrv-printer te gebruiken. Het XPS-bestand dat aan de wachtrij wordt toegevoegd, wordt geconverteerd naar de paginabeschrijvingstaal van de printer, zoals PCL of Postscript. Dit type afdrukken doet echter een aanroep naar Component Object Model (COM). De aanroep van COM vereist dat de gespreksthread een appartement met één thread heeft (STA) in plaats van een appartement met meerdere threads (MTA), wat de standaardinstelling is. Er zijn twee manieren om dit te doen:

• De eenvoudigste manier is om de STAThreadAttribute (dat wil gezegd, "[System.STAThreadAttribute()]") toe te voegen net boven de eerste regel van de methode van de toepassing Main (meestal "static void Main(string[] args)").

• Als u de appartementsstatus van uw Main thread nodig hebt, MTAkunt u de oproep AddJob(String, String, Boolean) in een aparte thread plaatsen wiens appartementsstatus is ingesteld STA op .SetApartmentState In het onderstaande voorbeeld ziet u deze tweede techniek.

Andere manieren om af te drukken in Windows Presentation Foundation (WPF) zijn de methode PrintDialog.PrintDocument, die kan worden gebruikt met of zonder het dialoogvenster te openen, en de vele methoden Write en WriteAsync van de XpsDocumentWriter.

Zie ook

• ApartmentState
• STAThreadAttribute
• COM-onderdelen beschikbaar maken voor .NET Framework
• isXPS-Conformiteitstool

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

public System.Printing.PrintSystemJobInfo AddJob();

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

Public Function AddJob () As PrintSystemJobInfo

Retouren

Een PrintSystemJobInfo die de afdruktaak en de status vertegenwoordigt.

Voorbeelden

In het volgende voorbeeld ziet u hoe AddJob() u een Byte matrix naar een afdrukwachtrij verzendt. Deze code werkt alleen met printers die tekst zonder opmaak kunnen detecteren en afdrukken. Sommigen kunnen dat niet.

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

Opmerkingen

Gebruik deze methode om apparaatspecifieke informatie te schrijven naar een spoolbestand dat niet automatisch wordt opgenomen door de Microsoft Windows-spooler. Natuurlijk moet u weten of het spoolbestand Enhanced Metafile (EMF) of XML Paper Specification (XPS) is. Als u liever met de Stream API werkt, kunt u de PrintQueueStream klasse gebruiken in plaats van deze methode.

Nadat de AddJob methode is aangeroepen, moet u een Byte matrix schrijven naar de eigenschap van de JobStreamPrintSystemJobInfo eigenschap die wordt geretourneerd door AddJob of er geen afdruktaak wordt gemaakt. Deze matrix wordt afgedrukt als de printer werkt en niet wordt onderbroken.

In de grafische gebruikersinterface (GUI) van de afdrukwachtrij heeft de taak de naam 'Print System Document'. Gebruik de AddJob(String) overbelasting om de taak een andere naam te geven.

Andere manieren om af te drukken in Windows Presentation Foundation (WPF) zijn de methode PrintDialog.PrintDocument, die kan worden gebruikt met of zonder het dialoogvenster te openen, en de vele methoden Write en WriteAsync van de XpsDocumentWriter.

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

Parameters

Retouren

Een PrintSystemJobInfo die de afdruktaak en de status vertegenwoordigt.

Voorbeelden

In het volgende voorbeeld ziet u hoe AddJob(String) u een bestand in een Byte matrix leest en de matrix naar een afdrukwachtrij verzendt. Bij deze code wordt ervan uitgegaan dat er een bestand met de naam test.txt in de hoofdmap van het station C: staat. Deze code werkt alleen met printers die tekst zonder opmaak kunnen detecteren en afdrukken. Sommigen kunnen dat niet.

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

Opmerkingen

Gebruik deze methode om apparaatspecifieke informatie te schrijven naar een spoolbestand dat niet automatisch wordt opgenomen door de Microsoft Windows-spooler. Natuurlijk moet u weten of het spoolbestand Enhanced Metafile (EMF) of XML Paper Specification (XPS) is. Als u liever met de Stream API werkt, kunt u de PrintQueueStream klasse gebruiken in plaats van deze methode.

Nadat de AddJob methode is aangeroepen, moet u een Byte matrix schrijven naar de eigenschap van de JobStreamPrintSystemJobInfo eigenschap die wordt geretourneerd door AddJob of er geen afdruktaak wordt gemaakt. Deze matrix wordt afgedrukt als de printer werkt en niet wordt onderbroken.

Andere manieren om af te drukken in Windows Presentation Foundation (WPF) zijn de methode PrintDialog.PrintDocument, die kan worden gebruikt met of zonder het dialoogvenster te openen, en de vele methoden Write en WriteAsync van de XpsDocumentWriter.