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.

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

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

type PrintStringProperty = class
    inherit PrintProperty

Public NotInheritable Class PrintStringProperty
Inherits 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.

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

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)
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
InternalDispose(Boolean)	Releases the unmanaged resources that are being used by the PrintProperty and optionally releases the managed resources. (Inherited from PrintProperty)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
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)
ToString()	Returns a string that represents the current object. (Inherited from Object)

Operators

Implicit(PrintStringProperty to String)

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