System.Printing Przestrzeń nazw

Zawiera klasy, które umożliwiają automatyzację zarządzania serwerami wydruku, kolejkami wydruku i zadaniami drukowania. Provides classes that enable you to automate the management of print servers, print queues, and print jobs.

Klasy

LocalPrintServer

Reprezentuje lokalny serwer wydruku (komputer, na którym uruchomiona jest aplikacja) i umożliwia zarządzanie jego kolejkami wydruku.Represents the local print server (the computer on which your application is running) and enables management of its print queues.

PageImageableArea

Przedstawia obszar strony, którą można wydrukować.Represents the area of a page that can be printed.

PageMediaSize

Opisuje rozmiar strony dla papieru lub innego nośnika.Describes the page size for paper or other media.

PageResolution

Definiuje rozdzielczość strony wydrukowanych danych wyjściowych w postaci wartości jakościowej lub kropek na cal lub obu.Defines the page resolution of printed output as either a qualitative value or as dots per inch, or both.

PageScalingFactorRange

Określa zakres wartości procentowych, przez które drukarka może powiększyć lub zmniejszyć obraz wydruku na stronie.Specifies a range of percentages by which a printer can enlarge or reduce the print image on a page.

PrintCapabilities

Definiuje możliwości drukarki.Defines the capabilities of a printer.

PrintCommitAttributesException

Wyjątek, który jest generowany, gdy warunek błędu uniemożliwia zatwierdzenie niektórych atrybutów przez a PrintSystemObject do rzeczywistego komputera, drukarki lub urządzenia reprezentowanego przez obiekt.The exception that is thrown when an error condition prevents some attributes from being committed by a PrintSystemObject to the actual computer, printer, or device that the object represents.

PrintDocumentImageableArea

Określa rozmiar papieru (lub innego nośnika), rozmiar obszaru do obrazu i lokalizację obszaru obrazu.Specifies the size of the paper (or other media), the size of the imageable area, and the location of the imageable area.

PrintDriver

Reprezentuje sterownik drukarki.Represents a print driver.

PrintFilter

Definiuje zachowanie usuwania, które jest wspólne dla PrintDriver klas i PrintProcessor .Defines disposal behavior that is common to both the PrintDriver and PrintProcessor classes. PrintFilter obsługuje infrastrukturę Windows Presentation Foundation (WPF) i nie jest przeznaczona do użycia bezpośrednio w kodzie.PrintFilter supports the Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

PrintingCanceledException

Wyjątek występujący, gdy kod próbuje uzyskać dostęp do anulowanego zadania drukowania.The exception that occurs when code attempts to access a canceled print job.

PrintingNotSupportedException

Wyjątek, który jest generowany, gdy operacja drukowania nie jest obsługiwana.The exception that is thrown when a printing operation is not supported.

PrintJobException

Wyjątek występujący, gdy zadanie drukowania nie działa prawidłowo.The exception that occurs when the print job does not run correctly.

PrintJobInfoCollection

Reprezentuje jeden lub więcej PrintSystemJobInfo obiektów.Represents one or more PrintSystemJobInfo objects.

PrintJobSettings

Opisuje zadanie drukowania.Describes a print job.

PrintPort

Reprezentuje port drukarki na serwerze wydruku.Represents a printer port on a print server. Do każdej kolejki wydruku jest przypisany port drukowania.Each print queue has a print port assigned to it.

PrintProcessor

Reprezentuje procesor wydruku na serwerze wydruku.Represents a print processor on a print server.

PrintQueue

Zarządza drukarkami i zadaniami drukowania.Manages printers and print jobs.

PrintQueueCollection

Reprezentuje kolekcję PrintQueue obiektów.Represents a collection of PrintQueue objects.

PrintQueueException

Wyjątek, który jest generowany, gdy warunek błędu uniemożliwia dostęp lub utworzenie elementu PrintQueue .The exception that is thrown when an error condition prevents the accessing or creation of a PrintQueue.

PrintQueueStream

Strumień reprezentujący zadanie drukowania w buforze w kolejce wydruku.A stream that represents a spooled print job in a print queue.

PrintQueueStringProperty

Reprezentuje jeden i tylko jedną z trzech możliwych właściwości kolejki wydruku: Location , Comment , lub ShareName .Represents one, and only one, of three possible properties of a print queue: Location, Comment, or ShareName.

PrintServer

Zarządza kolejkami wydruku na serwerze wydruku, który jest zwykle komputerem, ale może być dedykowanym sprzętem Server Appliance drukowania.Manages the print queues on a print server, which is usually a computer, but can be a dedicated hardware print server appliance.

PrintServerException

Wyjątek występujący, gdy warunek błędu uniemożliwia dostęp lub utworzenie elementu PrintServer .The exception that occurs when an error condition prevents the accessing or creation of a PrintServer.

PrintSystemException

Wyjątek występujący, gdy warunek błędu uniemożliwia dostęp do lub tworzenie PrintSystemObject .The exception that occurs when an error condition prevents accessing or creating a PrintSystemObject.

PrintSystemJobInfo

Definiuje szczegółowo zadanie drukowania.Defines a print job in detail.

PrintSystemObject

Definiuje podstawowe właściwości i metody, które są wspólne dla obiektów systemu drukowania.Defines basic properties and methods that are common to the objects of the printing system. Klasy, które pochodzą z tej klasy, reprezentują takie obiekty jak kolejki wydruku, serwery wydruku i zadania drukowania.Classes that derive from this class represent such objects as print queues, print servers, and print jobs.

PrintSystemObjectPropertiesChangedEventArgs

Dostarcza dane dla zdarzenia PropertiesChanged, które należy utworzyć.Provides data for a PropertiesChanged event, which you must create.

PrintSystemObjectPropertyChangedEventArgs

Dostarcza dane dla zdarzenia PropertyChanged, które należy utworzyć.Provides data for a PropertyChanged event, which you must create.

PrintSystemObjects

Reprezentuje kolekcję obiektów systemu drukowania.Represents a collection of print system objects.

PrintTicket

Definiuje ustawienia zadania drukowania.Defines the settings of a print job.

Struktury

ValidationResult

Reprezentuje scalone PrintTicket , które ma być opłacalne, wraz z raportem o wszystkich ustawieniach, które zostały zmienione w celu ich działania.Represents a merged PrintTicket that is guaranteed to be viable, with a report of any settings that were changed to make it viable.

Wyliczenia

Collation

Określa, czy drukarka sortuje dane wyjściowe, gdy drukuje wiele kopii wielostronicowego zadania drukowania.Specifies whether a printer collates output when it prints multiple copies of a multi-page print job.

ConflictStatus

Określa, czy zmiany zostały wprowadzone do Scalonej, PrintTicket Aby zapewnić ich żywotność PrintTicket .Specifies whether any changes were made to a merged PrintTicket to ensure a viable PrintTicket.

DeviceFontSubstitution

Określa, czy podstawianie czcionek urządzenia jest włączone na drukarce.Specifies whether device font substitution is enabled on a printer.

Duplexing

Określa, czy drukarka używa drukowania jednostronnego, czy pewnego typu dwustronnego druku.Specifies whether a printer uses one-sided printing or some type of two-sided (duplex) printing.

EnumeratedPrintQueueTypes

Określa atrybuty kolejek wydruku.Specifies attributes of print queues.

InputBin

Określa bin wejściowy, który jest używany jako źródło pustego papieru lub innego nośnika wydruku.Specifies the input bin that is used as the source of blank paper or other print media.

LocalPrintServerIndexedProperty

Określa właściwości LocalPrintServer obiektu, które są inicjowane podczas konstruowania.Specifies the properties of a LocalPrintServer object that are initialized when it is constructed.

OutputColor

Określa sposób drukowania zawartości zawierającej kolor lub odcienie szarości.Specifies how to print content that contains color or shades of gray.

OutputQuality

Określa typy jakości danych wyjściowych dla urządzenia drukującego.Specifies the types of output quality for a print device.

PageBorderless

Określa, czy urządzenie drukujące ma być drukowane na krawędzi nośnika, czy też nie ma marginesu na zewnątrz krawędzi.Specifies whether a print device prints to the edge of the media or provides an unprinted margin around the edge.

PageMediaSizeName

Określa rozmiar strony lub szerokość dokumentu lub inny nośnik wydruku.Specifies the page size or roll width of the paper or other print media.

PageMediaType

Określa typy drukowania papieru lub innego nośnika.Specifies types of printing paper or other media.

PageOrder

Określa, czy urządzenie drukujące drukuje dokumenty wielostronicowe od przodu do tyłu lub z powrotem do przodu.Specifies whether a print device prints multi-page documents from front-to-back or back-to-front.

PageOrientation

Określa, w jaki sposób strony zawartości są zorientowane na nośniku wydruku.Specifies how pages of content are oriented on print media.

PageQualitativeResolution

Określa rozdzielczość strony jako wartość jakościową, nieliczbową.Specifies the page resolution as a qualitative, non-numerical, value.

PagesPerSheetDirection

Określa układ stron, gdy więcej niż jedna strona zawartości pojawia się na jednej stronie nośnika drukowania.Specifies the arrangement of pages when more than one page of content appears on a single side of print media.

PhotoPrintingIntent

Określa jakość danych wyjściowych podczas drukowania fotografii. Sterownik drukarki tłumaczy PhotoPrintingIntent na wartości ilościowe w celu rozpoznania i innych czynników jakości.The printer driver translates the PhotoPrintingIntent into quantitative values for resolution and other quality factors.

PrintJobPriority

Określa nienumeryczny priorytet zadania drukowania względem innych zadań drukowania w kolejce wydruku.Specifies a non-numerical priority for a print job relative to other print jobs in the print queue.

PrintJobStatus

Określa bieżący stan zadania drukowania w kolejce wydruku.Specifies the current status of a print job in a print queue.

PrintJobType

Określa, czy zadanie drukowania używa specyfikacji dokumentu XML (XPS).Specifies whether the print job uses XML Paper Specification (XPS).

PrintQueueAttributes

Określa atrybuty kolejki wydruku i jej drukarki.Specifies the attributes of a print queue and its printer.

PrintQueueIndexedProperty

Określa właściwości, które są inicjowane podczas PrintQueue konstruowania obiektu.Specifies the properties that are initialized when a PrintQueue object is constructed.

PrintQueueStatus

Określa stan kolejki wydruku lub jej drukarki.Specifies the status of a print queue or its printer.

PrintQueueStringPropertyType

Określa zamierzone znaczenie elementu PrintQueueStringProperty .Specifies the intended meaning of a PrintQueueStringProperty.

PrintServerEventLoggingTypes

Określa typy zdarzeń, które mogą być rejestrowane przez PrintServer .Specifies the types of events that can be logged by a PrintServer.

PrintServerIndexedProperty

Określa właściwości PrintServer obiektu, które są inicjowane podczas konstruowania.Specifies the properties of a PrintServer object that are initialized when it is constructed.

PrintSystemDesiredAccess

Określa różne prawa dostępu (lub poziomy dostępu) do drukowania obiektów.Specifies the different access rights (or levels of access) for printing objects.

PrintSystemObjectLoadMode

Określa, czy właściwości obiektu są inicjowane podczas ładowania obiektu.Specifies whether the properties of an object are initialized when the object loads.

PrintTicketScope

Określa, czy PrintTicket ma zastosowanie do całego zadania drukowania, jednego dokumentu w ramach zadania drukowania, czy tylko strony w ramach zadania drukowania.Specifies whether a PrintTicket applies to an entire print job, one document within the print job, or just a page within the print job.

Stapling

Określa, czy drukarka ma zszywanie wielostronicowego dokumentu.Specifies whether, and where, a printer staples a multi-page document.

TrueTypeFontMode

Określa, w jaki sposób drukarka obsługuje tekst sformatowany czcionką TrueType.Specifies how a printer handles text that is formatted with a TrueType font.

Uwagi

Ta przestrzeń nazw zawiera następujące klasy podstawowe:This namespace contains the following core classes:

  • PrintSystemObjectKlasa, która jest klasą bazową dla innych podstawowych klas drukowania.The PrintSystemObject class, which is the base class for the other core printing classes.

  • PrintServerKlasa, która reprezentuje rzeczywisty serwer wydruku, zazwyczaj komputer.The PrintServer class, which represents an actual print server, usually a computer.

  • PrintQueueKlasa, która reprezentuje rzeczywistą kolejkę wydruku i jej drukarkę.The PrintQueue class, which represents an actual print queue and its printer.

  • PrintSystemJobInfoKlasa, która reprezentuje określone zadanie drukowania.The PrintSystemJobInfo class, which represents a particular print job.

  • PrintTicketKlasa, która instruuje drukarkę, jak przetwarzać zadanie drukowania.The PrintTicket class, which instructs the printer how to process a print job.

Klasy pochodne dla PrintSystemObject każdej z klas mają Commit metodę i Refresh .Classes derived from the PrintSystemObject class each have a Commit and a Refresh method. Należy użyć tych metod, aby upewnić się, że wystąpienia klas są zsynchronizowane ze składnikami sprzętu lub oprogramowania, które reprezentują.You must use these methods to ensure that instances of the classes are synchronized with the hardware or software components that they represent.

System.PrintingPrzestrzeń nazw zawiera również wiele wyliczeń, które opisują możliwości drukarki, takie jak to, czy drukarka może generować posortowane dane wyjściowe, oraz określać instrukcje dla drukarek, takie jak rozmiar papieru do użycia dla zadania drukowania.The System.Printing namespace also includes many enumerations that describe printer capabilities, such as whether a printer can produce collated output, and that specify instructions to printers, such as the paper size to use for a print job.

Ta przestrzeń nazw jest częścią udoskonalonych usług drukowania udostępnianych z Windows Presentation Foundation.This namespace is part of the enhanced printing services provided with Windows Presentation Foundation. Deweloperzy kodu zarządzanego używający Windows Forms muszą używać interfejsów API w System.Drawing.Printing przestrzeni nazw.Managed code developers using Windows Forms must use the APIs in the System.Drawing.Printing namespace.

Przestroga

Klasy w System.Printing przestrzeni nazw nie są obsługiwane do użycia w ramach usługi lub aplikacji ASP.NET lub usługi.Classes within the System.Printing namespace are not supported for use within a Windows service or ASP.NET application or service. Próba użycia tych klas z poziomu jednego z tych typów aplikacji może spowodować nieoczekiwane problemy, takie jak obniżenie wydajności usługi i wyjątki czasu wykonywania.Attempting to use these classes from within one of these application types may produce unexpected problems, such as diminished service performance and run-time exceptions.

Zobacz też