LocalPrintServer Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta il server di stampa locale (il computer in cui è in esecuzione l'applicazione) e consente la gestione delle code di stampa.
public ref class LocalPrintServer sealed : System::Printing::PrintServerpublic sealed class LocalPrintServer : System.Printing.PrintServertype LocalPrintServer = class
inherit PrintServerPublic NotInheritable Class LocalPrintServer
Inherits PrintServer- Ereditarietà
Esempio
Nell'esempio seguente viene illustrato come creare un'istanza della LocalPrintServer classe .
// -------------------- GetPrintXpsDocumentWriter() -------------------
/// <summary>
/// Returns an XpsDocumentWriter for the default print queue.</summary>
/// <returns>
/// An XpsDocumentWriter for the default print queue.</returns>
private XpsDocumentWriter GetPrintXpsDocumentWriter()
{
// Create a local print server
LocalPrintServer ps = new LocalPrintServer();
// Get the default print queue
PrintQueue pq = ps.DefaultPrintQueue;
// Get an XpsDocumentWriter for the default print queue
XpsDocumentWriter xpsdw = PrintQueue.CreateXpsDocumentWriter(pq);
return xpsdw;
}// end:GetPrintXpsDocumentWriter()
' -------------------- GetPrintXpsDocumentWriter() -------------------
''' <summary>
''' Returns an XpsDocumentWriter for the default print queue.</summary>
''' <returns>
''' An XpsDocumentWriter for the default print queue.</returns>
Private Function GetPrintXpsDocumentWriter() As XpsDocumentWriter
' Create a local print server
Dim ps As New LocalPrintServer()
' Get the default print queue
Dim pq As PrintQueue = ps.DefaultPrintQueue
' Get an XpsDocumentWriter for the default print queue
Dim xpsdw As XpsDocumentWriter = PrintQueue.CreateXpsDocumentWriter(pq)
Return xpsdw
End Function ' end:GetPrintXpsDocumentWriter()
Commenti
Quando l'applicazione scrive un valore in una proprietà dell'oggetto LocalPrintServer , tale modifica non ha alcun effetto finché il valore non viene passato al computer rappresentato dall'oggetto LocalPrintServer . Per assicurarsi che la modifica del valore sia effettiva, usare il Commit metodo .
Inoltre, altre applicazioni possono anche modificare le proprietà del servizio di stampa del computer. Per assicurarsi che l'oggetto LocalPrintServer usato dall'applicazione disponga dei valori effettivi più recenti, usare il Refresh metodo .
Attenzione
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 |
|---|---|
| LocalPrintServer() |
Inizializza una nuova istanza della classe LocalPrintServer. |
| LocalPrintServer(LocalPrintServerIndexedProperty[], PrintSystemDesiredAccess) |
Inizializza una nuova istanza della LocalPrintServer classe con la matrice specificata LocalPrintServerIndexedProperty e l'oggetto specificato PrintSystemDesiredAccess. |
| LocalPrintServer(LocalPrintServerIndexedProperty[]) |
Inizializza una nuova istanza della LocalPrintServer classe con la matrice specificata LocalPrintServerIndexedProperty . |
| LocalPrintServer(PrintSystemDesiredAccess) |
Inizializza una nuova istanza della LocalPrintServer classe con l'oggetto specificato PrintSystemDesiredAccess. |
| LocalPrintServer(String[], PrintSystemDesiredAccess) |
Inizializza una nuova istanza della LocalPrintServer classe con le proprietà specificate e PrintSystemDesiredAccess. |
| LocalPrintServer(String[]) |
Inizializza una nuova istanza della LocalPrintServer classe con le proprietà specificate. |
Proprietà
| Nome | Descrizione |
|---|---|
| BeepEnabled |
Ottiene o imposta un valore che indica se il bep del server di stampa in risposta a una condizione di errore nella stampante. (Ereditato da PrintServer) |
| DefaultPortThreadPriority |
Non utilizzare. (Ereditato da PrintServer) |
| DefaultPrintQueue |
Ottiene o imposta la coda di stampa predefinita. |
| DefaultSchedulerPriority |
Non utilizzare. (Ereditato da PrintServer) |
| DefaultSpoolDirectory |
Ottiene o imposta il percorso in cui si trovano i file di spooling del server di stampa. (Ereditato da PrintServer) |
| EventLog |
Ottiene o imposta il tipo di eventi che il server di stampa registra. (Ereditato da PrintServer) |
| IsDelayInitialized |
Ottiene o imposta un valore che indica se l'inizializzazione PrintServer delle proprietà è stata posticipata. (Ereditato da PrintServer) |
| IsDisposed |
Ottiene o imposta un valore che indica se l'oggetto è stato eliminato. (Ereditato da PrintSystemObject) |
| MajorVersion |
Ottiene la versione principale del sistema operativo. (Ereditato da PrintServer) |
| MinorVersion |
Ottiene la versione secondaria all'interno della versione principale del sistema operativo. (Ereditato da PrintServer) |
| Name |
Ottiene il nome del server di stampa. (Ereditato da PrintServer) |
| NetPopup |
Ottiene o imposta un valore che indica se le notifiche completate da un processo di stampa vengono inviate al server di stampa o al computer client. (Ereditato da PrintServer) |
| Parent |
Ottiene l'elemento padre dell'oggetto . (Ereditato da PrintSystemObject) |
| PortThreadPriority |
Ottiene o imposta la priorità del thread per il processo che gestisce l'I/O tramite le porte della stampante. (Ereditato da PrintServer) |
| PropertiesCollection |
Ottiene una raccolta di coppie di attributi e valori. (Ereditato da PrintSystemObject) |
| RestartJobOnPoolEnabled |
Ottiene o imposta un valore che indica se gli utenti possono riavviare i processi dopo che si verifica un errore se il pool di stampanti è abilitato. (Ereditato da PrintServer) |
| RestartJobOnPoolTimeout |
Ottiene o imposta un valore che indica il tempo di attesa prima del riavvio di un processo, se si verifica un errore quando è abilitato anche il pool di stampanti. (Ereditato da PrintServer) |
| SchedulerPriority |
Ottiene o imposta la priorità del thread per il processo che indirizza i processi di stampa dalle applicazioni alle code di stampa. (Ereditato da PrintServer) |
| SubSystemVersion |
Ottiene la versione del sistema di spooler di stampa. (Ereditato da PrintServer) |
Metodi
| Nome | Descrizione |
|---|---|
| Commit() |
Scrive tutte le modifiche apportate dall'applicazione alle proprietà dell'oggetto LocalPrintServer nel server di stampa effettivo rappresentato dall'oggetto . |
| ConnectToPrintQueue(PrintQueue) |
Connette il server di stampa locale all'oggetto specificato PrintQueue. |
| ConnectToPrintQueue(String) |
Si connette alla coda di stampa specificata utilizzando .String |
| DisconnectFromPrintQueue(PrintQueue) |
Disconnette il server di stampa locale dall'oggetto specificato PrintQueue. |
| DisconnectFromPrintQueue(String) |
Disconnette dalla coda di stampa specificata in String. |
| 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) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetDefaultPrintQueue() |
Restituisce un riferimento alla coda di stampa predefinita dell'oggetto LocalPrintServer. |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetPrintQueue(String, String[]) |
Ottiene una coda di stampa specificata dal server di stampa. (Ereditato da PrintServer) |
| GetPrintQueue(String) |
Ottiene un riferimento alla coda di stampa denominata dal server di stampa. (Ereditato da PrintServer) |
| GetPrintQueues() |
Ottiene l'insieme di code di stampa ospitate dal server di stampa. (Ereditato da PrintServer) |
| GetPrintQueues(EnumeratedPrintQueueTypes[]) |
Ottiene l'insieme di code di stampa dei tipi specificati denominati in EnumeratedPrintQueueTypes e ospitati dal server di stampa. (Ereditato da PrintServer) |
| GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[]) |
Ottiene una raccolta di code di stampa dei tipi specificati. Queste code di stampa vengono inizializzate solo nelle proprietà specificate nella PrintQueueIndexedProperty matrice. (Ereditato da PrintServer) |
| GetPrintQueues(PrintQueueIndexedProperty[]) |
Ottiene un insieme di code di stampa ospitate dal server di stampa e inizializzate solo nelle proprietà specificate nella PrintQueueIndexedProperty matrice. (Ereditato da PrintServer) |
| GetPrintQueues(String[], EnumeratedPrintQueueTypes[]) |
Ottiene la raccolta di code di stampa, che sono dell'oggetto specificato EnumeratedPrintQueueTypes e vengono inizializzate solo nelle proprietà specificate. (Ereditato da PrintServer) |
| GetPrintQueues(String[]) |
Ottiene un insieme di code di stampa ospitate dal server di stampa e inizializzate solo nelle proprietà specificate. (Ereditato da PrintServer) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| Initialize() |
Inizializza le proprietà dell'oggetto PrintSystemObject. (Ereditato da PrintSystemObject) |
| InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary) |
Installa una coda di stampa e il driver della stampante associato nel server di stampa. (Ereditato da PrintServer) |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) |
Installa una coda di stampa con priorità e il driver della stampante associato nel server di stampa. (Ereditato da PrintServer) |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) |
Installa una coda di stampa condivisa, con priorità e il driver della stampante associato nel server di stampa. (Ereditato da PrintServer) |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes) |
Installa una coda di stampa e il driver della stampante associato nel server di stampa. (Ereditato da PrintServer) |
| InternalDispose(Boolean) |
Rilascia le risorse non gestite usate da PrintServer e, facoltativamente, rilascia le risorse gestite. (Ereditato da PrintServer) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| Refresh() |
Aggiorna le proprietà dell'oggetto LocalPrintServer in modo che i relativi valori corrispondano ai valori del server di stampa rappresentato dall'oggetto. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
