PrintServer.InstallPrintQueue Metoda

Definice

Nainstaluje tiskovou frontu a její přidružený ovladač tiskárny na tiskový server.

Přetížení

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

Nainstaluje tiskovou frontu a přidružený ovladač tiskárny na tiskový server.

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

Nainstaluje tiskovou frontu a přidružený ovladač tiskárny na tiskový server.

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

Nainstaluje tiskovou frontu s prioritou a přidružený ovladač tiskárny na tiskový server.

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

Nainstaluje na tiskový server sdílenou tiskovou frontu s přiřazenou prioritou a přidružený ovladač tiskárny.

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

Nainstaluje tiskovou frontu a přidružený ovladač tiskárny na tiskový server.

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

Parametry

printQueueName
String

Název nové fronty.

driverName
String

Cesta a název ovladače tiskárny.

portNames
String[]

ID portů, které nová fronta používá.

printProcessorName
String

Název tiskového procesoru.

initialParameters
PrintPropertyDictionary

Parametry, které jsou inicializovány.

Návraty

Nový PrintQueue.

Příklady

Následující příklad ukazuje, jak použít tuto metodu (volanou u objektu LocalPrintServer , který zdědí metodu z PrintServer) k instalaci druhé tiskárny, která se liší ve svých vlastnostech od existující tiskárny pouze v umístění, portu a stavu sdílené.

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

Platí pro

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

Nainstaluje tiskovou frontu a přidružený ovladač tiskárny na tiskový server.

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

Parametry

printQueueName
String

Název nové fronty.

driverName
String

Cesta a název ovladače tiskárny.

portNames
String[]

ID portů, které nová fronta používá.

printProcessorName
String

Název tiskového procesoru.

printQueueAttributes
PrintQueueAttributes

Atributy nové fronty jako příznaky.

Návraty

Nově vytvořená položka PrintQueue.

Platí pro

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

Nainstaluje tiskovou frontu s prioritou a přidružený ovladač tiskárny na tiskový server.

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

Parametry

printQueueName
String

Název nové fronty.

driverName
String

Cesta a název ovladače tiskárny.

portNames
String[]

ID portů, které nová fronta používá.

printProcessorName
String

Název tiskového procesoru.

printQueueAttributes
PrintQueueAttributes

Atributy nové fronty jako příznaky.

printQueueProperty
PrintQueueStringProperty

Název komentáře, umístění nebo sdílené složky nové fronty.

printQueuePriority
Int32

Hodnota od 1 do 99, která určuje prioritu této tiskové fronty vzhledem k jiným frontám hostovaným tiskovým serverem.

printQueueDefaultPriority
Int32

Hodnota od 1 do 99, která určuje výchozí prioritu tiskových úloh odesílaných do fronty.

Návraty

Nově vytvořená položka PrintQueue.

Poznámky

Pomocí parametru printQueueProperty inicializujete jednu a pouze jednu vlastnost , Commentnebo Location ve frontěShareName. Pokud chcete inicializovat více než jeden, použijte InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) přetížení této metody.

Platí pro

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

Nainstaluje na tiskový server sdílenou tiskovou frontu s přiřazenou prioritou a přidružený ovladač tiskárny.

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

Parametry

printQueueName
String

Název nové fronty.

driverName
String

Cesta a název ovladače tiskárny.

portNames
String[]

ID portů, které nová fronta používá.

printProcessorName
String

Název tiskového procesoru.

printQueueAttributes
PrintQueueAttributes

Atributy nové fronty jako příznaky.

printQueueShareName
String

Název sdílené složky nové fronty.

printQueueComment
String

Komentář k frontě, která je viditelná uživatelům v uživatelském rozhraní Microsoft Windows.

printQueueLocation
String

Umístění nové fronty.

printQueueSeparatorFile
String

Cesta k souboru, který je vložen na začátek každé tiskové úlohy.

printQueuePriority
Int32

Hodnota od 1 do 99, která určuje prioritu fronty vzhledem k jiným frontám hostovaným tiskovým serverem.

printQueueDefaultPriority
Int32

Hodnota od 1 do 99, která určuje výchozí prioritu nových tiskových úloh odesílaných do fronty.

Návraty

Nově vytvořená položka PrintQueue.

Poznámky

Pokud nechcete inicializovat všechny tři vlastnosti , nebo frontyShareName, můžete předat prázdný řetězec pro jednu nebo více vlastností printQueueShareName, printQueueCommenta printQueueLocation.LocationComment Pokud chcete inicializovat pouze jednu z těchto vlastností, použijte InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) přetížení této metody.

Platí pro