PrintServer.InstallPrintQueue Metoda

Reference

Definice

Obor názvů:: System.Printing

Sestavení:: System.Printing.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

PrintQueue

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

PrintQueue

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

PrintQueue

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

PrintQueue

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.Location Comment 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

Sdílet prostřednictvím

PrintServer.InstallPrintQueue Metoda

Definice

Přetížení

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

Parametry

Návraty

Příklady

Platí pro

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

Parametry

Návraty

Platí pro

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

Parametry

Návraty

Poznámky

Platí pro

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

Parametry

Návraty

Poznámky

Platí pro

Další materiály