PrintStringProperty Klasse

Definition

Stellt eine String-Eigenschaft (und den Wert) einer Hardware- oder Softwarekomponente eines Drucksystems dar.Represents a String property (and its value) of a printing system hardware or software component.

public ref class PrintStringProperty sealed : System::Printing::IndexedProperties::PrintProperty
[System.Serializable]
public sealed class PrintStringProperty : System.Printing.IndexedProperties.PrintProperty
type PrintStringProperty = class
    inherit PrintProperty
Public NotInheritable Class PrintStringProperty
Inherits PrintProperty
Vererbung
PrintStringProperty
Attribute

Beispiele

Im folgenden Beispiel wird gezeigt, wie diese Klasse verwendet wird, um einen zweiten Drucker zu installieren, der sich in seinen Eigenschaften von einem vorhandenen Drucker nur an Speicherort, Port und freigegebenen Status unterscheidet.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()

Konstruktoren

PrintStringProperty(String)

Initialisiert eine neue Instanz der PrintStringProperty-Klasse für die angegebene Eigenschaft.Initializes a new instance of the PrintStringProperty class for the specified property.

PrintStringProperty(String, Object)

Initialisiert eine neue Instanz der PrintStringProperty-Klasse, die über den angegebenen Wert für die angegebene Eigenschaft verfügt.Initializes a new instance of the PrintStringProperty class that has the specified value for the specified property.

Eigenschaften

IsDisposed

Ruft einen Wert ab, mit dem angegeben wird, ob das Objekt freigegeben wurde, oder legt diesen Wert fest.Gets or sets a value that indicates whether the object has been disposed.

(Geerbt von PrintProperty)
IsInitialized

Ruft einen Wert ab, mit dem angegeben wird, ob das Objekt initialisiert wurde, oder legt diesen Wert fest.Gets or sets a value that indicates whether the object has been initialized.

(Geerbt von PrintProperty)
Name

Ruft beim Überschreiben in einer abgeleiteten Klasse den Namen der Eigenschaft ab, die das Objekt darstellt.When overridden in a derived class, gets the name of the property that the object represents.

(Geerbt von PrintProperty)
Value

Ruft den Wert der Eigenschaft ab, die die PrintStringProperty darstellt, oder legt diesen Wert fest.Gets or sets the value of the property that the PrintStringProperty represents.

Methoden

Dispose()

Gibt alle von der PrintProperty verwendeten Ressourcen frei.Releases all resources that are being used by the PrintProperty.

(Geerbt von PrintProperty)
Dispose(Boolean)

Gibt die von der PrintProperty verwendeten nicht verwalteten Ressourcen und optional die verwaltete Ressource frei.Releases the unmanaged resources that are being used by the PrintProperty and optionally releases the managed resource.

(Geerbt von PrintProperty)
Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
InternalDispose(Boolean)

Gibt die vom PrintProperty verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources that are being used by the PrintProperty and optionally releases the managed resources.

(Geerbt von PrintProperty)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnDeserialization(Object)

Implementiert beim Überschreiben in einer abgeleiteten Klasse die ISerializable-Schnittstelle und löst das Deserialisierungsereignis aus, wenn die Deserialisierung abgeschlossen ist.When overridden in a derived class, implements the ISerializable interface and raises the deserialization event when the deserialization is complete.

(Geerbt von PrintProperty)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Operatoren

Implicit(PrintStringProperty to String)

Stellt die implizite Konvertierung von einem Zeiger auf eine String in einen PrintStringProperty-Wert bereit.Provides implicit conversion to a String value from a pointer to a PrintStringProperty.

Gilt für: