PrintServer Clase

Definición

Espacio de nombres:

System.Printing

Ensamblado:

System.Printing.dll

Administra las colas de impresión de un servidor de impresión, que normalmente es un equipo, pero puede ser un aparato de hardware de servidor de impresión dedicado.

public ref class PrintServer : System::Printing::PrintSystemObject

public class PrintServer : System.Printing.PrintSystemObject

type PrintServer = class
    inherit PrintSystemObject

Public Class PrintServer
Inherits PrintSystemObject

Herencia

Object

PrintSystemObject

PrintServer

Derivado

System.Printing.LocalPrintServer

Ejemplos

En el ejemplo siguiente se muestra cómo crear una instancia 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()

Comentarios

Cuando el programa escribe un valor en una propiedad de PrintServer, ese cambio no tiene ningún efecto hasta que se pasa al equipo representado por el PrintServer objeto . Para confirmar los cambios, use el Commit método para el objeto .

De forma similar, otras aplicaciones pueden cambiar las propiedades reales del servicio de impresión del equipo. Para asegurarse de que el PrintServer objeto del programa tiene los valores más recientes, use el Refresh método para el objeto .

Precaución

Las clases dentro del System.Printing espacio de nombres no se admiten para su uso en un servicio de Windows ni en una aplicación o servicio de ASP.NET. Intentar usar estas clases desde uno de estos tipos de aplicación puede producir problemas inesperados, como una disminución del rendimiento del servicio y excepciones en tiempo de ejecución.

Si desea imprimir desde una aplicación de Windows Forms, consulte el System.Drawing.Printing espacio de nombres .

Constructores

PrintServer()	Inicializa una nueva instancia de la clase PrintServer.
PrintServer(PrintSystemDesiredAccess)	Inicializa una nueva instancia de la clase PrintServer que representa el servidor de impresión local y le asigna la PrintSystemDesiredAccess especificada.
PrintServer(String)	Inicializa una nueva instancia de la clase PrintServer que tiene la ruta de acceso especificada.
PrintServer(String, PrintServerIndexedProperty[])	Inicializa una nueva instancia de la clase PrintServer utilizando la matriz PrintServerIndexedProperty especificada para determinar qué propiedades se inicializarán.
PrintServer(String, PrintServerIndexedProperty[], PrintSystemDesiredAccess)	Inicializa una nueva instancia de la clase PrintServer y proporciona la ruta de acceso especificada, la matriz PrintServerIndexedProperty y el acceso necesario.
PrintServer(String, PrintSystemDesiredAccess)	Inicializa una nueva instancia de la clase PrintServer que tiene la ruta de acceso especificada y el acceso necesario.
PrintServer(String, String[])	Inicializa una nueva instancia de la clase PrintServer que tiene la ruta de acceso y filtro de propiedades especificados.
PrintServer(String, String[], PrintSystemDesiredAccess)	Inicializa una nueva instancia de la clase PrintServer que tiene la ruta de acceso especificada, el filtro de propiedades y el acceso necesario.

Propiedades

BeepEnabled	Obtiene o establece un valor que indica si el servidor de impresión emite una señal sonora en respuesta a una condición de error de la impresora.
DefaultPortThreadPriority	No utilizar.
DefaultSchedulerPriority	No utilizar.
DefaultSpoolDirectory	Obtiene o establece la ruta de acceso donde se encuentran los archivos en cola del servidor de impresión.
EventLog	Obtiene o establece el tipo de eventos que el servidor de impresión registra.
IsDelayInitialized	Obtiene o establece un valor que indica si se ha pospuesto la inicialización de las propiedades PrintServer.
IsDisposed	Obtiene o establece un valor que indica si el objeto se ha eliminado. (Heredado de PrintSystemObject)
MajorVersion	Obtiene la versión principal del sistema operativo.
MinorVersion	Obtiene la versión secundaria dentro de la versión principal del sistema operativo.
Name	Obtiene el nombre del servidor de impresión.
NetPopup	Obtiene o establece un valor que indica si las notificaciones de que un trabajo de impresión ha terminado se envían al servidor de impresión o al equipo cliente.
Parent	Obtiene el elemento primario del objeto. (Heredado de PrintSystemObject)
PortThreadPriority	Obtiene o establece la prioridad del subproceso para el proceso que administra la entrada/salida mediante los puertos de impresora.
PropertiesCollection	Obtiene una colección de pares de atributo y valor. (Heredado de PrintSystemObject)
RestartJobOnPoolEnabled	Obtiene o establece un valor que indica si los usuarios pueden reiniciar los trabajos después de que se produzca un error si está habilitado el envío de trabajos a cola de la impresora.
RestartJobOnPoolTimeout	Obtiene o establece un valor que indica el tiempo de espera antes de que se pueda reiniciar un trabajo, si se produce un error cuando también está habilitado el envío de trabajos a la cola de la impresora.
SchedulerPriority	Obtiene o establece la prioridad de subproceso para el proceso que enruta los trabajos de impresión de las aplicaciones a las colas de impresión.
SubSystemVersion	Obtiene la versión del sistema de cola de impresión.

Métodos

Commit()	Confirma los cambios que el programa ha realizado en las propiedades del objeto servidor de impresión escribiéndolas en el servidor de impresión que el objeto representa.
DeletePrintQueue(PrintQueue)	Quita la PrintQueue especificada del servidor de impresión.
DeletePrintQueue(String)	Quita la cola de impresión con el nombre especificado del servidor de impresión.
Dispose()	Libera todos los recursos que usa PrintSystemObject. (Heredado de PrintSystemObject)
Dispose(Boolean)	Libera los recursos no administrados que usa PrintSystemObject y, de forma opcional, libera los recursos administrados. (Heredado de PrintSystemObject)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetPrintQueue(String)	Obtiene una referencia a la cola de impresión indicada del servidor de impresión.
GetPrintQueue(String, String[])	Obtiene una cola de impresión especificada del servidor de impresión.
GetPrintQueues()	Obtiene la colección de colas de impresión que se hospedan en el servidor de impresión.
GetPrintQueues(EnumeratedPrintQueueTypes[])	Obtiene la colección de colas de impresión de los tipos especificados nombrados en EnumeratedPrintQueueTypes y que se hospedan en el servidor de impresión.
GetPrintQueues(PrintQueueIndexedProperty[])	Obtiene una colección de colas de impresión que se hospedan en el servidor de impresión y que sólo se inicializan en las propiedades especificadas en la matriz PrintQueueIndexedProperty.
GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[])	Obtiene una colección de colas de impresión de los tipos especificados. Estas colas de impresión sólo se inicializan en las propiedades que se especifican en la matriz PrintQueueIndexedProperty.
GetPrintQueues(String[])	Obtiene una colección de colas de impresión que se hospedan en el servidor de impresión y que sólo se inicializan en las propiedades especificadas.
GetPrintQueues(String[], EnumeratedPrintQueueTypes[])	Obtiene la colección de colas de impresión, que son de los tipos EnumeratedPrintQueueTypes especificados y sólo se inicializan en las propiedades especificadas.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Initialize()	Inicializa las propiedades de la clase PrintSystemObject. (Heredado de PrintSystemObject)
InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary)	Instala una cola de impresión y el controlador de impresora asociado, en el servidor de impresión.
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes)	Instala una cola de impresión y el controlador de impresora asociado, en el servidor de impresión.
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32)	Instala una cola de impresión con prioridad, y su controlador de impresora asociado, en el servidor de impresión.
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32)	Instala una cola de impresión con prioridad y compartida, y su controlador de impresora asociado, en el servidor de impresión.
InternalDispose(Boolean)	Libera los recursos no administrados utilizados por PrintServer y, de forma opcional, libera los recursos administrados.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Refresh()	Actualiza las propiedades del objeto PrintServer de manera que cada valor de propiedad coincida con el valor de atributo correspondiente del servidor de impresión que el objeto representa.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• PrintQueue
• LocalPrintServer