PrintServer Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Gère les files d'attente à l'impression sur un serveur d'impression qui est habituellement un ordinateur mais peut être un appareil dédié du serveur d'impression.
public ref class PrintServer : System::Printing::PrintSystemObject
public class PrintServer : System.Printing.PrintSystemObject
type PrintServer = class
inherit PrintSystemObject
Public Class PrintServer
Inherits PrintSystemObject
- Héritage
- Dérivé
Exemples
L’exemple suivant montre comment créer un instance de 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()
Remarques
Lorsque votre programme écrit une valeur dans une propriété de PrintServer, cette modification n’a aucun effet tant qu’elle n’est pas transmise à l’ordinateur représenté par l’objet PrintServer . Pour valider les modifications, utilisez la Commit méthode pour l’objet .
De même, d’autres applications peuvent modifier les propriétés réelles du service d’impression de l’ordinateur. Pour vous assurer que l’objet PrintServer de votre programme a les valeurs les plus récentes, utilisez la Refresh méthode de l’objet .
Attention
Les classes de l’espace System.Printing de noms ne sont pas prises en charge pour une utilisation dans un service Windows ou ASP.NET application ou service. La tentative d’utilisation de ces classes à partir de l’un de ces types d’application peut produire des problèmes inattendus, tels que des performances de service réduites et des exceptions d’exécution.
Si vous souhaitez imprimer à partir d’une application Windows Forms, consultez l’espace de System.Drawing.Printing noms.
Constructeurs
PrintServer() |
Initialise une nouvelle instance de la classe PrintServer. |
PrintServer(PrintSystemDesiredAccess) |
Initialise une nouvelle instance de la classe PrintServer qui représente le serveur d'impression local et lui assigne le PrintSystemDesiredAccessspécifié. |
PrintServer(String) |
Initialise une nouvelle instance de la classe PrintServer avec le chemin d'accès spécifié. |
PrintServer(String, PrintServerIndexedProperty[]) |
Initialise une nouvelle instance de la classe PrintServer en utilisant le tableau PrintServerIndexedProperty spécifié pour déterminer quelles propriétés seront initialisées. |
PrintServer(String, PrintServerIndexedProperty[], PrintSystemDesiredAccess) |
Initialise une nouvelle instance de la classe PrintServer et fournit le chemin d'accès spécifié, le tableau PrintServerIndexedProperty et l'accès nécessaire. |
PrintServer(String, PrintSystemDesiredAccess) |
Initialise une nouvelle instance de la classe PrintServer qui a le chemin d'accès spécifié et l'accès nécessaire. |
PrintServer(String, String[]) |
Initialise une nouvelle instance de la classe PrintServer qui a le chemin d'accès et les propriétés de filtrage spécifiés. |
PrintServer(String, String[], PrintSystemDesiredAccess) |
Initialise une nouvelle instance de la classe PrintServer qui a le chemin d'accès et les propriétés de filtrage spécifiés, et l'accès nécessaire. |
Propriétés
BeepEnabled |
Obtient ou définit une valeur qui indique si le serveur d'impression émet un signal sonore en réponse à une condition d'erreur de l'imprimante. |
DefaultPortThreadPriority |
Ne pas utiliser. |
DefaultSchedulerPriority |
Ne pas utiliser. |
DefaultSpoolDirectory |
Obtient ou définit le chemin d'accès auquel les fichiers d'attente du serveur d'impression sont localisés. |
EventLog |
Obtient ou définit le type d'événements que le serveur d'impression enregistre. |
IsDelayInitialized |
Obtient ou définit une valeur qui indique si l'initialisation des propriétés PrintServer a été retardée. |
IsDisposed |
Obtient ou définit une valeur indiquant si l'objet a été supprimé. (Hérité de PrintSystemObject) |
MajorVersion |
Obtient la version principale du système d'exploitation. |
MinorVersion |
Obtient la version secondaire dans la version principale du système d'exploitation. |
Name |
Obtient le nom du serveur d'impression. |
NetPopup |
Obtient ou définit une valeur qui indique si les notifications de terminaison d'un travail d'impression sont envoyées au serveur d'impression ou à l'ordinateur client. |
Parent |
Obtient le parent de l'objet. (Hérité de PrintSystemObject) |
PortThreadPriority |
Obtient ou définit la priorité de thread pour le processus qui gère les E/S par les ports imprimante. |
PropertiesCollection |
Obtient une collection de paires d'attributs et de valeurs. (Hérité de PrintSystemObject) |
RestartJobOnPoolEnabled |
Obtient ou définit une valeur qui indique si les utilisateurs peuvent reprendre des travaux après qu'une erreur s'est produite, si le pool d'imprimante est activé. |
RestartJobOnPoolTimeout |
Obtient ou définit une valeur qui indique le temps d'attente avant qu'un travail puisse être redémarré, si une erreur se produit lorsque le pool d'imprimante est également activé. |
SchedulerPriority |
Obtient ou définit la priorité de thread pour le processus qui achemine des travaux d'impression entre des applications et des files d'attente. |
SubSystemVersion |
Obtient la version du système de spouleur d'impression. |
Méthodes
Commit() |
Valide toute modification que votre programme a apportée aux propriétés de l'objet de serveur d'impression en l'écrivant sur le serveur d'impression que l'objet représente. |
DeletePrintQueue(PrintQueue) |
Enlève la PrintQueue du serveur d'impression. |
DeletePrintQueue(String) |
Supprime la file d'attente à l'impression, avec le nom spécifié, du serveur d'impression. |
Dispose() |
Libère toutes les ressources utilisées par PrintSystemObject. (Hérité de PrintSystemObject) |
Dispose(Boolean) |
Libère les ressources non managées utilisées par PrintSystemObject et libère éventuellement les ressources managées. (Hérité de PrintSystemObject) |
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetPrintQueue(String) |
Obtient du serveur d'impression une référence à la file d'attente à l'impression nommée. |
GetPrintQueue(String, String[]) |
Obtient du serveur d'impression une file d'attente à l'impression spécifiée. |
GetPrintQueues() |
Obtient la collection de files d'attente à l'impression hébergées par le serveur d'impression. |
GetPrintQueues(EnumeratedPrintQueueTypes[]) |
Obtient la collection de files d'attente à l'impression des types spécifiés qui sont nommés dans EnumeratedPrintQueueTypes et hébergés par le serveur d'impression. |
GetPrintQueues(PrintQueueIndexedProperty[]) |
Obtient une collection des files d'attente à l'impression qui sont hébergées par le serveur d'impression et initialisées uniquement dans les propriétés qui sont spécifiées dans le tableau PrintQueueIndexedProperty. |
GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[]) |
Obtient une collection de files d'attente à l'impression des types spécifiés. Ces files d'attente à l'impression sont initialisées uniquement dans les propriétés qui sont spécifiées dans le tableau PrintQueueIndexedProperty. |
GetPrintQueues(String[]) |
Obtient une collection de files d'attente à l'impression qui sont hébergées par le serveur d'impression et qui sont initialisées uniquement dans les propriétés spécifiées. |
GetPrintQueues(String[], EnumeratedPrintQueueTypes[]) |
Obtient la collection des files d'attente à l'impression qui sont du EnumeratedPrintQueueTypes spécifié et sont initialisées uniquement dans les propriétés spécifiées. |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
Initialize() |
Initialise les propriétés du PrintSystemObject. (Hérité de PrintSystemObject) |
InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary) |
Installe une file d'attente à l'impression, et le pilote d'imprimante associé, sur le serveur d'impression. |
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes) |
Installe une file d'attente à l'impression, et le pilote d'imprimante associé, sur le serveur d'impression. |
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) |
Installe une file d'attente à l'impression classée par ordre de priorité, et pilote d'imprimante associé, sur le serveur d'impression. |
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) |
Installe une file d'attente à l'impression partagée et classée par ordre de priorité, et le pilote d'imprimante associé, sur le serveur d'impression. |
InternalDispose(Boolean) |
Libère les ressources non managées utilisées par l'objet PrintServer et libère éventuellement les ressources managées. |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
Refresh() |
Met à jour les propriétés de l'objet PrintServer afin que chaque valeur de propriété corresponde à la valeur d'attribut correspondante du serveur d'impression que l'objet représente. |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |