PrintServer.InstallPrintQueue Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Printing

Assembly:: System.Printing.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Installa una coda di stampa e il driver della stampante associato sul server di stampa.

Overload

InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary)	Installa una coda di stampa e il driver della stampante associato sul server di stampa.
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes)	Installa una coda di stampa e il driver della stampante associato sul server di stampa.
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32)	Installa una coda di stampa con priorità e il driver della stampante associato sul server di stampa.
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32)	Installa una coda di stampa condivisa con priorità e il driver della stampante associato sul server di stampa.

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

Installa una coda di stampa e il driver della stampante associato sul server di stampa.

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

Parametri

printQueueName: String

Nome della nuova coda di stampa.

driverName: String

Nome e percorso del driver della stampante.

portNames: String[]

ID delle porte utilizzate dalla nuova coda di stampa.

printProcessorName: String

Nome del processore di stampa.

initialParameters: PrintPropertyDictionary

Parametri inizializzati.

Restituisce

PrintQueue

Nuovo oggetto PrintQueue.

Esempio

Nell'esempio seguente viene illustrato come usare questo metodo (chiamato sull'oggetto LocalPrintServer che eredita il metodo da PrintServer) per installare una seconda stampante che differisce nelle relative proprietà da una stampante esistente solo in posizione, porta e stato condiviso.

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()

Si applica a

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

Installa una coda di stampa e il driver della stampante associato sul server di stampa.

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

Parametri

printQueueName: String

Nome della nuova coda di stampa.

driverName: String

Nome e percorso del driver della stampante.

portNames: String[]

ID delle porte utilizzate dalla nuova coda di stampa.

printProcessorName: String

Nome del processore di stampa.

printQueueAttributes: PrintQueueAttributes

Attributi della nuova coda di stampa, come flag.

Restituisce

PrintQueue

Oggetto PrintQueue appena creato.

Si applica a

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

Installa una coda di stampa con priorità e il driver della stampante associato sul server di stampa.

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

Parametri

printQueueName: String

Nome della nuova coda di stampa.

driverName: String

Nome e percorso del driver della stampante.

portNames: String[]

ID delle porte utilizzate dalla nuova coda di stampa.

printProcessorName: String

Nome del processore di stampa.

printQueueAttributes: PrintQueueAttributes

Attributi della nuova coda di stampa, come flag.

printQueueProperty: PrintQueueStringProperty

Commento, percorso o nome condivisione della nuova coda di stampa.

printQueuePriority: Int32

Valore compreso tra 1 e 99 che specifica la priorità della coda di stampa rispetto ad altre code ospitate dal server di stampa.

printQueueDefaultPriority: Int32

Valore compreso tra 1 e 99 che specifica la priorità predefinita dei processi di stampa inviati alla coda.

Restituisce

PrintQueue

Oggetto PrintQueue appena creato.

Commenti

Usare il printQueueProperty parametro per inizializzare uno e uno solo, delle proprietà , Commento Location della ShareNamecoda. Se si desidera inizializzare più di uno, usare l'overload InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) di questo metodo.

Si applica a

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

Installa una coda di stampa condivisa con priorità e il driver della stampante associato sul server di stampa.

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

Parametri

printQueueName: String

Nome della nuova coda di stampa.

driverName: String

Nome e percorso del driver della stampante.

portNames: String[]

ID delle porte utilizzate dalla nuova coda di stampa.

printProcessorName: String

Nome del processore di stampa.

printQueueAttributes: PrintQueueAttributes

Attributi della nuova coda di stampa, come flag.

printQueueShareName: String

Nome condivisione della nuova coda di stampa.

printQueueComment: String

Un commento sulla coda visibile agli utenti nell'interfaccia utente di Microsoft Windows.

printQueueLocation: String

Percorso della nuova coda di stampa.

printQueueSeparatorFile: String

Percorso del file inserito all'inizio di ciascun processo di stampa.

printQueuePriority: Int32

Valore compreso tra 1 e 99 che specifica la priorità della coda di stampa rispetto ad altre code ospitate dal server di stampa.

printQueueDefaultPriority: Int32

Valore compreso tra 1 e 99 che specifica la priorità predefinita dei nuovi processi di stampa inviati alla coda.

Restituisce

PrintQueue

Oggetto PrintQueue appena creato.

Commenti

Se non si vuole inizializzare tutte e tre le proprietà , ShareName Commento Location della coda. È possibile passare una stringa vuota per una o più di printQueueShareName, printQueueCommente printQueueLocation. Se si vuole inizializzare solo una di queste proprietà, usare l'overload InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) di questo metodo.

Si applica a

Condividi tramite

PrintServer.InstallPrintQueue Metodo

Definizione

Overload

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

Parametri

Restituisce

Esempio

Si applica a

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

Parametri

Restituisce

Si applica a

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

Parametri

Restituisce

Commenti

Si applica a

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

Parametri

Restituisce

Commenti

Si applica a

Risorse aggiuntive