PrintServer Classe

Definizione

Spazio dei nomi:

System.Printing

Assembly:

System.Printing.dll

Gestisce le code di stampa in un server di stampa, che in genere è un computer, ma può essere un'appliance server di stampa hardware dedicata.

public ref class PrintServer : System::Printing::PrintSystemObject

public class PrintServer : System.Printing.PrintSystemObject

type PrintServer = class
    inherit PrintSystemObject

Public Class PrintServer
Inherits PrintSystemObject

Ereditarietà

Object

PrintSystemObject

PrintServer

Derivato

System.Printing.LocalPrintServer

Esempio

Nell'esempio seguente viene illustrato come creare un'istanza di PrintServer.

// Create a PrintServer
// "theServer" must be a print server to which the user has full print access.
PrintServer myPrintServer = new PrintServer(@"\\theServer");

// List the print server's queues
PrintQueueCollection myPrintQueues = myPrintServer.GetPrintQueues();
String printQueueNames = "My Print Queues:\n\n";
foreach (PrintQueue pq in myPrintQueues)
{
    printQueueNames += "\t" + pq.Name + "\n";
}
Console.WriteLine(printQueueNames);
Console.WriteLine("\nPress Return to continue.");
Console.ReadLine();

' Create a PrintServer
' "theServer" must be a print server to which the user has full print access.
Dim myPrintServer As New PrintServer("\\theServer")

' List the print server's queues
Dim myPrintQueues As PrintQueueCollection = myPrintServer.GetPrintQueues()
Dim printQueueNames As String = "My Print Queues:" & vbLf & vbLf
For Each pq As PrintQueue In myPrintQueues
    printQueueNames &= vbTab & pq.Name & vbLf
Next pq
Console.WriteLine(printQueueNames)
Console.WriteLine(vbLf & "Press Return to continue.")
Console.ReadLine()

Commenti

Quando il programma scrive un valore in una proprietà di PrintServer, tale modifica non ha alcun effetto finché non viene passata al computer rappresentato dall'oggetto PrintServer . Per eseguire il commit delle modifiche, utilizzare il Commit metodo per l'oggetto .

Analogamente, altre applicazioni possono modificare le proprietà effettive del servizio di stampa del computer. Per assicurarsi che l'oggetto PrintServer per il programma abbia i valori più recenti, utilizzare il Refresh metodo per l'oggetto .

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
PrintServer()	Inizializza una nuova istanza della classe PrintServer.
PrintServer(PrintSystemDesiredAccess)	Inizializza una nuova istanza della PrintServer classe che rappresenta il server di stampa locale e lo assegna all'oggetto specificato PrintSystemDesiredAccess.
PrintServer(String, PrintServerIndexedProperty[], PrintSystemDesiredAccess)	Inizializza una nuova istanza della PrintServer classe e fornisce il percorso specificato, la PrintServerIndexedProperty matrice e l'accesso necessario.
PrintServer(String, PrintServerIndexedProperty[])	Inizializza una nuova istanza della PrintServer classe utilizzando la matrice specificata PrintServerIndexedProperty per determinare quali proprietà verranno inizializzate.
PrintServer(String, PrintSystemDesiredAccess)	Inizializza una nuova istanza della PrintServer classe con il percorso specificato e l'accesso necessario.
PrintServer(String, String[], PrintSystemDesiredAccess)	Inizializza una nuova istanza della PrintServer classe con il percorso, il filtro delle proprietà e l'accesso necessario.
PrintServer(String, String[])	Inizializza una nuova istanza della PrintServer classe con il percorso e il filtro delle proprietà specificati.
PrintServer(String)	Inizializza una nuova istanza della PrintServer classe con il percorso specificato.

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.
DefaultPortThreadPriority	Non utilizzare.
DefaultSchedulerPriority	Non utilizzare.
DefaultSpoolDirectory	Ottiene o imposta il percorso in cui si trovano i file di spooling del server di stampa.
EventLog	Ottiene o imposta il tipo di eventi che il server di stampa registra.
IsDelayInitialized	Ottiene o imposta un valore che indica se l'inizializzazione PrintServer delle proprietà è stata posticipata.
IsDisposed	Ottiene o imposta un valore che indica se l'oggetto è stato eliminato. (Ereditato da PrintSystemObject)
MajorVersion	Ottiene la versione principale del sistema operativo.
MinorVersion	Ottiene la versione secondaria all'interno della versione principale del sistema operativo.
Name	Ottiene il nome del server di stampa.
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.
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.
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.
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.
SchedulerPriority	Ottiene o imposta la priorità del thread per il processo che indirizza i processi di stampa dalle applicazioni alle code di stampa.
SubSystemVersion	Ottiene la versione del sistema di spooler di stampa.

Metodi

Nome	Descrizione
Commit()	Esegue il commit delle modifiche apportate dal programma alle proprietà dell'oggetto server di stampa scrivendole nel server di stampa rappresentato dall'oggetto .
DeletePrintQueue(PrintQueue)	Rimuove l'oggetto specificato PrintQueue dal server di stampa.
DeletePrintQueue(String)	Rimuove la coda di stampa con il nome specificato dal server di stampa.
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)
GetPrintQueue(String, String[])	Ottiene una coda di stampa specificata dal server di stampa.
GetPrintQueue(String)	Ottiene un riferimento alla coda di stampa denominata dal server di stampa.
GetPrintQueues()	Ottiene l'insieme di code di stampa ospitate dal server di stampa.
GetPrintQueues(EnumeratedPrintQueueTypes[])	Ottiene l'insieme di code di stampa dei tipi specificati denominati in EnumeratedPrintQueueTypes e ospitati dal server di stampa.
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.
GetPrintQueues(PrintQueueIndexedProperty[])	Ottiene un insieme di code di stampa ospitate dal server di stampa e inizializzate solo nelle proprietà specificate nella PrintQueueIndexedProperty matrice.
GetPrintQueues(String[], EnumeratedPrintQueueTypes[])	Ottiene la raccolta di code di stampa, che sono dell'oggetto specificato EnumeratedPrintQueueTypes e vengono inizializzate solo nelle proprietà specificate.
GetPrintQueues(String[])	Ottiene un insieme di code di stampa ospitate dal server di stampa e inizializzate solo nelle proprietà specificate.
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.
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.
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.
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes)	Installa una coda di stampa e il driver della stampante associato nel server di stampa.
InternalDispose(Boolean)	Rilascia le risorse non gestite usate da PrintServer e, facoltativamente, rilascia le risorse gestite.
Refresh()	Aggiorna le proprietà dell'oggetto PrintServer in modo che ogni valore della proprietà corrisponda al valore dell'attributo corrispondente del server di stampa rappresentato dall'oggetto.

Vedi anche

• PrintQueue
• LocalPrintServer