Export (0) Print
Expand All

PrintStringProperty Class

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

System.Object
  System.Printing.IndexedProperties.PrintProperty
    System.Printing.IndexedProperties.PrintStringProperty

Namespace:  System.Printing.IndexedProperties
Assembly:  System.Printing (in System.Printing.dll)

[SerializableAttribute]
public sealed class PrintStringProperty : PrintProperty

The PrintStringProperty type exposes the following members.

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

  NameDescription
Protected propertyIsInitializedGets or sets a value that indicates whether the object has been initialized. (Inherited from PrintProperty.)
Public propertyNameWhen overridden in a derived class, gets the name of the property that the object represents. (Inherited from PrintProperty.)
Public propertyValueGets or sets the value of the property that the PrintStringProperty represents. (Overrides PrintProperty.Value.)
Top

  NameDescription
Public methodDispose()Releases all resources that are being used by the PrintProperty. (Inherited from PrintProperty.)
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodOnDeserializationWhen overridden in a derived class, implements the ISerializable interface and raises the deserialization event when the deserialization is complete. (Inherited from PrintProperty.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

  NameDescription
Public operatorStatic memberImplicit(PrintStringProperty to String)Provides implicit conversion from a PrintStringProperty to a String value.
Public operatorStatic memberImplicit(PrintStringProperty to String)Provides implicit conversion to a String value from a pointer to a PrintStringProperty.
Top

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

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft