PrintStringProperty Class

Definition

Namespace:

System.Printing.IndexedProperties

Assembly:

System.Printing.dll

Represents a String property (and its value) of a printing system hardware or software component.

C#

public sealed class PrintStringProperty : System.Printing.IndexedProperties.PrintProperty

Inheritance

Object

PrintProperty

PrintStringProperty

Examples

The following example shows how to use this class to install a second printer that differs in its properties from an existing printer only in location, port, and shared status.

C#

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

Constructors

PrintStringProperty(String, Object)	Initializes a new instance of the PrintStringProperty class that has the specified value for the specified property.
PrintStringProperty(String)	Initializes a new instance of the PrintStringProperty class for the specified property.

Properties

IsDisposed	Gets or sets a value that indicates whether the object has been disposed. (Inherited from PrintProperty)
IsInitialized	Gets or sets a value that indicates whether the object has been initialized. (Inherited from PrintProperty)
Name	When overridden in a derived class, gets the name of the property that the object represents. (Inherited from PrintProperty)
Value	Gets or sets the value of the property that the PrintStringProperty represents.

Methods

Dispose()	Releases all resources that are being used by the PrintProperty. (Inherited from PrintProperty)
Dispose(Boolean)	Releases the unmanaged resources that are being used by the PrintProperty and optionally releases the managed resources. (Inherited from PrintProperty)
InternalDispose(Boolean)	Releases the unmanaged resources that are being used by the PrintProperty and optionally releases the managed resources. (Inherited from PrintProperty)
OnDeserialization(Object)	When overridden in a derived class, implements the ISerializable interface and raises the deserialization event when the deserialization is complete. (Inherited from PrintProperty)

Operators

Implicit(PrintStringProperty to String)

Provides implicit conversion to a String value from a pointer to a PrintStringProperty.

Applies to