PrintServer Classe

Definição

Namespace:
System.Printing
Assembly:
System.Printing.dll

Gerencia as filas de impressão em um servidor de impressão, que geralmente é um computador, mas pode ser um dispositivo de servidor de impressão de hardware dedicado.

public ref class PrintServer : System::Printing::PrintSystemObject
public class PrintServer : System.Printing.PrintSystemObject
type PrintServer = class
    inherit PrintSystemObject
Public Class PrintServer
Inherits PrintSystemObject
Herança
Object
PrintSystemObject
PrintServer
Derivado

Exemplos

O exemplo a seguir mostra como criar uma instância 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()

Comentários

Quando seu programa grava um valor em uma propriedade de PrintServer, essa alteração não tem efeito até que seja passada para o computador que é representado pelo PrintServer objeto. Para confirmar alterações, use o Commit método para o objeto.

Da mesma forma, outros aplicativos podem alterar as propriedades reais do serviço de impressão do computador. Para garantir que o PrintServer objeto do programa tenha os valores mais recentes, use o Refresh método para o objeto.

Caution

Classes dentro do System.Printing namespace não têm suporte para uso em um serviço do Windows ou ASP.NET aplicativo ou serviço. A tentativa de usar essas classes de dentro de um desses tipos de aplicativo pode produzir problemas inesperados, como redução do desempenho do serviço e exceções em tempo de execução.

Se você quiser imprimir de um aplicativo do Windows Forms, consulte o System.Drawing.Printing namespace.

Construtores

Nome Description
PrintServer()

Inicializa uma nova instância da classe PrintServer.
PrintServer(PrintSystemDesiredAccess)

Inicializa uma nova instância da PrintServer classe que representa o servidor de impressão local e atribui-lhe o especificado PrintSystemDesiredAccess.
PrintServer(String, PrintServerIndexedProperty[], PrintSystemDesiredAccess)

Inicializa uma nova instância da PrintServer classe e fornece o caminho especificado, a PrintServerIndexedProperty matriz e o acesso necessário.
PrintServer(String, PrintServerIndexedProperty[])

Inicializa uma nova instância da PrintServer classe usando a matriz especificada PrintServerIndexedProperty para determinar quais propriedades serão inicializadas.
PrintServer(String, PrintSystemDesiredAccess)

Inicializa uma nova instância da PrintServer classe que tem o caminho especificado e o acesso necessário.
PrintServer(String, String[], PrintSystemDesiredAccess)

Inicializa uma nova instância da PrintServer classe que tem o caminho especificado, o filtro de propriedades e o acesso necessário.
PrintServer(String, String[])

Inicializa uma nova instância da PrintServer classe que tem o caminho e o filtro de propriedades especificados.
PrintServer(String)

Inicializa uma nova instância da PrintServer classe que tem o caminho especificado.

Propriedades

Nome Description
BeepEnabled

Obtém ou define um valor que indica se o servidor de impressão empõe em resposta a uma condição de erro na impressora.
DefaultPortThreadPriority

Não use.
DefaultSchedulerPriority

Não use.
DefaultSpoolDirectory

Obtém ou define o caminho em que os arquivos de spool do servidor de impressão estão localizados.
EventLog

Obtém ou define o tipo de eventos que o servidor de impressão registra.
IsDelayInitialized

Obtém ou define um valor que indica se a inicialização das PrintServer propriedades foi adiada.
IsDisposed

Obtém ou define um valor que indica se o objeto foi descartado.

(Herdado de PrintSystemObject)
MajorVersion

Obtém a versão principal do sistema operacional.
MinorVersion

Obtém a versão secundária na versão principal do sistema operacional.
Name

Obtém o nome do servidor de impressão.
NetPopup

Obtém ou define um valor que indica se as notificações que um trabalho de impressão terminou são enviadas ao servidor de impressão ou ao computador cliente.
Parent

Obtém o pai do objeto.

(Herdado de PrintSystemObject)
PortThreadPriority

Obtém ou define a prioridade do thread para o processo que gerencia a E/S por meio das portas da impressora.
PropertiesCollection

Obtém uma coleção de pares de atributo e valor.

(Herdado de PrintSystemObject)
RestartJobOnPoolEnabled

Obtém ou define um valor que indica se os usuários podem reiniciar trabalhos após ocorrer um erro se o pool de impressoras estiver habilitado.
RestartJobOnPoolTimeout

Obtém ou define um valor que indica o tempo de espera antes que um trabalho possa ser reiniciado, se ocorrer um erro quando o pool de impressoras também estiver habilitado.
SchedulerPriority

Obtém ou define a prioridade de thread para o processo que roteia trabalhos de impressão de aplicativos para filas de impressão.
SubSystemVersion

Obtém a versão do sistema de spooler de impressão.

Métodos

Nome Description
Commit()

Confirma as alterações feitas pelo programa nas propriedades do objeto do servidor de impressão gravando-as no servidor de impressão que o objeto representa.
DeletePrintQueue(PrintQueue)

Remove o especificado PrintQueue do servidor de impressão.
DeletePrintQueue(String)

Remove a fila de impressão com o nome especificado do servidor de impressão.
Dispose()

Libera todos os recursos usados pelo PrintSystemObject.

(Herdado de PrintSystemObject)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo PrintSystemObject e, opcionalmente, libera os recursos gerenciados.

(Herdado de PrintSystemObject)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função hash predefinida.

(Herdado de Object)
GetPrintQueue(String, String[])

Obtém uma fila de impressão especificada do servidor de impressão.
GetPrintQueue(String)

Obtém uma referência à fila de impressão nomeada do servidor de impressão.
GetPrintQueues()

Obtém a coleção de filas de impressão que o servidor de impressão hospeda.
GetPrintQueues(EnumeratedPrintQueueTypes[])

Obtém a coleção de filas de impressão dos tipos especificados que são nomeados EnumeratedPrintQueueTypes e hospedados pelo servidor de impressão.
GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[])

Obtém uma coleção de filas de impressão dos tipos especificados. Essas filas de impressão são inicializadas apenas nas propriedades especificadas na PrintQueueIndexedProperty matriz.
GetPrintQueues(PrintQueueIndexedProperty[])

Obtém uma coleção de filas de impressão hospedadas pelo servidor de impressão e inicializadas apenas nas propriedades especificadas na PrintQueueIndexedProperty matriz.
GetPrintQueues(String[], EnumeratedPrintQueueTypes[])

Obtém a coleção de filas de impressão, que são do especificado EnumeratedPrintQueueTypes e são inicializadas apenas nas propriedades especificadas.
GetPrintQueues(String[])

Obtém uma coleção de filas de impressão hospedadas pelo servidor de impressão e que são inicializadas apenas nas propriedades especificadas.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
Initialize()

Inicializa as propriedades do PrintSystemObject.

(Herdado de PrintSystemObject)
InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary)

Instala uma fila de impressão e um driver de impressora associado no servidor de impressão.
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32)

Instala uma fila de impressão priorizada e um driver de impressora associado no servidor de impressão.
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32)

Instala uma fila de impressão compartilhada e priorizada e um driver de impressora associado no servidor de impressão.
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes)

Instala uma fila de impressão e um driver de impressora associado no servidor de impressão.
InternalDispose(Boolean)

Libera os recursos não gerenciados que são usados pelo PrintServer e, opcionalmente, libera os recursos gerenciados.
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
Refresh()

Atualiza as propriedades do objeto para PrintServer que cada valor de propriedade corresponda ao valor de atributo correspondente do servidor de impressão que o objeto representa.
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também