PrintServer Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Gerem as filas de impressão num servidor de impressão, que normalmente é um computador, mas pode ser um servidor de impressão de hardware dedicado.
public ref class PrintServer : System::Printing::PrintSystemObjectpublic class PrintServer : System.Printing.PrintSystemObjecttype PrintServer = class
inherit PrintSystemObjectPublic Class PrintServer
Inherits PrintSystemObject- Herança
- Derivado
Exemplos
O exemplo seguinte 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()
Observações
Quando o seu programa escreve um valor numa propriedade de PrintServer, essa alteração não tem efeito até ser passada ao computador representado pelo PrintServer objeto. Para comprometer as alterações, use o Commit método do objeto.
De forma semelhante, outras aplicações podem alterar as propriedades reais do serviço de impressão do computador. Para garantir que o PrintServer objeto do seu programa tem os valores mais recentes, use o Refresh método do objeto.
Atenção
As classes dentro do espaço de nomes System.Printing não são suportadas para uso dentro de um serviço Windows ou ASP.NET aplicação ou serviço. Tentar usar estas classes dentro de um destes tipos de aplicação pode produzir problemas inesperados, como desempenho de serviço diminuído e exceções em tempo de execução.
Se quiseres imprimir a partir de uma aplicação Windows Forms, vê o espaço de nomes System.Drawing.Printing.
Construtores
| Name | Description |
|---|---|
| PrintServer() |
Inicializa uma nova instância da PrintServer classe. |
| PrintServer(PrintSystemDesiredAccess) |
Inicializa uma nova instância da PrintServer classe que representa o servidor de impressão local e atribui-lhe o .PrintSystemDesiredAccess |
| PrintServer(String, PrintServerIndexedProperty[], PrintSystemDesiredAccess) |
Inicializa uma nova instância da PrintServer classe e fornece o caminho especificado, o PrintServerIndexedProperty array e o acesso necessário. |
| PrintServer(String, PrintServerIndexedProperty[]) |
Inicializa uma nova instância da PrintServer classe usando o array especificado PrintServerIndexedProperty para determinar quais as propriedades que 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 filtro de caminho e propriedades especificado. |
| PrintServer(String) |
Inicializa uma nova instância da PrintServer classe que tem o caminho especificado. |
Propriedades
| Name | Description |
|---|---|
| BeepEnabled |
Recebe ou define um valor que indica se o servidor de impressão emite um bip em resposta a uma condição de erro na impressora. |
| DefaultPortThreadPriority |
Não utilizar. |
| DefaultSchedulerPriority |
Não utilizar. |
| DefaultSpoolDirectory |
Obtém ou define o caminho onde estão localizados os ficheiros de spool do servidor de impressão. |
| EventLog |
Recebe ou define o tipo de eventos que o servidor de impressão regista. |
| IsDelayInitialized |
Recebe ou define um valor que indica se a inicialização das PrintServer propriedades foi adiada. |
| IsDisposed |
Recebe ou define um valor que indica se o objeto foi descartado. (Herdado de PrintSystemObject) |
| MajorVersion |
Recebe a versão principal do sistema operativo. |
| MinorVersion |
Obtém a versão menor dentro da versão principal do sistema operativo. |
| Name |
Obtém o nome do servidor de impressão. |
| NetPopup |
Recebe ou define um valor que indica se as notificações de que um trabalho de impressão foi concluído são enviadas para o servidor de impressão ou para o computador cliente. |
| Parent |
Fica com o pai do objeto. (Herdado de PrintSystemObject) |
| PortThreadPriority |
Recebe ou define a prioridade de thread para o processo que gere a I/O através das portas da impressora. |
| PropertiesCollection |
Obtém uma coleção de pares de atributos e valores. (Herdado de PrintSystemObject) |
| RestartJobOnPoolEnabled |
Recebe ou define um valor que indica se os utilizadores podem reiniciar trabalhos após ocorrer um erro se o pool de impressoras estiver ativado. |
| RestartJobOnPoolTimeout |
Recebe ou define um valor que indica o tempo de espera antes de um trabalho poder ser reiniciado, caso ocorra um erro quando o pooling de impressoras também está ativado. |
| SchedulerPriority |
Obtém ou define a prioridade de thread para o processo que encaminha trabalhos de impressão das aplicações para filas de impressão. |
| SubSystemVersion |
Recebe a versão do sistema de spooler de impressão. |
Métodos
| Name | Description |
|---|---|
| Commit() |
Faz commit de quaisquer alterações que o seu programa tenha feito às propriedades do objeto do servidor de impressão escrevendo-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() |
Liberta todos os recursos utilizados pelo PrintSystemObject. (Herdado de PrintSystemObject) |
| Dispose(Boolean) |
Liberta os recursos não geridos usados pelo PrintSystemObject e opcionalmente liberta os recursos geridos. (Herdado de PrintSystemObject) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetPrintQueue(String, String[]) |
Recebe uma fila de impressão especificada do servidor de impressão. |
| GetPrintQueue(String) |
Obtém uma referência à fila de impressão nomeada a partir 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 nomeadas e EnumeratedPrintQueueTypes alojadas pelo servidor de impressão. |
| GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[]) |
Obtém uma coleção de filas de impressão dos tipos especificados. Estas filas de impressão são inicializadas apenas nas propriedades especificadas no PrintQueueIndexedProperty array. |
| GetPrintQueues(PrintQueueIndexedProperty[]) |
Obtém uma coleção de filas de impressão que são alojadas pelo servidor de impressão e inicializadas apenas nas propriedades especificadas no PrintQueueIndexedProperty array. |
| 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 que são alojadas 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 o driver de impressora associado, no servidor de impressão. |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) |
Instala uma fila de impressão prioritária e o driver associado à impressora no servidor de impressão. |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) |
Instala uma fila de impressão partilhada e priorizada, e o driver de impressora associado, no servidor de impressão. |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes) |
Instala uma fila de impressão, e o driver de impressora associado, no servidor de impressão. |
| InternalDispose(Boolean) |
Liberta os recursos não geridos que são usados pelo PrintServer e opcionalmente liberta os recursos geridos. |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| Refresh() |
Atualiza as propriedades do PrintServer objeto para que cada valor de propriedade corresponda ao valor correspondente do atributo do servidor de impressão que o objeto representa. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |