LocalPrintServer 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.
Représente le serveur d’impression local (l’ordinateur sur lequel votre application est en cours d’exécution) et active la gestion de ses files d’attente d’impression.
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
- Héritage
Exemples
L’exemple suivant montre comment créer une instance de la 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()
Remarques
Lorsque votre application écrit une valeur dans une propriété de l’objet LocalPrintServer , cette modification n’a aucun effet tant que la valeur n’est pas passée à l’ordinateur représenté par l’objet LocalPrintServer . Pour vous assurer que la modification de la valeur prend effet, utilisez la Commit méthode.
En outre, d’autres applications peuvent également modifier les propriétés du service d’impression de l’ordinateur. Pour vous assurer que l’objet LocalPrintServer utilisé par votre application a les dernières valeurs réelles, utilisez la Refresh méthode.
Avertissement
Les classes de l’espace System.Printing de noms ne sont pas prises en charge pour une utilisation au sein d’un service Windows ou d’une application ou d’un service ASP.NET. La tentative d’utilisation de ces classes à partir de l’un de ces types d’applications peut entraîner 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 System.Drawing.Printing de noms.
Constructeurs
| Nom | Description |
|---|---|
| LocalPrintServer() |
Initialise une nouvelle instance de la classe LocalPrintServer. |
| LocalPrintServer(LocalPrintServerIndexedProperty[], PrintSystemDesiredAccess) |
Initialise une nouvelle instance de la LocalPrintServer classe qui a le tableau spécifié LocalPrintServerIndexedProperty et le .PrintSystemDesiredAccess |
| LocalPrintServer(LocalPrintServerIndexedProperty[]) |
Initialise une nouvelle instance de la LocalPrintServer classe qui a le tableau spécifié LocalPrintServerIndexedProperty . |
| LocalPrintServer(PrintSystemDesiredAccess) |
Initialise une nouvelle instance de la LocalPrintServer classe qui a la valeur spécifiée PrintSystemDesiredAccess. |
| LocalPrintServer(String[], PrintSystemDesiredAccess) |
Initialise une nouvelle instance de la LocalPrintServer classe qui a les propriétés spécifiées et PrintSystemDesiredAccess. |
| LocalPrintServer(String[]) |
Initialise une nouvelle instance de la LocalPrintServer classe qui a les propriétés spécifiées. |
Propriétés
| Nom | Description |
|---|---|
| BeepEnabled |
Obtient ou définit une valeur qui indique si le serveur d’impression pleure en réponse à une condition d’erreur dans l’imprimante. (Hérité de PrintServer) |
| DefaultPortThreadPriority |
Ne pas utiliser. (Hérité de PrintServer) |
| DefaultPrintQueue |
Obtient ou définit la file d’attente d’impression par défaut. |
| DefaultSchedulerPriority |
Ne pas utiliser. (Hérité de PrintServer) |
| DefaultSpoolDirectory |
Obtient ou définit le chemin d’accès où se trouvent les fichiers de pool du serveur d’impression. (Hérité de PrintServer) |
| EventLog |
Obtient ou définit le type d’événements que le serveur d’impression enregistre. (Hérité de PrintServer) |
| IsDelayInitialized |
Obtient ou définit une valeur qui indique si l’initialisation PrintServer des propriétés a été reportée. (Hérité de PrintServer) |
| IsDisposed |
Obtient ou définit une valeur qui indique si l’objet a été supprimé. (Hérité de PrintSystemObject) |
| MajorVersion |
Obtient la version principale du système d’exploitation. (Hérité de PrintServer) |
| MinorVersion |
Obtient la version mineure dans la version principale du système d’exploitation. (Hérité de PrintServer) |
| Name |
Obtient le nom du serveur d’impression. (Hérité de PrintServer) |
| NetPopup |
Obtient ou définit une valeur qui indique si les notifications qu’un travail d’impression a terminé sont envoyées au serveur d’impression ou à l’ordinateur client. (Hérité de PrintServer) |
| Parent |
Renvoie le parent de l’objet. (Hérité de PrintSystemObject) |
| PortThreadPriority |
Obtient ou définit la priorité du thread pour le processus qui gère les E/S via les ports d’imprimante. (Hérité de PrintServer) |
| 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 redémarrer des travaux après une erreur si le regroupement d’imprimantes est activé. (Hérité de PrintServer) |
| 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 regroupement d’imprimantes est également activé. (Hérité de PrintServer) |
| SchedulerPriority |
Obtient ou définit la priorité de thread pour le processus qui achemine les travaux d’impression des applications vers les files d’attente d’impression. (Hérité de PrintServer) |
| SubSystemVersion |
Obtient la version du système du spouleur d’impression. (Hérité de PrintServer) |
Méthodes
| Nom | Description |
|---|---|
| Commit() |
Écrit les modifications apportées par votre application aux propriétés du LocalPrintServer serveur d’impression réel que l’objet représente. |
| ConnectToPrintQueue(PrintQueue) |
Connecte le serveur d’impression local au serveur d’impression spécifié PrintQueue. |
| ConnectToPrintQueue(String) |
Se connecte à la file d’attente d’impression spécifiée à l’aide du Stringfichier . |
| DisconnectFromPrintQueue(PrintQueue) |
Déconnecte le serveur d’impression local du serveur d’impression spécifié PrintQueue. |
| DisconnectFromPrintQueue(String) |
Se déconnecte de la file d’attente d’impression spécifiée dans le String. |
| Dispose() |
Libère toutes les ressources utilisées par le PrintSystemObject. (Hérité de PrintSystemObject) |
| Dispose(Boolean) |
Libère les ressources non managées utilisées par les PrintSystemObject ressources gérées 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) |
| GetDefaultPrintQueue() |
Retourne une référence à la file d’attente d’impression par défaut du LocalPrintServerfichier . |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetPrintQueue(String, String[]) |
Obtient une file d’attente d’impression spécifiée à partir du serveur d’impression. (Hérité de PrintServer) |
| GetPrintQueue(String) |
Obtient une référence à la file d’attente d’impression nommée à partir du serveur d’impression. (Hérité de PrintServer) |
| GetPrintQueues() |
Obtient la collection de files d’attente d’impression que le serveur d’impression héberge. (Hérité de PrintServer) |
| GetPrintQueues(EnumeratedPrintQueueTypes[]) |
Obtient la collection de files d’attente d’impression des types spécifiés nommés et EnumeratedPrintQueueTypes hébergés par le serveur d’impression. (Hérité de PrintServer) |
| GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[]) |
Obtient une collection de files d’attente d’impression des types spécifiés. Ces files d’attente d’impression sont initialisées uniquement dans les propriétés spécifiées dans le PrintQueueIndexedProperty tableau. (Hérité de PrintServer) |
| GetPrintQueues(PrintQueueIndexedProperty[]) |
Obtient une collection de files d’attente d’impression hébergées par le serveur d’impression et initialisées uniquement dans les propriétés spécifiées dans le PrintQueueIndexedProperty tableau. (Hérité de PrintServer) |
| GetPrintQueues(String[], EnumeratedPrintQueueTypes[]) |
Obtient la collection de files d’attente d’impression, qui sont des files d’attente spécifiées EnumeratedPrintQueueTypes et qui sont initialisées uniquement dans les propriétés spécifiées. (Hérité de PrintServer) |
| GetPrintQueues(String[]) |
Obtient une collection de files d’attente d’impression hébergées par le serveur d’impression et qui sont initialisées uniquement dans les propriétés spécifiées. (Hérité de PrintServer) |
| GetType() |
Obtient la 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 d’impression et un pilote d’imprimante associé sur le serveur d’impression. (Hérité de PrintServer) |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) |
Installe une file d’attente d’impression hiérarchisée et le pilote d’imprimante associé, sur le serveur d’impression. (Hérité de PrintServer) |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) |
Installe une file d’attente d’impression partagée, hiérarchisée et un pilote d’imprimante associé, sur le serveur d’impression. (Hérité de PrintServer) |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes) |
Installe une file d’attente d’impression et un pilote d’imprimante associé sur le serveur d’impression. (Hérité de PrintServer) |
| InternalDispose(Boolean) |
Libère les ressources non managées utilisées par les PrintServer ressources gérées et les libère éventuellement. (Hérité de PrintServer) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| Refresh() |
Met à jour les propriétés de l’objet LocalPrintServer afin que leurs valeurs correspondent aux valeurs du serveur d’impression que l’objet représente. |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |