PrintQueue Classe

Definizione

Spazio dei nomi:

System.Printing

Assembly:

System.Printing.dll

Gestisce stampanti e processi di stampa.

public ref class PrintQueue : System::Printing::PrintSystemObject

public class PrintQueue : System.Printing.PrintSystemObject

type PrintQueue = class
    inherit PrintSystemObject

Public Class PrintQueue
Inherits PrintSystemObject

Ereditarietà

Object

PrintSystemObject

PrintQueue

Commenti

Alcune proprietà dell'oggetto PrintQueue rappresentano le caratteristiche dell'utilità di accodamento di stampa eseguita nel computer, ma altre rappresentano caratteristiche o stati della stampante stessa. Ad esempio, NumberOfJobs è una caratteristica della coda di stampa, ma Location è una proprietà della stampante. Molte delle proprietà della stampante, ad esempio se necessita di attenzione da parte dell'utente, devono essere passate, tramite il Refresh metodo , dalla stampante stessa all'oggetto PrintQueue . Questa operazione deve essere eseguita prima che la proprietà corrispondente (NeedUserIntervention) venga letta dal programma. Analogamente, quando il programma modifica i valori di una o più proprietà di un PrintQueue oggetto, la modifica deve essere scritta nell'utilità di accodamento di stampa effettiva nel computer. Eseguire questa operazione con il Commit metodo .

Caution

Le classi all'interno dello spazio dei System.Printing nomi non sono supportate per l'uso all'interno di un servizio Windows o di un'applicazione o di un servizio ASP.NET. Il tentativo di usare queste classi all'interno di uno di questi tipi di applicazione può generare problemi imprevisti, ad esempio le prestazioni del servizio ridotte e le eccezioni in fase di esecuzione.

Per stampare da un'applicazione Windows Form, vedere lo spazio dei System.Drawing.Printing nomi .

Costruttori

Nome	Descrizione
PrintQueue(PrintServer, String, Int32, PrintSystemDesiredAccess)	Inizializza una nuova istanza della classe utilizzando il nome della PrintQueue coda, la PrintServerversione dello schema di stampa e l'accesso desiderato specificati.
PrintQueue(PrintServer, String, Int32)	Inizializza una nuova istanza della classe utilizzando il nome della PrintQueue coda e la versione dello schema di stampa specificati PrintServer.
PrintQueue(PrintServer, String, PrintQueueIndexedProperty[], PrintSystemDesiredAccess)	Inizializza una nuova istanza della classe con il nome della PrintQueue coda, la matrice di PrintQueueIndexedProperty valori specificati PrintServerper inizializzare e l'accesso desiderato.
PrintQueue(PrintServer, String, PrintQueueIndexedProperty[])	Inizializza una nuova istanza della classe utilizzando il nome della PrintQueue coda e la matrice di PrintQueueIndexedProperty valori specificati PrintServerda inizializzare.
PrintQueue(PrintServer, String, PrintSystemDesiredAccess)	Inizializza una nuova istanza della classe utilizzando il nome della PrintQueue coda e l'accesso desiderato specificati PrintServer.
PrintQueue(PrintServer, String, String[], PrintSystemDesiredAccess)	Inizializza una nuova istanza della classe utilizzando il nome della PrintQueue coda, il filtro delle proprietà e l'accesso desiderato specificati PrintServer.
PrintQueue(PrintServer, String, String[])	Inizializza una nuova istanza della classe utilizzando il nome della PrintQueue coda e la matrice di nomi di proprietà specificati PrintServerda inizializzare.
PrintQueue(PrintServer, String)	Inizializza una nuova istanza della PrintQueue classe utilizzando il nome della coda e specificato PrintServer .

Proprietà

Nome	Descrizione
AveragePagesPerMinute	Ottiene la velocità della stampante misurata in pagine al minuto.
ClientPrintSchemaVersion	Ottiene la versione dello schema di stampa.
Comment	Ottiene o imposta un commento sulla stampante.
CurrentJobSettings	Ottiene un oggetto contenente le impostazioni di configurazione per il processo di stampa corrente.
DefaultPrintTicket	Ottiene o imposta le opzioni predefinite della stampante associate all'oggetto PrintQueue.
DefaultPriority	Ottiene o imposta la priorità predefinita assegnata a ogni nuovo processo di stampa aggiunto alla coda.
Description	Ottiene una descrizione della coda di stampa.
FullName	Ottiene il nome completo della coda.
HasPaperProblem	Ottiene un valore che indica se la stampante presenta un problema di carta non specificato.
HasToner	Ottiene un valore che indica se la stampante dispone di toner.
HostingPrintServer	Ottiene o imposta (protetto) il server di stampa che controlla la coda di stampa.
InPartialTrust	Ottiene o imposta un valore che indica se la coda opera in modalità parzialmente attendibile, un livello di attendibilità superiore.
IsBidiEnabled	Ottiene un valore che indica se la comunicazione bidirezionale con la stampante è abilitata.
IsBusy	Ottiene un valore che indica se il dispositivo di stampa è occupato.
IsDevQueryEnabled	Ottiene un valore che indica se la coda contiene documenti quando le configurazioni di documenti e stampanti non corrispondono.
IsDirect	Ottiene un valore che indica se la coda stampa direttamente nella stampante o esegue lo spooling dei documenti e quindi li stampa.
IsDisposed	Ottiene o imposta un valore che indica se l'oggetto è stato eliminato. (Ereditato da PrintSystemObject)
IsDoorOpened	Ottiene un valore che indica se una porta è aperta sulla stampante.
IsHidden	Ottiene un valore che indica se la coda di stampa è nascosta nell'interfaccia utente dell'applicazione.
IsInError	Ottiene un valore che indica se la stampante o il dispositivo si trova in una condizione di errore.
IsInitializing	Ottiene un valore che indica se la stampante sta inizializzando se stessa.
IsIOActive	Ottiene un valore che indica se la stampante riceve o invia dati o segnali.
IsManualFeedRequired	Ottiene un valore che indica se la stampante deve essere alimentato manualmente per il processo di stampa corrente.
IsNotAvailable	Ottiene un valore che indica se la stampante è disponibile.
IsOffline	Ottiene un valore che indica se la stampante è offline.
IsOutOfMemory	Ottiene un valore che indica se la stampante non è in memoria.
IsOutOfPaper	Ottiene un valore che indica se la stampante deve essere ricaricata con carta delle dimensioni necessarie per il processo corrente.
IsOutputBinFull	Ottiene un valore che indica se l'area di output della stampante è in pericolo di overflow.
IsPaperJammed	Ottiene un valore che indica se il foglio di carta corrente è bloccato nella stampante.
IsPaused	Ottiene un valore che indica se la coda di stampa è stata sospesa.
IsPendingDeletion	Ottiene un valore che indica se la stampante è in corso di eliminazione di un processo di stampa.
IsPowerSaveOn	Ottiene un valore che indica se la stampante è in modalità risparmio energia.
IsPrinting	Ottiene un valore che indica se un processo sta stampando.
IsProcessing	Ottiene un valore che indica se la stampante sta elaborando un processo di stampa.
IsPublished	Ottiene un valore che indica se la stampante è visibile ad altri utenti di rete.
IsQueued	Ottiene un valore che indica se la stampante può supportare una coda con più processi di stampa alla volta.
IsRawOnlyEnabled	Ottiene un valore che indica se la coda di stampa può usare EMF (Enhanced Meta File) che consente un flusso di dati più veloce da un'applicazione di stampa allo spooler di Windows.
IsServerUnknown	Ottiene un valore che indica se la stampante è in uno stato di errore.
IsShared	Ottiene un valore che indica se la stampante è disponibile per l'uso da parte di altri computer in rete.
IsTonerLow	Ottiene un valore che indica se la stampante è in esecuzione a corto di toner.
IsWaiting	Ottiene un valore che indica se la coda è in attesa dell'aggiunta di un processo.
IsWarmingUp	Ottiene un valore che indica se la stampante sta riscaldando.
IsXpsDevice	Ottiene un valore che indica se il driver della stampante è basato sul modello XPSDrv in modo che usi XML Paper Specification (XPS) come linguaggio di descrizione della pagina.
KeepPrintedJobs	Ottiene un valore che indica se la coda sta salvando il file della lingua della stampante anziché eliminarlo dopo la stampa.
Location	Ottiene o imposta la posizione fisica della stampante.
MaxPrintSchemaVersion	Ottiene il numero di versione più recente possibile dello schema di stampa che la coda può utilizzare.
Name	Ottiene o imposta il nome della coda di stampa.
NeedUserIntervention	Ottiene un valore che indica se la stampante richiede l'attenzione di un essere umano.
NumberOfJobs	Ottiene il numero totale di processi allineati nella coda di stampa.
PagePunt	Ottiene un valore che indica se la stampante non è in grado di stampare la pagina corrente.
Parent	Ottiene l'elemento padre dell'oggetto . (Ereditato da PrintSystemObject)
PrintingIsCancelled	Ottiene o imposta un valore che indica se il processo di stampa corrente viene annullato.
Priority	Ottiene o imposta la priorità della coda di stampa rispetto ad altre code di stampa ospitate dallo stesso server di stampa e che utilizzano la stessa stampante fisica.
PropertiesCollection	Ottiene una raccolta di coppie di attributi e valori. (Ereditato da PrintSystemObject)
QueueAttributes	Ottiene le proprietà della coda di stampa.
QueueDriver	Ottiene o imposta il driver della stampante per la coda.
QueuePort	Ottiene o imposta la porta utilizzata dalla coda.
QueuePrintProcessor	Ottiene o imposta il processore di stampa utilizzato dalla coda.
QueueStatus	Ottiene un valore che rappresenta lo stato della stampante. Questi includono "riscaldamento", "inizializzazione", "stampa" e altri.
ScheduleCompletedJobsFirst	Ottiene un valore che indica se la stampante stampa i processi che hanno completato il processo di spooling prima dei processi che non hanno eseguito il pool completo anche se quest'ultimo ha immesso la coda per primo o ha una priorità più alta.
SeparatorFile	Ottiene o imposta il percorso e il nome file di un file inserito all'inizio di ogni processo di stampa.
ShareName	Ottiene o imposta un nome per la stampante visualizzata dagli utenti della rete quando viene condivisa.
StartTimeOfDay	Ottiene o imposta la prima ora del giorno, espressa come numero di minuti dopo la mezzanotte utc (Coordinated Universal Time) (chiamata anche Ora utc di Greenwich [GMT]), che la stampante stamperà un processo.
UntilTimeOfDay	Ottiene o imposta l'ora più recente, espressa come numero di minuti dopo la mezzanotte utc (Coordinated Universal Time) (chiamata anche Ora utc di Greenwich), che la stampante stamperà un processo.
UserPrintTicket	Ottiene o imposta l'oggetto predefinito PrintTicket dell'utente corrente, che contiene informazioni dettagliate sul processo di stampa.

Metodi

Nome	Descrizione
AddJob()	Inserisce un nuovo processo di stampa (denominato genericamente) il cui contenuto è una Byte matrice nella coda.
AddJob(String, PrintTicket)	Inserisce un nuovo processo di stampa per un documento XPS (XML Paper Specification) nella coda e assegna il nome e le impostazioni specificati.
AddJob(String, String, Boolean, PrintTicket)	Inserisce un nuovo processo di stampa per un documento XPS (XML Paper Specification) nella coda, assegna il nome e le impostazioni specificati e specifica se deve essere convalidato o meno.
AddJob(String, String, Boolean)	Inserisce un nuovo processo di stampa per un documento XPS (XML Paper Specification) nella coda, assegna il nome specificato e specifica se deve essere convalidato o meno.
AddJob(String)	Inserisce un nuovo processo di stampa, il cui contenuto è una Byte matrice, nella coda.
Commit()	Scrive le proprietà correnti dell'oggetto PrintQueue nella coda di stampa effettiva nel server di stampa.
CreateXpsDocumentWriter(Double, Double)	Crea un XpsDocumentWriter oggetto con le dimensioni specificate.
CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)	Crea un XpsDocumentWriter oggetto, apre una finestra di dialogo di stampa comune di Windows, fornisce la finestra di dialogo con un intervallo di pagine e una descrizione del processo di stampa e restituisce un ref parametro (ByRef in Visual Basic) che rappresenta le informazioni sull'area stampabile e sulle dimensioni del supporto.
CreateXpsDocumentWriter(PrintDocumentImageableArea)	Crea un XpsDocumentWriter oggetto, apre una finestra di dialogo di stampa comune di Windows e restituisce un ref parametro (ByRef in Visual Basic) che rappresenta le informazioni sull'area stampabile e sulle dimensioni del supporto.
CreateXpsDocumentWriter(PrintQueue)	Crea un XpsDocumentWriter oggetto e lo associa alla coda di stampa specificata.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)	Crea un XpsDocumentWriter oggetto, apre una finestra di dialogo di stampa comune di Windows, fornisce la finestra di dialogo con un intervallo di pagine e restituisce un ref parametro (ByRef in Visual Basic) che rappresenta le informazioni sull'area stampabile e sulle dimensioni del supporto.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea)	Crea un XpsDocumentWriter oggetto, apre una finestra di dialogo di stampa comune di Windows e la fornisce una descrizione del processo e restituisce un ref parametro (ByRef in Visual Basic) che rappresenta le informazioni sull'area stampabile e sulle dimensioni del supporto.
Dispose()	Rilascia tutte le risorse usate da PrintSystemObject. (Ereditato da PrintSystemObject)
Dispose(Boolean)	Rilascia le risorse non gestite usate da PrintSystemObject e, facoltativamente, rilascia le risorse gestite. (Ereditato da PrintSystemObject)
GetJob(Int32)	Ottiene il processo di stampa con il numero ID specificato.
GetPrintCapabilities()	Ottiene un PrintCapabilities oggetto che identifica le funzionalità della stampante.
GetPrintCapabilities(PrintTicket)	Ottiene un PrintCapabilities oggetto che identifica le funzionalità della stampante.
GetPrintCapabilitiesAsXml()	Ottiene un MemoryStream oggetto che specifica le funzionalità della stampante come flusso XML conforme allo schema di stampa.
GetPrintCapabilitiesAsXml(PrintTicket)	Ottiene un MemoryStream oggetto che specifica le funzionalità della stampante in un formato XML conforme allo schema di stampa.
GetPrintJobInfoCollection()	Crea una raccolta contenente un PrintSystemJobInfo oggetto per ogni processo nella coda.
Initialize()	Inizializza le proprietà dell'oggetto PrintSystemObject. (Ereditato da PrintSystemObject)
InternalDispose(Boolean)	Rilascia le risorse non gestite usate da PrintQueue e, facoltativamente, rilascia le risorse gestite.
MergeAndValidatePrintTicket(PrintTicket, PrintTicket, PrintTicketScope)	Unisce due PrintTickets e garantisce che l'oggetto risultante PrintTicket sia valido, non richieda alcuna funzionalità di stampa non supportata dalla stampante e sia limitata all'ambito specificato.
MergeAndValidatePrintTicket(PrintTicket, PrintTicket)	Unisce due PrintTickets e garantisce che l'oggetto risultante PrintTicket sia valido e non richieda alcuna funzionalità di stampa non supportata dalla stampante.
Pause()	Sospende la coda di stampa. Rimane sospeso fino a quando Resume() non viene eseguito.
Purge()	Rimuove tutti i processi nella coda di stampa.
Refresh()	Aggiorna le proprietà dell'oggetto PrintQueue con i valori della stampante e l'utilità di accodamento di stampa eseguita nel computer.
Resume()	Riavvia una coda di stampa sospesa.

Vedi anche

• PrintServer