LocalPrintServer Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt den lokalen Druckserver (den Computer, auf dem Ihre Anwendung ausgeführt wird) dar und ermöglicht die Verwaltung seiner Druckwarteschlangen.
public ref class LocalPrintServer sealed : System::Printing::PrintServerpublic sealed class LocalPrintServer : System.Printing.PrintServertype LocalPrintServer = class
inherit PrintServerPublic NotInheritable Class LocalPrintServer
Inherits PrintServer- Vererbung
Beispiele
Das folgende Beispiel zeigt, wie Sie eine Instanz der LocalPrintServer Klasse erstellen.
// -------------------- 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()
Hinweise
Wenn Ihre Anwendung einen Wert in eine Eigenschaft des LocalPrintServer Objekts schreibt, hat diese Änderung keine Auswirkung, bis der Wert an den Computer übergeben wird, der durch das LocalPrintServer Objekt dargestellt wird. Um sicherzustellen, dass die Änderung des Werts wirksam wird, verwenden Sie die Commit Methode.
Darüber hinaus können andere Anwendungen auch die Druckdiensteigenschaften des Computers ändern. Verwenden Sie die LocalPrintServer Methode, um sicherzustellen, dass das Refresh von Der Anwendung verwendete Objekt die neuesten tatsächlichen Werte aufweist.
Vorsicht
Klassen im Namespace System.Printing werden nicht für die Verwendung in einem Windows-Dienst oder einer ASP.NET-Anwendung oder einem Dienst unterstützt. Wenn Sie versuchen, diese Klassen aus einem dieser Anwendungstypen zu verwenden, können unerwartete Probleme auftreten, z. B. verringerte Dienstleistung und Laufzeit-Ausnahmen.
Wenn Sie aus einer Windows Forms-Anwendung drucken möchten, lesen Sie den System.Drawing.Printing Namespace.
Konstruktoren
| Name | Beschreibung |
|---|---|
| LocalPrintServer() |
Initialisiert eine neue Instanz der LocalPrintServer-Klasse. |
| LocalPrintServer(LocalPrintServerIndexedProperty[], PrintSystemDesiredAccess) |
Initialisiert eine neue Instanz der Klasse, die LocalPrintServer das angegebene LocalPrintServerIndexedProperty Array und das angegebene Array PrintSystemDesiredAccessaufweist. |
| LocalPrintServer(LocalPrintServerIndexedProperty[]) |
Initialisiert eine neue Instanz der LocalPrintServer Klasse mit dem angegebenen LocalPrintServerIndexedProperty Array. |
| LocalPrintServer(PrintSystemDesiredAccess) |
Initialisiert eine neue Instanz der Klasse, die LocalPrintServer den angegebenen PrintSystemDesiredAccessWert aufweist. |
| LocalPrintServer(String[], PrintSystemDesiredAccess) |
Initialisiert eine neue Instanz der LocalPrintServer Klasse mit den angegebenen Eigenschaften und PrintSystemDesiredAccess. |
| LocalPrintServer(String[]) |
Initialisiert eine neue Instanz der LocalPrintServer Klasse mit den angegebenen Eigenschaften. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| BeepEnabled |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Druckserver als Reaktion auf eine Fehlerbedingung im Drucker signalisiert. (Geerbt von PrintServer) |
| DefaultPortThreadPriority |
Nicht verwenden. (Geerbt von PrintServer) |
| DefaultPrintQueue |
Ruft die Standarddruckwarteschlange ab oder legt sie fest. |
| DefaultSchedulerPriority |
Nicht verwenden. (Geerbt von PrintServer) |
| DefaultSpoolDirectory |
Ruft den Pfad ab, in dem sich die Spooldateien des Druckservers befinden, oder legt den Pfad fest. (Geerbt von PrintServer) |
| EventLog |
Ruft den Ereignistyp ab, den der Druckserver protokolliert, oder legt diesen fest. (Geerbt von PrintServer) |
| IsDelayInitialized |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Initialisierung der PrintServer Eigenschaften verschoben wurde. (Geerbt von PrintServer) |
| IsDisposed |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Objekt verworfen wurde. (Geerbt von PrintSystemObject) |
| MajorVersion |
Ruft die Hauptversion des Betriebssystems ab. (Geerbt von PrintServer) |
| MinorVersion |
Ruft die Nebenversion innerhalb der Hauptversion des Betriebssystems ab. (Geerbt von PrintServer) |
| Name |
Ruft den Namen des Druckservers ab. (Geerbt von PrintServer) |
| NetPopup |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Benachrichtigungen, die ein Druckauftrag abgeschlossen hat, entweder an den Druckserver oder den Clientcomputer gesendet werden. (Geerbt von PrintServer) |
| Parent |
Ruft das übergeordnete Objekt des Objekts ab. (Geerbt von PrintSystemObject) |
| PortThreadPriority |
Dient zum Abrufen oder Festlegen der Threadpriorität für den Prozess, der E/A über die Druckerports verwaltet. (Geerbt von PrintServer) |
| PropertiesCollection |
Ruft eine Auflistung von Attribut- und Wertpaaren ab. (Geerbt von PrintSystemObject) |
| RestartJobOnPoolEnabled |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Benutzer Aufträge neu starten können, nachdem ein Fehler auftritt, wenn die Druckerpoolerstellung aktiviert ist. (Geerbt von PrintServer) |
| RestartJobOnPoolTimeout |
Dient zum Abrufen oder Festlegen eines Werts, der die Wartezeit angibt, bevor ein Auftrag neu gestartet werden kann, wenn ein Fehler auftritt, wenn auch druckerpooling aktiviert ist. (Geerbt von PrintServer) |
| SchedulerPriority |
Dient zum Abrufen oder Festlegen der Threadpriorität für den Prozess, der Druckaufträge von Anwendungen an Druckwarteschlangen weiter leitet. (Geerbt von PrintServer) |
| SubSystemVersion |
Ruft die Version des Druckspoolersystems ab. (Geerbt von PrintServer) |
Methoden
| Name | Beschreibung |
|---|---|
| Commit() |
Schreibt alle Änderungen, die Ihre Anwendung an den Eigenschaften des LocalPrintServer tatsächlichen Druckservers vorgenommen hat, den das Objekt darstellt. |
| ConnectToPrintQueue(PrintQueue) |
Verbindet den lokalen Druckserver mit dem angegebenen PrintQueue. |
| ConnectToPrintQueue(String) |
Stellt eine Verbindung mit der Druckwarteschlange hergestellt, die mithilfe der String |
| DisconnectFromPrintQueue(PrintQueue) |
Trennt den lokalen Druckserver vom angegebenen PrintQueue. |
| DisconnectFromPrintQueue(String) |
Trennt die Verbindung mit der Druckwarteschlange, die in der StringWarteschlange angegeben ist. |
| Dispose() |
Gibt alle vom PrintSystemObjectverwendeten Ressourcen frei. (Geerbt von PrintSystemObject) |
| Dispose(Boolean) |
Gibt die nicht verwalteten Ressourcen frei, die von den PrintSystemObject verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von PrintSystemObject) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetDefaultPrintQueue() |
Gibt einen Verweis auf die Standarddruckwarteschlange der .LocalPrintServer |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetPrintQueue(String, String[]) |
Ruft eine angegebene Druckwarteschlange vom Druckserver ab. (Geerbt von PrintServer) |
| GetPrintQueue(String) |
Ruft einen Verweis auf die benannte Druckwarteschlange vom Druckserver ab. (Geerbt von PrintServer) |
| GetPrintQueues() |
Ruft die Auflistung der Druckwarteschlangen ab, die der Druckserver hostet. (Geerbt von PrintServer) |
| GetPrintQueues(EnumeratedPrintQueueTypes[]) |
Ruft die Auflistung der Druckwarteschlangen der angegebenen Typen ab, die vom EnumeratedPrintQueueTypes Druckserver benannt und gehostet werden. (Geerbt von PrintServer) |
| GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[]) |
Ruft eine Auflistung von Druckwarteschlangen der angegebenen Typen ab. Diese Druckwarteschlangen werden nur in den Eigenschaften initialisiert, die PrintQueueIndexedProperty im Array angegeben sind. (Geerbt von PrintServer) |
| GetPrintQueues(PrintQueueIndexedProperty[]) |
Ruft eine Auflistung von Druckwarteschlangen ab, die vom Druckserver gehostet und nur in den Eigenschaften initialisiert werden, die PrintQueueIndexedProperty im Array angegeben sind. (Geerbt von PrintServer) |
| GetPrintQueues(String[], EnumeratedPrintQueueTypes[]) |
Ruft die Auflistung der Druckwarteschlangen ab, die der angegebenen EnumeratedPrintQueueTypes sind und nur in den angegebenen Eigenschaften initialisiert werden. (Geerbt von PrintServer) |
| GetPrintQueues(String[]) |
Ruft eine Auflistung von Druckwarteschlangen ab, die vom Druckserver gehostet werden und nur in den angegebenen Eigenschaften initialisiert werden. (Geerbt von PrintServer) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| Initialize() |
Initialisiert die Eigenschaften der PrintSystemObject. (Geerbt von PrintSystemObject) |
| InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary) |
Installiert eine Druckwarteschlange und den zugehörigen Druckertreiber auf dem Druckserver. (Geerbt von PrintServer) |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) |
Installiert eine priorisierte Druckwarteschlange und den zugehörigen Druckertreiber auf dem Druckserver. (Geerbt von PrintServer) |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) |
Installiert eine freigegebene, priorisierte Druckwarteschlange und den zugehörigen Druckertreiber auf dem Druckserver. (Geerbt von PrintServer) |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes) |
Installiert eine Druckwarteschlange und den zugehörigen Druckertreiber auf dem Druckserver. (Geerbt von PrintServer) |
| InternalDispose(Boolean) |
Gibt die nicht verwalteten Ressourcen frei, die von den PrintServer verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von PrintServer) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| Refresh() |
Aktualisiert die Eigenschaften des LocalPrintServer Objekts so, dass ihre Werte den Werten des Druckservers entsprechen, den das Objekt darstellt. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
