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 sul quale l'applicazione è in esecuzione) e attiva la gestione delle relative code di stampa.
public ref class LocalPrintServer sealed : System::Printing::PrintServer
public sealed class LocalPrintServer : System.Printing.PrintServer
type LocalPrintServer = class
inherit PrintServer
Public NotInheritable Class LocalPrintServer
Inherits PrintServer
- Ereditarietà
Esempio
Nell'esempio seguente viene illustrato come creare un'istanza della classe LocalPrintServer.
// -------------------- 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 System.Printing spazio dei nomi non sono supportate per l'uso all'interno di un servizio Windows o di ASP.NET applicazione o servizio. Il tentativo di usare queste classi all'interno di uno di questi tipi di applicazioni può generare problemi imprevisti, ad esempio le prestazioni del servizio ridotte e le eccezioni di runtime.
Se si desidera stampare da un'applicazione Windows Form, vedere lo spazio dei nomi System.Drawing.Printing.
Costruttori
LocalPrintServer() |
Inizializza una nuova istanza della classe LocalPrintServer. |
LocalPrintServer(LocalPrintServerIndexedProperty[]) |
Inizializza una nuova istanza della classe LocalPrintServer con la matrice LocalPrintServerIndexedProperty specificata. |
LocalPrintServer(LocalPrintServerIndexedProperty[], PrintSystemDesiredAccess) |
Inizializza una nuova istanza della classe LocalPrintServer con la matrice LocalPrintServerIndexedProperty e l'oggetto PrintSystemDesiredAccess specificati. |
LocalPrintServer(PrintSystemDesiredAccess) |
Inizializza una nuova istanza della classe LocalPrintServer con l'oggetto PrintSystemDesiredAccess specificato. |
LocalPrintServer(String[]) |
Inizializza una nuova istanza della classe LocalPrintServer con le proprietà specificate. |
LocalPrintServer(String[], PrintSystemDesiredAccess) |
Inizializza una nuova istanza della classe LocalPrintServer con le proprietà e l'oggetto PrintSystemDesiredAccess specificati. |
Proprietà
BeepEnabled |
Ottiene o imposta un valore che indica se il server di stampa emette un segnale acustico in risposta a una condizione di errore nella stampante. (Ereditato da PrintServer) |
DefaultPortThreadPriority |
Non usare. (Ereditato da PrintServer) |
DefaultPrintQueue |
Ottiene o imposta la coda di stampa predefinita. |
DefaultSchedulerPriority |
Non usare. (Ereditato da PrintServer) |
DefaultSpoolDirectory |
Ottiene o imposta il percorso dei file di spooling del server di stampa. (Ereditato da PrintServer) |
EventLog |
Ottiene o imposta i tipi di eventi registrati dal server di stampa. (Ereditato da PrintServer) |
IsDelayInitialized |
Ottiene o imposta un valore che indica se l'inizializzazione delle proprietà PrintServer è 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 specifica l'invio di notifiche relative al completamento di un processo di stampa 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 un insieme di coppie di attributi e valori. (Ereditato da PrintSystemObject) |
RestartJobOnPoolEnabled |
Ottiene o imposta un valore che indica la possibilità o meno per gli utenti di riavviare i processi dopo un errore se il pool di stampa è attivato. (Ereditato da PrintServer) |
RestartJobOnPoolTimeout |
Ottiene o imposta un valore che indica il tempo di attesa prima che sia possibile riavviare un processo in caso di errore, quando anche il pool di stampa è attivato. (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 dello spooler di stampa. (Ereditato da PrintServer) |
Metodi
Commit() |
Scrive qualsiasi modifica apportata 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 PrintQueue specificato. |
ConnectToPrintQueue(String) |
Effettua la connessione alla coda di stampa specificata utilizzando l'oggetto String. |
DisconnectFromPrintQueue(PrintQueue) |
Disconnette il server di stampa locale dall'oggetto PrintQueue specificato. |
DisconnectFromPrintQueue(String) |
Effettua la disconnessione 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, 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) |
Ottiene dal server di stampa un riferimento alla coda di stampa con il nome specificato. (Ereditato da PrintServer) |
GetPrintQueue(String, String[]) |
Ottiene una coda di stampa specifica dal server di stampa. (Ereditato da PrintServer) |
GetPrintQueues() |
Ottiene l'insieme delle code di stampa ospitate dal server di stampa. (Ereditato da PrintServer) |
GetPrintQueues(EnumeratedPrintQueueTypes[]) |
Ottiene l'insieme delle code di stampa dei tipi specificati, indicate in EnumeratedPrintQueueTypes e ospitate dal server di stampa. (Ereditato da PrintServer) |
GetPrintQueues(PrintQueueIndexedProperty[]) |
Ottiene un insieme di code di stampa ospitate dal server di stampa e di cui vengono inizializzate unicamente le proprietà specificate nella matrice PrintQueueIndexedProperty. (Ereditato da PrintServer) |
GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[]) |
Ottiene un insieme di code di stampa dei tipi specificati. Nella matrice PrintQueueIndexedProperty vengono specificate le uniche proprietà inizializzate di tali code di stampa. (Ereditato da PrintServer) |
GetPrintQueues(String[]) |
Ottiene un insieme di code di stampa ospitate dal server di stampa e di cui vengono inizializzate unicamente le proprietà specificate. (Ereditato da PrintServer) |
GetPrintQueues(String[], EnumeratedPrintQueueTypes[]) |
Ottiene l'insieme di code di stampa che appartengono all'oggetto EnumeratedPrintQueueTypes specificato e di cui vengono inizializzate solo le proprietà specificate. (Ereditato da PrintServer) |
GetType() |
Ottiene l'oggetto 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 sul server di stampa. (Ereditato da PrintServer) |
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes) |
Installa una coda di stampa e il driver della stampante associato sul 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 sul 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 sul server di stampa. (Ereditato da PrintServer) |
InternalDispose(Boolean) |
Rilascia le risorse non gestite usate da PrintServer ed eventualmente rilascia le risorse gestite. (Ereditato da PrintServer) |
MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (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) |