PrintQueue.AddJob 메서드

정의

네임스페이스:: System.Printing

어셈블리:: System.Printing.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

큐에 새 인쇄 작업을 삽입합니다.

오버로드

Name	Description
AddJob(String, String, Boolean, PrintTicket)	XPS(XML Paper Specification) 문서의 새 인쇄 작업을 큐에 삽입하고 지정된 이름과 설정을 지정하며 유효성을 검사해야 하는지 여부를 지정합니다.
AddJob(String, PrintTicket)	XPS(XML Paper Specification) 문서의 새 인쇄 작업을 큐에 삽입하고 지정된 이름과 설정을 지정합니다.
AddJob(String, String, Boolean)	XPS(XML Paper Specification) 문서의 새 인쇄 작업을 큐에 삽입하고 지정된 이름을 지정하며 유효성을 검사해야 하는지 여부를 지정합니다.
AddJob()	콘텐츠 Byte 가 배열인 새(일반적으로 명명된) 인쇄 작업을 큐에 삽입합니다.
AddJob(String)	콘텐츠 Byte 가 배열인 새 인쇄 작업을 큐에 삽입합니다.

설명

큐가 일시 중지되거나 오류 상태가 아니면 작업이 큐의 맨 위에 도달하면 인쇄되므로 인쇄 함수입니다.

WPF(Windows Presentation Foundation)에서 인쇄하는 다른 방법으로는 대화 상자를 열거나 열지 않고 사용할 수 있는 메서드와 Write 여러 메서드 및 WriteAsync 메서드가 XpsDocumentWriter포함 PrintDialog.PrintDocument 됩니다.

AddJob(String, String, Boolean, PrintTicket)

XPS(XML Paper Specification) 문서의 새 인쇄 작업을 큐에 삽입하고 지정된 이름과 설정을 지정하며 유효성을 검사해야 하는지 여부를 지정합니다.

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

매개 변수

jobName: String

인쇄할 문서의 경로와 이름입니다.

documentPath: String

인쇄할 문서의 경로와 이름입니다.

fastCopy: Boolean

true페이지별 진행률 피드백 없이 파일이 유효한 XPS인지 확인하지 않고 신속하게 스풀링합니다. 그렇지 않으면 . false

printTicket: PrintTicket

인쇄 작업의 설정입니다.

반품

PrintSystemJobInfo

인쇄 작업 및 해당 상태를 나타내는 A PrintSystemJobInfo 입니다.

설명

자세한 내용은 AddJob(String, String, Boolean)를 참조하세요.

적용 대상

AddJob(String, PrintTicket)

XPS(XML Paper Specification) 문서의 새 인쇄 작업을 큐에 삽입하고 지정된 이름과 설정을 지정합니다.

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

매개 변수

jobName: String

인쇄할 문서의 경로와 이름입니다.

printTicket: PrintTicket

인쇄 작업의 설정입니다.

반품

PrintSystemJobInfo

인쇄 작업 및 해당 상태를 나타내는 A PrintSystemJobInfo 입니다.

설명

자세한 내용은 AddJob(String)를 참조하세요.

적용 대상

AddJob(String, String, Boolean)

XPS(XML Paper Specification) 문서의 새 인쇄 작업을 큐에 삽입하고 지정된 이름을 지정하며 유효성을 검사해야 하는지 여부를 지정합니다.

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

매개 변수

jobName: String

인쇄 작업의 이름입니다.

documentPath: String

인쇄할 문서의 경로와 이름입니다.

fastCopy: Boolean

true페이지별 진행률 피드백 없이 파일이 유효한 XPS인지 확인하지 않고 신속하게 스풀링합니다. 그렇지 않으면 . false

반품

PrintSystemJobInfo

인쇄 작업 및 해당 상태를 나타내는 A PrintSystemJobInfo 입니다.

예제

다음 예제에서는 디렉터리의 모든 XPS(XML Paper Specification) 파일을 일괄 인쇄하는 방법을 AddJob(String, String, Boolean) 보여 줍니다.

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

설명

이 경우 fastCopy 프린터는 인쇄 개요여야 합니다.true 그렇지 않은 경우 메서드는 AddJob(String, String, Boolean) 예외를 throw합니다.

false이 경우 fastCopy XPSDrv 프린터를 사용할 필요가 없습니다. 큐에 추가되는 XPS 파일은 PCL 또는 Postscript와 같은 프린터의 페이지 설명 언어로 변환됩니다. 그러나 이러한 종류의 인쇄는 COM(구성 요소 개체 모델)을 호출합니다. COM을 호출하려면 호출 스레드에 기본값인 다중 스레드 아파트(STA)가 아닌 단일 스레드 아파트(MTA)가 있어야 합니다. 이 작업을 수행하는 방법에는 두 가지가 있습니다.

가장 간단한 방법은 애플리케이션 Main 메서드의 첫 번째 줄 바로 위에 (즉, "[System.STAThreadAttribute()]")를 추가하는 STAThreadAttribute 것입니다(일반적으로 "static void Main(string[] args)").
스레드의 아파트 상태가 필요한 Main 경우 해당 아파트 상태가 MTA로 SetApartmentState설정된 별도의 스레드에 호출 AddJob(String, String, Boolean) 을 STA 저장할 수 있습니다. 아래 예제에서는 이 두 번째 기술을 보여 줍니다.

메모

스레드에 STAThreadAttribute 사용할 SetApartmentState 수 없는 경우를 제외하고 Main 메서드에 Main 적용할 수 없습니다.

추가 정보

적용 대상

AddJob()

콘텐츠 Byte 가 배열인 새(일반적으로 명명된) 인쇄 작업을 큐에 삽입합니다.

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

public System.Printing.PrintSystemJobInfo AddJob();

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

Public Function AddJob () As PrintSystemJobInfo

반품

PrintSystemJobInfo

인쇄 작업 및 해당 상태를 나타내는 A PrintSystemJobInfo 입니다.

예제

다음 예제에서는 인쇄 큐에 AddJob() 배열을 Byte 보내는 방법을 보여 드립니다. 이 코드는 일반 텍스트를 감지하고 인쇄할 수 있는 프린터에서만 작동합니다. 그들 중 일부는 할 수 없습니다.

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

설명

이 메서드를 사용하여 Microsoft Windows 스풀러에 의해 자동으로 포함되지 않는 디바이스 관련 정보를 스풀 파일에 씁니다. 물론 스풀 파일이 EMF(Enhanced Metafile) 또는 XPS(XML Paper Specification)인지 여부를 알아야 합니다. API를 Stream 사용하려는 경우 이 메서드 대신 클래스를 PrintQueueStream 사용할 수 있습니다.

메서드가 AddJob 호출된 후에는 인쇄 작업이 만들어지지 않거나 반환되는 속성 PrintSystemJobInfo 에 AddJob 배열 JobStream 을 작성 Byte 해야 합니다. 이 배열은 프린터가 작동하고 일시 중지되지 않은 경우 인쇄됩니다.

주의

JobStream 호출 InvalidOperationException 되는 스레드 AddJob 의 끝 이전에 닫혀 Close 있지 않으면 스풀러 스레드가 개체를 제어 Stream 할 수 없기 때문에 해당 스레드가 종료될 때 throw됩니다.

인쇄 큐의 GUI(그래픽 사용자 인터페이스)에서 작업 이름은 "인쇄 시스템 문서"입니다. 작업에 다른 이름을 지정하려면 오버로드를 AddJob(String) 사용합니다.

적용 대상

AddJob(String)

콘텐츠 Byte 가 배열인 새 인쇄 작업을 큐에 삽입합니다.

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

매개 변수

jobName: String

인쇄 작업의 이름입니다.

반품

PrintSystemJobInfo

인쇄 작업 및 해당 상태를 나타내는 A PrintSystemJobInfo 입니다.

예제

다음 예제에서는 배열에 AddJob(String) 파일을 읽고 인쇄 큐에 Byte 배열을 보내는 방법을 보여 드립니다. 이 코드는 C: 드라이브의 루트에 test.txt 파일이 있다고 가정합니다. 이 코드는 일반 텍스트를 감지하고 인쇄할 수 있는 프린터에서만 작동합니다. 그들 중 일부는 할 수 없습니다.

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

설명

주의

적용 대상

피드백

이 페이지가 도움이 되었나요?

다음을 통해 공유

PrintQueue.AddJob 메서드

정의

오버로드

설명

AddJob(String, String, Boolean, PrintTicket)

매개 변수

반품

설명

적용 대상

AddJob(String, PrintTicket)

매개 변수

반품

설명

적용 대상

AddJob(String, String, Boolean)

매개 변수

반품

예제

설명

추가 정보

적용 대상

AddJob()

반품

예제

설명

적용 대상

AddJob(String)

매개 변수

반품

예제

설명

적용 대상

피드백