PrintPropertyDictionary.Add(PrintProperty) PrintPropertyDictionary.Add(PrintProperty) PrintPropertyDictionary.Add(PrintProperty) PrintPropertyDictionary.Add(PrintProperty) Method

Definition

Fügt dem Wörterbuch das angegebene Objekt (aus einer Klasse, die von der PrintProperty abgeleitet ist) hinzu.Adds the specified object (of a class that is derived from PrintProperty) into the dictionary.

public:
 void Add(System::Printing::IndexedProperties::PrintProperty ^ attributeValue);
public void Add (System.Printing.IndexedProperties.PrintProperty attributeValue);
override this.Add : System.Printing.IndexedProperties.PrintProperty -> unit
Public Sub Add (attributeValue As PrintProperty)

Parameter

attributeValue
PrintProperty PrintProperty PrintProperty PrintProperty

Ein Objekt (einer Klasse, die von der PrintProperty abgeleitet ist), das eine Eigenschaft einer Hardware- oder Softwarekomponente eines Drucksystems darstellt.An object (of a class that is derived from PrintProperty) that represents a property of a printing system hardware or software component.

Beispiele

Im folgenden Beispiel wird gezeigt, wie diese Methode verwendet wird, um einen zweiten Drucker zu installieren, der sich in seinen Eigenschaften von einem vorhandenen Drucker nur in Speicherort, Port und Freigabe Status unterscheidet.The following example shows how to use this method to install a second printer that differs in its properties from an existing printer only in location, port, and shared status.

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

Hinweise

Die Name -Eigenschaft attributeValue von wird Key zur-Eigenschaft der DictionaryEntryneuen.The Name property of attributeValue becomes the Key property of the new DictionaryEntry. Der PrintProperty als Ganzes Value wird zur-Eigenschaft des neuen DictionaryEntry.The PrintProperty as a whole becomes the Value property of the new DictionaryEntry.

Eine weitere Möglichkeit zum Hinzufügen eines Eintrags zum Wörterbuch SetPropertyfinden Sie unter.For another way to add an entry to the dictionary, see SetProperty.

Gilt für:

Siehe auch