PrintServer PrintServer PrintServer PrintServer Class

Definición

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.Manages the print queues on a print server, which is usually a computer, but can be a dedicated hardware print server appliance.

public ref class PrintServer : System::Printing::PrintSystemObject
public class PrintServer : System.Printing.PrintSystemObject
type PrintServer = class
    inherit PrintSystemObject
Public Class PrintServer
Inherits PrintSystemObject
Herencia
Derivado

Ejemplos

El ejemplo siguiente muestra cómo crear una instancia de PrintServer.The following example shows how to create an instance of 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 a una propiedad de PrintServer, cambio no tiene ningún efecto hasta que se pasa al equipo que está representado por la PrintServer objeto.When your program writes a value to a property of PrintServer, that change has no effect until it is passed on to the computer that is represented by the PrintServer object. Para confirmar los cambios, utilice el Commit método para el objeto.To commit changes, use the Commit method for the object.

De forma similar, otras aplicaciones pueden cambiar las propiedades del servicio de impresión real del equipo.Similarly, other applications may change the actual print service properties of the computer. Para asegurarse de que el PrintServer objeto para el programa tiene los valores más recientes, use el Refresh método para el objeto.To make sure that the PrintServer object for your program has the latest values, use the Refresh method for the object.

Precaución

Las clases dentro de la System.Printing espacio de nombres no se admiten para su uso dentro de un servicio de Windows o la aplicación ASP.NET o servicio.Classes within the System.Printing namespace are not supported for use within a Windows service or ASP.NET application or service. Al intentar utilizar estas clases dentro de uno de estos tipos de aplicaciones puede producir problemas inesperados, como disminuir las excepciones de rendimiento y tiempo de ejecución de servicio.Attempting to use these classes from within one of these application types may produce unexpected problems, such as diminished service performance and run-time exceptions.

Si desea imprimir desde una aplicación de Windows Forms, consulte el System.Drawing.Printing espacio de nombres.If you want to print from a Windows Forms application, see the System.Drawing.Printing namespace.

Constructores

PrintServer() PrintServer() PrintServer() PrintServer()

Inicializa una nueva instancia de la clase PrintServer.Initializes a new instance of the PrintServer class.

PrintServer(PrintSystemDesiredAccess) PrintServer(PrintSystemDesiredAccess) PrintServer(PrintSystemDesiredAccess) PrintServer(PrintSystemDesiredAccess)

Inicializa una nueva instancia de la clase PrintServer que representa el servidor de impresión local y le asigna la PrintSystemDesiredAccess especificada.Initializes a new instance of the PrintServer class that represents the local print server and assigns it the specified PrintSystemDesiredAccess.

PrintServer(String) PrintServer(String) PrintServer(String) PrintServer(String)

Inicializa una nueva instancia de la clase PrintServer que tiene la ruta de acceso especificada.Initializes a new instance of the PrintServer class that has the specified path.

PrintServer(String, PrintServerIndexedProperty[]) PrintServer(String, PrintServerIndexedProperty[]) PrintServer(String, PrintServerIndexedProperty[]) PrintServer(String, PrintServerIndexedProperty[])

Inicializa una nueva instancia de la clase PrintServer utilizando la matriz PrintServerIndexedProperty especificada para determinar qué propiedades se inicializarán.Initializes a new instance of the PrintServer class by using the specified PrintServerIndexedProperty array to determine which properties will be initialized.

PrintServer(String, PrintServerIndexedProperty[], PrintSystemDesiredAccess) PrintServer(String, PrintServerIndexedProperty[], PrintSystemDesiredAccess) PrintServer(String, PrintServerIndexedProperty[], PrintSystemDesiredAccess) 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.Initializes a new instance of the PrintServer class and provides the specified path, the PrintServerIndexedProperty array, and the needed access.

PrintServer(String, PrintSystemDesiredAccess) PrintServer(String, PrintSystemDesiredAccess) PrintServer(String, PrintSystemDesiredAccess) PrintServer(String, PrintSystemDesiredAccess)

Inicializa una nueva instancia de la clase PrintServer que tiene la ruta de acceso especificada y el acceso necesario.Initializes a new instance of the PrintServer class that has the specified path and the needed access.

PrintServer(String, String[]) PrintServer(String, String[]) PrintServer(String, String[]) PrintServer(String, String[])

Inicializa una nueva instancia de la clase PrintServer que tiene la ruta de acceso y filtro de propiedades especificados.Initializes a new instance of the PrintServer class that has the specified path and properties filter.

PrintServer(String, String[], PrintSystemDesiredAccess) PrintServer(String, String[], PrintSystemDesiredAccess) PrintServer(String, String[], PrintSystemDesiredAccess) 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.Initializes a new instance of the PrintServer class that has the specified path, properties filter, and the needed access.

Propiedades

BeepEnabled BeepEnabled BeepEnabled 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.Gets or sets a value that indicates whether the print server beeps in response to an error condition in the printer.

DefaultPortThreadPriority DefaultPortThreadPriority DefaultPortThreadPriority DefaultPortThreadPriority

No utilizar.Do not use.

DefaultSchedulerPriority DefaultSchedulerPriority DefaultSchedulerPriority DefaultSchedulerPriority

No utilizar.Do not use.

DefaultSpoolDirectory DefaultSpoolDirectory DefaultSpoolDirectory DefaultSpoolDirectory

Obtiene o establece la ruta de acceso donde se encuentran los archivos en cola del servidor de impresión.Gets or sets the path where the print server's spool files are located.

EventLog EventLog EventLog EventLog

Obtiene o establece el tipo de eventos que el servidor de impresión registra.Gets or sets the type of events that the print server logs.

IsDelayInitialized IsDelayInitialized IsDelayInitialized IsDelayInitialized

Obtiene o establece un valor que indica si se ha pospuesto la inicialización de las propiedades PrintServer.Gets or sets a value that indicates whether initialization of the PrintServer properties has been postponed.

IsDisposed IsDisposed IsDisposed IsDisposed

Obtiene o establece un valor que indica si se ha eliminado el objeto.Gets or sets a value that indicates whether the object has been disposed.

(Inherited from PrintSystemObject)
MajorVersion MajorVersion MajorVersion MajorVersion

Obtiene la versión principal del sistema operativo.Gets the major version of the operating system.

MinorVersion MinorVersion MinorVersion MinorVersion

Obtiene la versión secundaria dentro de la versión principal del sistema operativo.Gets the minor version within the major version of the operating system.

Name Name Name Name

Obtiene el nombre del servidor de impresión.Gets the name of the print server.

NetPopup NetPopup NetPopup 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.Gets or sets a value that indicates whether notifications that a print job has finished are sent to either the print server or the client computer.

Parent Parent Parent Parent

Obtiene al elemento primario del objeto.Gets the parent of the object.

(Inherited from PrintSystemObject)
PortThreadPriority PortThreadPriority PortThreadPriority PortThreadPriority

Obtiene o establece la prioridad del subproceso para el proceso que administra la entrada/salida mediante los puertos de impresora.Gets or sets the thread priority for the process that manages I/O through the printer ports.

PropertiesCollection PropertiesCollection PropertiesCollection PropertiesCollection

Obtiene una colección de pares de atributo y valor.Gets a collection of attribute and value pairs.

(Inherited from PrintSystemObject)
RestartJobOnPoolEnabled RestartJobOnPoolEnabled RestartJobOnPoolEnabled 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.Gets or sets a value that indicates whether users can restart jobs after an error occurs if printer pooling is enabled.

RestartJobOnPoolTimeout RestartJobOnPoolTimeout RestartJobOnPoolTimeout 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.Gets or sets a value that indicates the wait time before a job can be restarted, if an error occurs when printer pooling is also enabled.

SchedulerPriority SchedulerPriority SchedulerPriority 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.Gets or sets the thread priority for the process that routes print jobs from applications to print queues.

SubSystemVersion SubSystemVersion SubSystemVersion SubSystemVersion

Obtiene la versión del sistema de cola de impresión.Gets the version of the print spooler system.

Métodos

Commit() Commit() Commit() 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.Commits any changes that your program made to the properties of the print server object by writing them to the print server that the object represents.

DeletePrintQueue(PrintQueue) DeletePrintQueue(PrintQueue) DeletePrintQueue(PrintQueue) DeletePrintQueue(PrintQueue)

Quita la PrintQueue especificada del servidor de impresión.Removes the specified PrintQueue from the print server.

DeletePrintQueue(String) DeletePrintQueue(String) DeletePrintQueue(String) DeletePrintQueue(String)

Quita la cola de impresión con el nombre especificado del servidor de impresión.Removes the print queue with the specified name from the print server.

Dispose() Dispose() Dispose() Dispose()

Libera todos los recursos que usa PrintSystemObject.Releases all resources used by the PrintSystemObject.

(Inherited from PrintSystemObject)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera los recursos no administrados que usa PrintSystemObject y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the PrintSystemObject and optionally releases the managed resources.

(Inherited from PrintSystemObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetPrintQueue(String) GetPrintQueue(String) GetPrintQueue(String) GetPrintQueue(String)

Obtiene una referencia a la cola de impresión indicada del servidor de impresión.Obtains a reference to the named print queue from the print server.

GetPrintQueue(String, String[]) GetPrintQueue(String, String[]) GetPrintQueue(String, String[]) GetPrintQueue(String, String[])

Obtiene una cola de impresión especificada del servidor de impresión.Gets a specified print queue from the print server.

GetPrintQueues() GetPrintQueues() GetPrintQueues() GetPrintQueues()

Obtiene la colección de colas de impresión que se hospedan en el servidor de impresión.Gets the collection of print queues that the print server hosts.

GetPrintQueues(EnumeratedPrintQueueTypes[]) GetPrintQueues(EnumeratedPrintQueueTypes[]) GetPrintQueues(EnumeratedPrintQueueTypes[]) 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.Gets the collection of print queues of the specified types that are named in EnumeratedPrintQueueTypes and hosted by the print server.

GetPrintQueues(PrintQueueIndexedProperty[]) GetPrintQueues(PrintQueueIndexedProperty[]) GetPrintQueues(PrintQueueIndexedProperty[]) 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.Gets a collection of print queues that are hosted by the print server and initialized only in the properties that are specified in the PrintQueueIndexedProperty array.

GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[]) GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[]) GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[]) GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[])

Obtiene una colección de colas de impresión de los tipos especificados.Gets a collection of print queues of the specified types. Estas colas de impresión sólo se inicializan en las propiedades que se especifican en la matriz PrintQueueIndexedProperty.These print queues are only initialized in the properties that are specified in the PrintQueueIndexedProperty array.

GetPrintQueues(String[]) GetPrintQueues(String[]) GetPrintQueues(String[]) 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.Gets a collection of print queues that are hosted by the print server and that are initialized only in the specified properties.

GetPrintQueues(String[], EnumeratedPrintQueueTypes[]) GetPrintQueues(String[], EnumeratedPrintQueueTypes[]) GetPrintQueues(String[], EnumeratedPrintQueueTypes[]) 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.Gets the collection of print queues, which are of the specified EnumeratedPrintQueueTypes and are initialized only in the specified properties.

GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
Initialize() Initialize() Initialize() Initialize()

Inicializa las propiedades de la PrintSystemObject.Initializes the properties of the PrintSystemObject.

(Inherited from PrintSystemObject)
InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary) InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary) InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary) InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary)

Instala una cola de impresión y el controlador de impresora asociado, en el servidor de impresión.Installs a print queue, and associated printer driver, on the print server.

InstallPrintQueue(String, String, String[], String, PrintQueueAttributes) InstallPrintQueue(String, String, String[], String, PrintQueueAttributes) InstallPrintQueue(String, String, String[], String, PrintQueueAttributes) InstallPrintQueue(String, String, String[], String, PrintQueueAttributes)

Instala una cola de impresión y el controlador de impresora asociado, en el servidor de impresión.Installs a print queue, and associated printer driver, on the print server.

InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) 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.Installs a prioritized print queue, and associated printer driver, on the print server.

InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) 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.Installs a shared, prioritized print queue, and associated printer driver, on the print server.

InternalDispose(Boolean) InternalDispose(Boolean) InternalDispose(Boolean) InternalDispose(Boolean)

Libera los recursos no administrados utilizados por PrintServer y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources that are used by the PrintServer and optionally releases the managed resources.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
Refresh() Refresh() Refresh() 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.Updates the properties of the PrintServer object so that each property value matches the corresponding attribute value of the print server that the object represents.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Se aplica a

Consulte también: