PrintQueue.AddJob PrintQueue.AddJob PrintQueue.AddJob PrintQueue.AddJob Method

Definición

Inserta un nuevo trabajo de impresión en la cola.Inserts a new print job into the queue.

Sobrecargas

AddJob(String, String, Boolean, PrintTicket) AddJob(String, String, Boolean, PrintTicket) AddJob(String, String, Boolean, PrintTicket)

Inserta un nuevo trabajo de impresión para un documento de XML Paper Specification (XPS)XML Paper Specification (XPS) en la cola, le asigna el nombre y configuración especificados e indica si se debe validar o no.Inserts a new print job for an XML Paper Specification (XPS)XML Paper Specification (XPS) Document into the queue, gives it the specified name and settings, and specifies whether or not it should be validated.

AddJob(String, PrintTicket) AddJob(String, PrintTicket) AddJob(String, PrintTicket)

Inserta un nuevo trabajo de impresión para un documento XML Paper Specification (XPS)XML Paper Specification (XPS) en la cola y le proporciona el nombre y los valores especificados.Inserts a new print job for an XML Paper Specification (XPS)XML Paper Specification (XPS) Document into the queue, and gives it the specified name and settings.

AddJob(String, String, Boolean) AddJob(String, String, Boolean) AddJob(String, String, Boolean) AddJob(String, String, Boolean)

Inserta un nuevo trabajo de impresión para un documento de XML Paper Specification (XPS)XML Paper Specification (XPS) en la cola, le asigna el nombre especificado e indica si se debe validar o no.Inserts a new print job for an XML Paper Specification (XPS)XML Paper Specification (XPS) Document into the queue, gives it the specified name, and specifies whether or not it should be validated.

AddJob() AddJob() AddJob() AddJob()

Inserta un nuevo (denominado de forma genérica) trabajo de impresión, cuyo contenido es una matriz Byte, en la cola.Inserts a new (generically named) print job, whose content is a Byte array, into the queue.

AddJob(String) AddJob(String) AddJob(String) AddJob(String)

Inserta un nuevo trabajo de impresión, cuyo contenido es una matriz Byte, en la cola.Inserts a new print job, whose content is a Byte array, into the queue.

Comentarios

A menos que la cola esté en pausa o en un estado de error, el trabajo se imprime cuando llega a la parte superior de la cola, por lo que se trata de una función de impresión.Unless the queue is paused or in an error state, the job prints when it reaches the top of the queue, so this is a printing function.

Otras formas de imprimir en Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) incluyen el PrintDialog.PrintDocument método, que se puede usar con o sin abrir el cuadro de diálogo, y Write con WriteAsync los XpsDocumentWriternumerosos métodos y de.Other ways to print in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) include the PrintDialog.PrintDocument method, which can be used with or without opening the dialog, and the many Write and WriteAsync methods of the XpsDocumentWriter.

AddJob(String, String, Boolean, PrintTicket) AddJob(String, String, Boolean, PrintTicket) AddJob(String, String, Boolean, PrintTicket)

Inserta un nuevo trabajo de impresión para un documento de XML Paper Specification (XPS)XML Paper Specification (XPS) en la cola, le asigna el nombre y configuración especificados e indica si se debe validar o no.Inserts a new print job for an XML Paper Specification (XPS)XML Paper Specification (XPS) Document into the queue, gives it the specified name and settings, and specifies whether or not it should be validated.

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

Parámetros

jobName
String String String String

Ruta de acceso y nombre del documento que se va a imprimir.The path and name of the document that is being printed.

documentPath
String String String String

Ruta de acceso y nombre del documento que se va a imprimir.The path and name of the document that is being printed.

fastCopy
Boolean Boolean Boolean Boolean

Es true si se va a poner en cola rápidamente sin proporcionar información sobre el progreso página por página y sin validar si es un archivo XPSXPS válido; de lo contrario, es false.true to spool quickly without page-by-page progress feedback and without validating that the file is valid XPSXPS; otherwise, false.

printTicket
PrintTicket PrintTicket PrintTicket PrintTicket

Los valores del trabajo de impresión.The settings of the print job.

Devoluciones

Objeto PrintSystemJobInfo que representa el trabajo de impresión y su estado.A PrintSystemJobInfo that represents the print job and its status.

Comentarios

Para obtener más información, vea AddJob(String, String, Boolean).For more information, see AddJob(String, String, Boolean).

AddJob(String, PrintTicket) AddJob(String, PrintTicket) AddJob(String, PrintTicket)

Inserta un nuevo trabajo de impresión para un documento XML Paper Specification (XPS)XML Paper Specification (XPS) en la cola y le proporciona el nombre y los valores especificados.Inserts a new print job for an XML Paper Specification (XPS)XML Paper Specification (XPS) Document into the queue, and gives it the specified name and settings.

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

Parámetros

jobName
String String String String

Ruta de acceso y nombre del documento que se va a imprimir.The path and name of the document that is being printed.

printTicket
PrintTicket PrintTicket PrintTicket PrintTicket

Los valores del trabajo de impresión.The settings of the print job.

Devoluciones

Objeto PrintSystemJobInfo que representa el trabajo de impresión y su estado.A PrintSystemJobInfo that represents the print job and its status.

Comentarios

Para obtener más información, vea AddJob(String).For more information, see AddJob(String).

AddJob(String, String, Boolean) AddJob(String, String, Boolean) AddJob(String, String, Boolean) AddJob(String, String, Boolean)

Inserta un nuevo trabajo de impresión para un documento de XML Paper Specification (XPS)XML Paper Specification (XPS) en la cola, le asigna el nombre especificado e indica si se debe validar o no.Inserts a new print job for an XML Paper Specification (XPS)XML Paper Specification (XPS) Document into the queue, gives it the specified name, and specifies whether or not it should be validated.

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

Parámetros

jobName
String String String String

Nombre del trabajo de impresión.The name of the print job.

documentPath
String String String String

Ruta de acceso y nombre del documento que se va a imprimir.The path and name of the document that is being printed.

fastCopy
Boolean Boolean Boolean Boolean

Es true si se va a poner en cola rápidamente sin proporcionar información sobre el progreso página por página y sin validar si es un archivo XPSXPS válido; de lo contrario, es false.true to spool quickly without page-by-page progress feedback and without validating that the file is valid XPSXPS; otherwise, false.

Devoluciones

Objeto PrintSystemJobInfo que representa el trabajo de impresión y su estado.A PrintSystemJobInfo that represents the print job and its status.

Ejemplos

En el ejemplo siguiente se muestra cómo AddJob(String, String, Boolean) usar para imprimir por lotes XML Paper Specification (XPS)XML Paper Specification (XPS) todos los archivos de un directorio.The following example shows how to use AddJob(String, String, Boolean) to batch print all the XML Paper Specification (XPS)XML Paper Specification (XPS) files in a directory.

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();
   
    }//end Main

}//end Program class

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

                }// end for each XPS file
           
            }//end if there are no XPS files in the directory

        }//end if the directory does not exist

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

    }// end PrintXPS method

}// end BatchXPSPrinter class
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

Comentarios

Si fastCopy estrue, la impresora debe ser una introducción a la impresión.If fastCopy is true, then the printer must be an Printing Overview. Si no es así, el AddJob(String, String, Boolean) método produce una excepción.If it is not, the AddJob(String, String, Boolean) method throws an exception.

Si fastCopy esfalse, no es necesario usar una impresora XPSDrv.If fastCopy is false, then it is not necessary to use an XPSDrv printer. El XPSXPS archivo que se va a agregar a la cola se convierte en el idioma de descripción de la página de la impresora, como PCL o PostScript.The XPSXPS file being added to the queue is converted to the printer's page description language, such as PCL or Postscript. Sin embargo, este tipo de impresión realiza una llamada Modelo de objetos componentes (COM)Component Object Model (COM)a.However, this kind of printing makes a call to Modelo de objetos componentes (COM)Component Object Model (COM). La llamada a COMCOM requiere que el subproceso que realiza la llamada tenga un contenedor uniproceso (STA) en lugar de un contenedor de variosMTAsubprocesos (), Microsoft .NETMicrosoft .NET que es el valor predeterminado en 2,0 y versiones posteriores.The call to COMCOM requires that the calling thread have a single-threaded apartment (STA) instead of multiple-threaded apartment (MTA) which is the default in Microsoft .NETMicrosoft .NET 2.0 and later. (Para obtener más información sobre los subprocesos y los Estados de apartamento, vea subprocesos administrados y no administrados, y ApartmentState). Hay dos formas de hacerlo:(For more on threading and apartment states, see Managed and Unmanaged Threading, and ApartmentState.) There are two ways of doing this:

  • La manera más sencilla consiste en agregar el STAThreadAttribute (es decir, "[System.STAThreadAttribute()]") justo encima de la primera línea del método de Main la aplicación (normalmentestatic void Main(string[] args)"").The simplest way is to add the STAThreadAttribute (that is, "[System.STAThreadAttribute()]") just above the first line of the application's Main method (usually "static void Main(string[] args)").

  • Si necesita que el Main estado de apartamento del subproceso MTAsea, puede hospedar la llamada AddJob(String, String, Boolean) a en un subproceso independiente cuyo estado de Apartamento STA esté SetApartmentStateestablecido en con.If you need your Main thread's apartment state to be MTA, you can house the call to AddJob(String, String, Boolean) in a separate thread whose apartment state is set to STA with SetApartmentState. En el ejemplo siguiente se muestra esta segunda técnica.The example below illustrates this second technique.

Nota

No se puede aplicar STAThreadAttribute a cualquier método excepto Main y no se puede SetApartmentState usar para Main el subproceso.You cannot apply the STAThreadAttribute to any method except Main and you cannot use SetApartmentState for the Main thread.

Otras formas de imprimir en Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) incluyen el PrintDialog.PrintDocument método, que se puede usar con o sin abrir el cuadro de diálogo, y Write con WriteAsync los XpsDocumentWriternumerosos métodos y de.Other ways to print in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) include the PrintDialog.PrintDocument method, which can be used with or without opening the dialog, and the many Write and WriteAsync methods of the XpsDocumentWriter.

Consulte también:

AddJob() AddJob() AddJob() AddJob()

Inserta un nuevo (denominado de forma genérica) trabajo de impresión, cuyo contenido es una matriz Byte, en la cola.Inserts a new (generically named) print job, whose content is a Byte array, into the queue.

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

Devoluciones

Objeto PrintSystemJobInfo que representa el trabajo de impresión y su estado.A PrintSystemJobInfo that represents the print job and its status.

Ejemplos

En el ejemplo siguiente se muestra cómo AddJob() utilizar para enviar Byte una matriz a una cola de impresión.The following example shows how to use AddJob() to send a Byte array to a print queue. Este código solo funciona con impresoras que pueden detectar e imprimir texto sin formato.This code only works with printers that can detect and print plain text. Algunos de ellos no pueden.Some of them cannot.

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

Comentarios

Utilice este método para escribir información específica del dispositivo en un archivo de cola de impresión, que no se incluye Microsoft WindowsMicrosoft Windows automáticamente en el administrador de trabajos de impresión.Use this method to write device specific information, to a spool file, that is not automatically included by the Microsoft WindowsMicrosoft Windows spooler. Por supuesto, debe saber si el archivo de cola de impresión Metarchivo mejorado (EMF)Enhanced Metafile (EMF) es XML Paper Specification (XPS)XML Paper Specification (XPS)o.Of course, you need to know whether the spool file is Metarchivo mejorado (EMF)Enhanced Metafile (EMF) or XML Paper Specification (XPS)XML Paper Specification (XPS). Si prefiere trabajar con Stream APIAPI, puede usar la PrintQueueStream clase en lugar de este método.If you prefer to work with the Stream APIAPI, you can use the PrintQueueStream class instead of this method.

Después de AddJob llamar al método, debe escribir una Byte matriz PrintSystemJobInfo en la JobStream propiedad del devuelto por AddJob o no se crea ningún trabajo de impresión.After the AddJob method has been called, you must write a Byte array to the JobStream property of the PrintSystemJobInfo that is returned by AddJob or no print job is created. Esta matriz es lo que se imprime si la impresora funciona y no está en pausa.This array is what prints if the printer is working and is not paused.

Precaución

AddJob Stream InvalidOperationException Si no Close está cerrado con antes del final del subproceso en el que se llama a, se produce una excepción cuando ese subproceso finaliza porque el subproceso del administrador de trabajos de impresión no puede obtener el control sobre el objeto. JobStreamIf the JobStream is not closed with Close before the end of the thread in which AddJob is called, then an InvalidOperationException is thrown when that thread ends because the spooler thread cannot gain control over the Stream object.

En la cola interfaz gráfica de usuario (GUI)graphical user interface (GUI)de impresión, el trabajo tiene el nombre "imprimir documento del sistema".In the print queue's interfaz gráfica de usuario (GUI)graphical user interface (GUI), the job has the name "Print System Document". Para asignar un nombre diferente al trabajo, utilice la AddJob(String) sobrecarga.To give the job a different name, use the AddJob(String) overload.

Otras formas de imprimir en Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) incluyen el PrintDialog.PrintDocument método, que se puede usar con o sin abrir el cuadro de diálogo, y Write con WriteAsync los XpsDocumentWriternumerosos métodos y de.Other ways to print in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) include the PrintDialog.PrintDocument method, which can be used with or without opening the dialog, and the many Write and WriteAsync methods of the XpsDocumentWriter.

AddJob(String) AddJob(String) AddJob(String) AddJob(String)

Inserta un nuevo trabajo de impresión, cuyo contenido es una matriz Byte, en la cola.Inserts a new print job, whose content is a Byte array, into the queue.

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

Parámetros

jobName
String String String String

Nombre del trabajo de impresión.The name of the print job.

Devoluciones

Objeto PrintSystemJobInfo que representa el trabajo de impresión y su estado.A PrintSystemJobInfo that represents the print job and its status.

Ejemplos

En el ejemplo siguiente se muestra cómo AddJob(String) utilizar para leer un archivo en Byte una matriz y enviar la matriz a una cola de impresión.The following example shows how to use AddJob(String) to read a file into a Byte array and send the array to a print queue. En este código se supone que hay un archivo denominado test. txt en la raíz de la unidad C:.This code assumes that there is a file called test.txt in the root of the C: drive. Este código solo funciona con impresoras que pueden detectar e imprimir texto sin formato.This code only works with printers that can detect and print plain text. Algunos de ellos no pueden.Some of them cannot.

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

Comentarios

Utilice este método para escribir información específica del dispositivo en un archivo de cola de impresión, que no se incluye Microsoft WindowsMicrosoft Windows automáticamente en el administrador de trabajos de impresión.Use this method to write device specific information, to a spool file, that is not automatically included by the Microsoft WindowsMicrosoft Windows spooler. Por supuesto, debe saber si el archivo de cola de impresión Metarchivo mejorado (EMF)Enhanced Metafile (EMF) es XML Paper Specification (XPS)XML Paper Specification (XPS)o.Of course, you need to know whether the spool file is Metarchivo mejorado (EMF)Enhanced Metafile (EMF) or XML Paper Specification (XPS)XML Paper Specification (XPS). Si prefiere trabajar con Stream APIAPI, puede usar la PrintQueueStream clase en lugar de este método.If you prefer to work with the Stream APIAPI, you can use the PrintQueueStream class instead of this method.

Después de AddJob llamar al método, debe escribir una Byte matriz PrintSystemJobInfo en la JobStream propiedad del devuelto por AddJob o no se crea ningún trabajo de impresión.After the AddJob method has been called, you must write a Byte array to the JobStream property of the PrintSystemJobInfo that is returned by AddJob or no print job is created. Esta matriz es lo que se imprime si la impresora funciona y no está en pausa.This array is what prints if the printer is working and is not paused.

Precaución

AddJob Stream InvalidOperationException Si no Close está cerrado con antes del final del subproceso en el que se llama a, se produce una excepción cuando ese subproceso finaliza porque el subproceso del administrador de trabajos de impresión no puede obtener el control sobre el objeto. JobStreamIf the JobStream is not closed with Close before the end of the thread in which AddJob is called, then an InvalidOperationException is thrown when that thread ends because the spooler thread cannot gain control over the Stream object.

Otras formas de imprimir en Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) incluyen el PrintDialog.PrintDocument método, que se puede usar con o sin abrir el cuadro de diálogo, y Write con WriteAsync los XpsDocumentWriternumerosos métodos y de.Other ways to print in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) include the PrintDialog.PrintDocument method, which can be used with or without opening the dialog, and the many Write and WriteAsync methods of the XpsDocumentWriter.

Se aplica a