PrintServer.InstallPrintQueue Método

Referência

Definição

Namespace:: System.Printing

Assembly:: System.Printing.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Instala uma fila de impressão e seu driver de impressora associado no servidor de impressão.

Sobrecargas

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)	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 priorizada e o driver de impressão associado, no servidor de impressão.
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32)	Instala uma fila de impressão priorizada compartilhada e o driver de impressão associado, no servidor de impressão.

InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary)

Instala uma fila de impressão e o driver de impressora associado no servidor de impressão.

public:
 System::Printing::PrintQueue ^ InstallPrintQueue(System::String ^ printQueueName, System::String ^ driverName, cli::array <System::String ^> ^ portNames, System::String ^ printProcessorName, System::Printing::IndexedProperties::PrintPropertyDictionary ^ initialParameters);

public System.Printing.PrintQueue InstallPrintQueue (string printQueueName, string driverName, string[] portNames, string printProcessorName, System.Printing.IndexedProperties.PrintPropertyDictionary initialParameters);

member this.InstallPrintQueue : string * string * string[] * string * System.Printing.IndexedProperties.PrintPropertyDictionary -> System.Printing.PrintQueue

Public Function InstallPrintQueue (printQueueName As String, driverName As String, portNames As String(), printProcessorName As String, initialParameters As PrintPropertyDictionary) As PrintQueue

Parâmetros

printQueueName: String

O nome da nova fila.

driverName: String

O caminho e o nome do driver de impressora.

portNames: String[]

As IDs das portas que a nova fila usa.

printProcessorName: String

O nome do processador de impressão.

initialParameters: PrintPropertyDictionary

Os parâmetros que são inicializados.

Retornos

PrintQueue

O novo PrintQueue.

Exemplos

O exemplo a seguir mostra como usar esse método (chamado no LocalPrintServer objeto que herda o método de PrintServer) para instalar uma segunda impressora que difere em suas propriedades de uma impressora existente apenas em localização, porta e status compartilhadas.

LocalPrintServer myLocalPrintServer = new LocalPrintServer(PrintSystemDesiredAccess.AdministrateServer);
PrintQueue sourcePrintQueue = myLocalPrintServer.DefaultPrintQueue;
PrintPropertyDictionary myPrintProperties = sourcePrintQueue.PropertiesCollection;

// Share the new printer using Remove/Add methods
PrintBooleanProperty shared = new PrintBooleanProperty("IsShared", true);
myPrintProperties.Remove("IsShared");
myPrintProperties.Add("IsShared", shared);

// Give the new printer its share name using SetProperty method
PrintStringProperty theShareName = new PrintStringProperty("ShareName", "\"Son of " + sourcePrintQueue.Name +"\"");
myPrintProperties.SetProperty("ShareName", theShareName);

// Specify the physical location of the new printer using Remove/Add methods
PrintStringProperty theLocation = new PrintStringProperty("Location", "the supply room");
myPrintProperties.Remove("Location");
myPrintProperties.Add("Location", theLocation);

// Specify the port for the new printer
String[] port = new String[] { "COM1:" };

// Install the new printer on the local print server
PrintQueue clonedPrinter = myLocalPrintServer.InstallPrintQueue("My clone of " + sourcePrintQueue.Name, "Xerox WCP 35 PS", port, "WinPrint", myPrintProperties);
myLocalPrintServer.Commit();

// Report outcome
Console.WriteLine("{0} in {1} has been installed and shared as {2}", clonedPrinter.Name, clonedPrinter.Location, clonedPrinter.ShareName);
Console.WriteLine("Press Return to continue ...");
Console.ReadLine();

Dim myLocalPrintServer As New LocalPrintServer(PrintSystemDesiredAccess.AdministrateServer)
Dim sourcePrintQueue As PrintQueue = myLocalPrintServer.DefaultPrintQueue
Dim myPrintProperties As PrintPropertyDictionary = sourcePrintQueue.PropertiesCollection

' Share the new printer using Remove/Add methods
Dim [shared] As New PrintBooleanProperty("IsShared", True)
myPrintProperties.Remove("IsShared")
myPrintProperties.Add("IsShared", [shared])

' Give the new printer its share name using SetProperty method
Dim theShareName As New PrintStringProperty("ShareName", """Son of " & sourcePrintQueue.Name & """")
myPrintProperties.SetProperty("ShareName", theShareName)

' Specify the physical location of the new printer using Remove/Add methods
Dim theLocation As New PrintStringProperty("Location", "the supply room")
myPrintProperties.Remove("Location")
myPrintProperties.Add("Location", theLocation)

' Specify the port for the new printer
Dim port() As String = { "COM1:" }


' Install the new printer on the local print server
Dim clonedPrinter As PrintQueue = myLocalPrintServer.InstallPrintQueue("My clone of " & sourcePrintQueue.Name, "Xerox WCP 35 PS", port, "WinPrint", myPrintProperties)
myLocalPrintServer.Commit()

' Report outcome
Console.WriteLine("{0} in {1} has been installed and shared as {2}", clonedPrinter.Name, clonedPrinter.Location, clonedPrinter.ShareName)
Console.WriteLine("Press Return to continue ...")
Console.ReadLine()

Aplica-se a

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

Instala uma fila de impressão e o driver de impressora associado no servidor de impressão.

public:
 System::Printing::PrintQueue ^ InstallPrintQueue(System::String ^ printQueueName, System::String ^ driverName, cli::array <System::String ^> ^ portNames, System::String ^ printProcessorName, System::Printing::PrintQueueAttributes printQueueAttributes);

public System.Printing.PrintQueue InstallPrintQueue (string printQueueName, string driverName, string[] portNames, string printProcessorName, System.Printing.PrintQueueAttributes printQueueAttributes);

member this.InstallPrintQueue : string * string * string[] * string * System.Printing.PrintQueueAttributes -> System.Printing.PrintQueue

Public Function InstallPrintQueue (printQueueName As String, driverName As String, portNames As String(), printProcessorName As String, printQueueAttributes As PrintQueueAttributes) As PrintQueue

Parâmetros

printQueueName: String

O nome da nova fila.

driverName: String

O caminho e o nome do driver de impressora.

portNames: String[]

As IDs das portas que a nova fila usa.

printProcessorName: String

O nome do processador de impressão.

printQueueAttributes: PrintQueueAttributes

Os atributos, como sinalizadores, da nova fila.

Retornos

PrintQueue

O PrintQueue recém-criado.

Aplica-se a

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

Instala uma fila de impressão priorizada e o driver de impressão associado, no servidor de impressão.

public:
 System::Printing::PrintQueue ^ InstallPrintQueue(System::String ^ printQueueName, System::String ^ driverName, cli::array <System::String ^> ^ portNames, System::String ^ printProcessorName, System::Printing::PrintQueueAttributes printQueueAttributes, System::Printing::PrintQueueStringProperty ^ printQueueProperty, int printQueuePriority, int printQueueDefaultPriority);

public System.Printing.PrintQueue InstallPrintQueue (string printQueueName, string driverName, string[] portNames, string printProcessorName, System.Printing.PrintQueueAttributes printQueueAttributes, System.Printing.PrintQueueStringProperty printQueueProperty, int printQueuePriority, int printQueueDefaultPriority);

member this.InstallPrintQueue : string * string * string[] * string * System.Printing.PrintQueueAttributes * System.Printing.PrintQueueStringProperty * int * int -> System.Printing.PrintQueue

Public Function InstallPrintQueue (printQueueName As String, driverName As String, portNames As String(), printProcessorName As String, printQueueAttributes As PrintQueueAttributes, printQueueProperty As PrintQueueStringProperty, printQueuePriority As Integer, printQueueDefaultPriority As Integer) As PrintQueue

Parâmetros

printQueueName: String

O nome da nova fila.

driverName: String

O caminho e o nome do driver de impressora.

portNames: String[]

As IDs das portas que a nova fila usa.

printProcessorName: String

O nome do processador de impressão.

printQueueAttributes: PrintQueueAttributes

Os atributos, como sinalizadores, da nova fila.

printQueueProperty: PrintQueueStringProperty

O comentário, o local ou o nome do compartilhamento da nova fila.

printQueuePriority: Int32

Um valor de 1 a 99 que especifica a prioridade dessa fila de impressão em relação a outras filas hospedadas pelo servidor de impressão.

printQueueDefaultPriority: Int32

Um valor de 1 a 99 que especifica a prioridade padrão dos trabalhos de impressão que são enviados para a fila.

Retornos

PrintQueue

O PrintQueue recém-criado.

Comentários

Use o printQueueProperty parâmetro para inicializar um e apenas um das propriedades , Commentou Location da ShareNamefila. Se você quiser inicializar mais de um, use a InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) sobrecarga desse método.

Aplica-se a

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

Instala uma fila de impressão priorizada compartilhada e o driver de impressão associado, no servidor de impressão.

public:
 System::Printing::PrintQueue ^ InstallPrintQueue(System::String ^ printQueueName, System::String ^ driverName, cli::array <System::String ^> ^ portNames, System::String ^ printProcessorName, System::Printing::PrintQueueAttributes printQueueAttributes, System::String ^ printQueueShareName, System::String ^ printQueueComment, System::String ^ printQueueLocation, System::String ^ printQueueSeparatorFile, int printQueuePriority, int printQueueDefaultPriority);

public System.Printing.PrintQueue InstallPrintQueue (string printQueueName, string driverName, string[] portNames, string printProcessorName, System.Printing.PrintQueueAttributes printQueueAttributes, string printQueueShareName, string printQueueComment, string printQueueLocation, string printQueueSeparatorFile, int printQueuePriority, int printQueueDefaultPriority);

member this.InstallPrintQueue : string * string * string[] * string * System.Printing.PrintQueueAttributes * string * string * string * string * int * int -> System.Printing.PrintQueue

Public Function InstallPrintQueue (printQueueName As String, driverName As String, portNames As String(), printProcessorName As String, printQueueAttributes As PrintQueueAttributes, printQueueShareName As String, printQueueComment As String, printQueueLocation As String, printQueueSeparatorFile As String, printQueuePriority As Integer, printQueueDefaultPriority As Integer) As PrintQueue

Parâmetros

printQueueName: String

O nome da nova fila.

driverName: String

O caminho e o nome do driver de impressora.

portNames: String[]

As IDs das portas que a nova fila usa.

printProcessorName: String

O nome do processador de impressão.

printQueueAttributes: PrintQueueAttributes

Os atributos, como sinalizadores, da nova fila.

printQueueShareName: String

O nome do compartilhamento da nova fila.

printQueueComment: String

Um comentário sobre a fila visível para os usuários na interface do usuário do Microsoft Windows.

printQueueLocation: String

O local da nova fila.

printQueueSeparatorFile: String

O caminho de um arquivo que é inserido no início de cada trabalho de impressão.

printQueuePriority: Int32

Um valor de 1 a 99 que especifica a prioridade da fila em relação a outras filas hospedadas pelo servidor de impressão.

printQueueDefaultPriority: Int32

Um valor de 1 a 99 que especifica a prioridade padrão dos novos trabalhos de impressão que são enviados para a fila.

Retornos

PrintQueue

O PrintQueue recém-criado.

Comentários

Se você não quiser inicializar todas as três propriedades , ou Location da ShareName Commentfila, poderá passar uma cadeia de caracteres vazia para um ou mais de printQueueShareName, printQueueCommente printQueueLocation. Se você quiser inicializar apenas uma dessas propriedades, use a InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) sobrecarga desse método.

Aplica-se a

Compartilhar via

PrintServer.InstallPrintQueue Método

Definição

Sobrecargas

InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary)

Parâmetros

Retornos

Exemplos

Aplica-se a

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

Parâmetros

Retornos

Aplica-se a

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

Parâmetros

Retornos

Comentários

Aplica-se a

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

Parâmetros

Retornos

Comentários

Aplica-se a

Recursos adicionais