PrintServer 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.
Gestisce le code di stampa su un server di stampa, che generalmente è un computer, ma può anche essere costituito da un dispositivo hardware dedicato.
public ref class PrintServer : System::Printing::PrintSystemObject
public class PrintServer : System.Printing.PrintSystemObject
type PrintServer = class
inherit PrintSystemObject
Public Class PrintServer
Inherits PrintSystemObject
- Ereditarietà
- Derivato
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, usare 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 per il PrintServer programma disponga dei valori più recenti, usare il Refresh metodo per l'oggetto.
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
PrintServer() |
Inizializza una nuova istanza della classe PrintServer. |
PrintServer(PrintSystemDesiredAccess) |
Inizializza una nuova istanza della classe PrintServer che rappresenta il server di stampa locale e le assegna l'oggetto PrintSystemDesiredAccess specificato. |
PrintServer(String) |
Inizializza una nuova istanza della classe PrintServer con il percorso specificato. |
PrintServer(String, PrintServerIndexedProperty[]) |
Inizializza una nuova istanza della classe PrintServer utilizzando la matrice PrintServerIndexedProperty specificata per determinare le proprietà da inizializzare. |
PrintServer(String, PrintServerIndexedProperty[], PrintSystemDesiredAccess) |
Inizializza una nuova istanza della classe PrintServer e fornisce il percorso specificato, la matrice PrintServerIndexedProperty e l'accesso necessario. |
PrintServer(String, PrintSystemDesiredAccess) |
Inizializza una nuova istanza della classe PrintServer con il percorso specificato e l'accesso necessario. |
PrintServer(String, String[]) |
Inizializza una nuova istanza della classe PrintServer con il percorso e il filtro delle proprietà specificati. |
PrintServer(String, String[], PrintSystemDesiredAccess) |
Inizializza una nuova istanza della classe PrintServer con il percorso e il filtro delle proprietà specificati e l'accesso necessario. |
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. |
DefaultPortThreadPriority |
Non usare. |
DefaultSchedulerPriority |
Non usare. |
DefaultSpoolDirectory |
Ottiene o imposta il percorso dei file di spooling del server di stampa. |
EventLog |
Ottiene o imposta i tipi di eventi registrati dal server di stampa. |
IsDelayInitialized |
Ottiene o imposta un valore che indica se l'inizializzazione delle proprietà PrintServer è 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 specifica l'invio di notifiche relative al completamento di un processo di stampa 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 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. |
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. |
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 dello spooler di stampa. |
Metodi
Commit() |
Esegue il commit di qualsiasi modifica apportata dal programma alle proprietà dell'oggetto server di stampa scrivendole nel server di stampa rappresentato dall'oggetto. |
DeletePrintQueue(PrintQueue) |
Rimuove l'oggetto PrintQueue specificato 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, le risorse gestite. (Ereditato da PrintSystemObject) |
Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
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. |
GetPrintQueue(String, String[]) |
Ottiene una coda di stampa specifica dal server di stampa. |
GetPrintQueues() |
Ottiene l'insieme delle code di stampa ospitate dal server di stampa. |
GetPrintQueues(EnumeratedPrintQueueTypes[]) |
Ottiene l'insieme delle code di stampa dei tipi specificati, indicate in EnumeratedPrintQueueTypes e ospitate dal server di stampa. |
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. |
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. |
GetPrintQueues(String[]) |
Ottiene un insieme di code di stampa ospitate dal server di stampa e di cui vengono inizializzate unicamente le proprietà specificate. |
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. |
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. |
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes) |
Installa una coda di stampa e il driver della stampante associato sul 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 sul 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 sul server di stampa. |
InternalDispose(Boolean) |
Rilascia le risorse non gestite usate da PrintServer ed eventualmente rilascia le risorse gestite. |
MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
Refresh() |
Aggiorna le proprietà dell'oggetto PrintServer in modo che ogni valore delle proprietà corrisponda al valore del relativo attributo del server di stampa rappresentato dall'oggetto. |
ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |