LocalPrintServer Classe

Riferimento

Definizione

Spazio dei nomi:: System.Printing

Assembly:: System.Printing.dll

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à: Object

PrintSystemObject

PrintServer
LocalPrintServer

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)

Si applica a

Vedi anche

PrintServer