LocalPrintServer Classe

Definizione

Spazio dei nomi:

System.Printing

Assembly:

System.Printing.dll

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::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 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)
GetDefaultPrintQueue()	Restituisce un riferimento alla coda di stampa predefinita dell'oggetto LocalPrintServer.
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)
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)
Refresh()	Aggiorna le proprietà dell'oggetto LocalPrintServer in modo che i relativi valori corrispondano ai valori del server di stampa rappresentato dall'oggetto.

Vedi anche

• PrintServer