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 Druckerserver dar (der Computer, auf dem die Anwendung ausgeführt wird) und ermöglicht die Verwaltung der zugehörigen 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
Im folgenden Beispiel wird veranschaulicht, wie eine Instanz der LocalPrintServer-Klasse erstellt wird.
// -------------------- 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 -Objekts schreibt, hat diese LocalPrintServer Änderung keine Auswirkung, bis der Wert an den Computer übergeben wird, der durch das LocalPrintServer -Objekt dargestellt wird. Verwenden Sie die -Methode, um sicherzustellen, dass die Commit Wertänderung wirksam wird.
Darüber hinaus können auch andere Anwendungen die Eigenschaften des Druckdiensts des Computers ändern. Verwenden Sie die -Methode, um sicherzustellen, Refresh dass das LocalPrintServer von Ihrer Anwendung verwendete Objekt über die neuesten tatsächlichen Werte verfügt.
Achtung
Klassen innerhalb des Namespace werden nicht für die System.Printing Verwendung innerhalb eines Windows-Diensts oder ASP.NET-Anwendung oder -Diensts unterstützt. Der Versuch, diese Klassen aus einem dieser Anwendungstypen zu verwenden, kann zu unerwarteten Problemen führen, z. B. zu leistungseinbußen und Laufzeitausnahmen.
Wenn Sie aus einer Windows Forms-Anwendung drucken möchten, lesen Sie den System.Drawing.Printing Namespace.
Konstruktoren
| LocalPrintServer() |
Initialisiert eine neue Instanz der LocalPrintServer-Klasse. |
| LocalPrintServer(LocalPrintServerIndexedProperty[]) |
Initialisiert eine neue Instanz der LocalPrintServer-Klasse mit dem angegebenen LocalPrintServerIndexedProperty-Array. |
| LocalPrintServer(LocalPrintServerIndexedProperty[], PrintSystemDesiredAccess) |
Initialisiert eine neue Instanz der LocalPrintServer-Klasse mit dem angegebenen LocalPrintServerIndexedProperty-Array und PrintSystemDesiredAccess. |
| LocalPrintServer(PrintSystemDesiredAccess) |
Initialisiert eine neue Instanz der LocalPrintServer-Klasse mit dem angegebenen PrintSystemDesiredAccess. |
| LocalPrintServer(String[]) |
Initialisiert eine neue Instanz der LocalPrintServer-Klasse mit den angegebenen Eigenschaften. |
| LocalPrintServer(String[], PrintSystemDesiredAccess) |
Initialisiert eine neue Instanz der LocalPrintServer-Klasse mit den angegebenen Eigenschaften und PrintSystemDesiredAccess. |
Eigenschaften
| BeepEnabled |
Ruft einen Wert ab, der angibt, ob der Druckerserver beim Auftreten eines Fehlers im Drucker einen Signalton ausgibt, oder legt diesen Wert fest (Geerbt von PrintServer) |
| DefaultPortThreadPriority |
Nicht verwenden. (Geerbt von PrintServer) |
| DefaultPrintQueue |
Ruft die Standarddruckwarteschlange ab oder legt diese fest. |
| DefaultSchedulerPriority |
Nicht verwenden. (Geerbt von PrintServer) |
| DefaultSpoolDirectory |
Ruft den Pfad der Spooldateien des Druckerservers ab, oder legt diesen Wert fest. (Geerbt von PrintServer) |
| EventLog |
Ruft den Ereignistyp für die Ereignisprotokollierung des Druckerservers ab, oder legt diesen Wert fest. (Geerbt von PrintServer) |
| IsDelayInitialized |
Ruft einen Wert ab, der angibt, ob die Initialisierung der PrintServer-Eigenschaften zurückgestellt wurde, oder legt diesen Wert fest. (Geerbt von PrintServer) |
| IsDisposed |
Ruft einen Wert ab, mit dem angegeben wird, ob das Objekt freigegeben wurde, oder legt diesen Wert fest. (Geerbt von PrintSystemObject) |
| MajorVersion |
Ruft die Hauptversion des Betriebssystems ab. (Geerbt von PrintServer) |
| MinorVersion |
Ruft die Nebenversionsnummer aus der Hauptversionsnummer des Betriebssystems ab. (Geerbt von PrintServer) |
| Name |
Ruft den Namen des Druckerservers ab. (Geerbt von PrintServer) |
| NetPopup |
Ruft einen Wert ab, der angibt, ob Benachrichtigungen über die Fertigstellung eines Druckauftrags an den Druckerserver oder an den Clientcomputer gesendet werden, oder legt diesen Wert fest. (Geerbt von PrintServer) |
| Parent |
Ruft das übergeordnete Element des Objekts ab. (Geerbt von PrintSystemObject) |
| PortThreadPriority |
Ruft die Threadpriorität des Prozesses ab, der die E/A für die Druckeranschlüsse verwaltet, oder legt diesen Wert fest. (Geerbt von PrintServer) |
| PropertiesCollection |
Ruft eine Auflistung mit Attribut-Wert-Paaren ab. (Geerbt von PrintSystemObject) |
| RestartJobOnPoolEnabled |
Ruft einen Wert ab, der angibt, ob Benutzer einen Auftrag bei aktiviertem Druckerpool neu starten können, nachdem ein Fehler aufgetreten ist, oder legt diesen Wert fest. (Geerbt von PrintServer) |
| RestartJobOnPoolTimeout |
Ruft einen Wert ab, der die Wartezeit angibt, nach der ein Auftrag bei aktiviertem Druckerpool neu gestartet werden kann, wenn ein Fehler aufgetreten ist, oder legt diesen Wert fest. (Geerbt von PrintServer) |
| SchedulerPriority |
Ruft die Threadpriorität des Prozesses ab, der Druckaufträge von Anwendungen an die Druckwarteschlangen weiterleitet, oder legt diesen Wert fest. (Geerbt von PrintServer) |
| SubSystemVersion |
Ruft die Version des Druckerspoolersystems ab. (Geerbt von PrintServer) |
Methoden
| Commit() |
Überträgt alle Änderungen, die die Anwendung an den Eigenschaften des LocalPrintServer vorgenommen hat, an den vom Objekt dargestellten Druckerserver. |
| ConnectToPrintQueue(PrintQueue) |
Verbindet den lokalen Druckerserver mit der angegebenen PrintQueue. |
| ConnectToPrintQueue(String) |
Stellt eine Verbindung mit der Druckwarteschlange her, die im String angegeben ist. |
| DisconnectFromPrintQueue(PrintQueue) |
Trennt den lokalen Druckerserver von der angegebenen PrintQueue. |
| DisconnectFromPrintQueue(String) |
Trennt die Verbindung mit der Druckwarteschlange, die im String angegeben ist. |
| Dispose() |
Gibt alle vom PrintSystemObject verwendeten Ressourcen frei. (Geerbt von PrintSystemObject) |
| Dispose(Boolean) |
Gibt die von PrintSystemObject verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von PrintSystemObject) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetDefaultPrintQueue() |
Gibt einen Verweis auf die Standarddruckwarteschlange von LocalPrintServer zurück. |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetPrintQueue(String) |
Erstellt einen Verweis auf die genannte Druckwarteschlange auf dem Druckerserver. (Geerbt von PrintServer) |
| GetPrintQueue(String, String[]) |
Ruft eine angegebene Druckwarteschlange vom Druckerserver ab. (Geerbt von PrintServer) |
| GetPrintQueues() |
Ruft die Auflistung der Druckwarteschlangen ab, die vom Druckerserver verwaltet werden. (Geerbt von PrintServer) |
| GetPrintQueues(EnumeratedPrintQueueTypes[]) |
Ruft eine Auflistung der Druckwarteschlangen ab, die vom Druckerserver verwaltet werden und einen der in EnumeratedPrintQueueTypes angegebenen Typen aufweisen. (Geerbt von PrintServer) |
| GetPrintQueues(PrintQueueIndexedProperty[]) |
Ruft eine Auflistung der Druckwarteschlangen ab, die vom Druckerserver verwaltet werden und bei denen nur die im PrintQueueIndexedProperty-Array angegebenen Eigenschaften initialisiert wurden. (Geerbt von PrintServer) |
| GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[]) |
Ruft eine Auflistung der Druckwarteschlangen mit den angegebenen Typen ab. Bei diesen Druckwarteschlangen sind nur die im PrintQueueIndexedProperty-Array angegebenen Eigenschaften initialisiert. (Geerbt von PrintServer) |
| GetPrintQueues(String[]) |
Ruft eine Auflistung von Druckwarteschlangen ab, die vom Druckerserver verwaltet werden und bei denen nur die angegebenen Eigenschaften initialisiert werden. (Geerbt von PrintServer) |
| GetPrintQueues(String[], EnumeratedPrintQueueTypes[]) |
Ruft eine Auflistung der Druckwarteschlangen ab, die einem der in EnumeratedPrintQueueTypes angegebenen Typen entsprechen und bei denen nur die angegebenen Eigenschaften initialisiert werden. (Geerbt von PrintServer) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| Initialize() |
Initialisiert die Eigenschaften des PrintSystemObject. (Geerbt von PrintSystemObject) |
| InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary) |
Installiert auf dem Druckerserver eine Druckwarteschlange und den zugehörigen Druckertreiber. (Geerbt von PrintServer) |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes) |
Installiert auf dem Druckerserver eine Druckwarteschlange und den zugehörigen Druckertreiber. (Geerbt von PrintServer) |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) |
Installiert auf dem Druckerserver eine priorisierte Druckwarteschlange und den zugehörigen Druckertreiber. (Geerbt von PrintServer) |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) |
Installiert auf dem Druckerserver eine freigegebene, priorisierte Druckwarteschlange und den zugehörigen Druckertreiber. (Geerbt von PrintServer) |
| InternalDispose(Boolean) |
Gibt die von PrintServer verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei. (Geerbt von PrintServer) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| Refresh() |
Aktualisiert die Eigenschaften des LocalPrintServer-Objekts, sodass die Werte mit den Werten des Druckerservers übereinstimmen, der durch das Objekt dargestellt wird. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
