PrintStringProperty Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt eine String Eigenschaft (und ihren Wert) einer Drucksystemhardware oder Softwarekomponente dar.
public ref class PrintStringProperty sealed : System::Printing::IndexedProperties::PrintProperty
[System.Serializable]
public sealed class PrintStringProperty : System.Printing.IndexedProperties.PrintProperty
public sealed class PrintStringProperty : System.Printing.IndexedProperties.PrintProperty
[<System.Serializable>]
type PrintStringProperty = class
inherit PrintProperty
type PrintStringProperty = class
inherit PrintProperty
Public NotInheritable Class PrintStringProperty
Inherits PrintProperty
- Vererbung
- Attribute
Beispiele
Das folgende Beispiel zeigt, wie Sie diese Klasse verwenden, um einen zweiten Drucker zu installieren, der sich in seinen Eigenschaften von einem vorhandenen Drucker nur an Position, Port und gemeinsam genutztem Status unterscheidet.
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
| Name | Beschreibung |
|---|---|
| PrintStringProperty(String, Object) |
Initialisiert eine neue Instanz der Klasse, die PrintStringProperty den angegebenen Wert für die angegebene Eigenschaft aufweist. |
| PrintStringProperty(String) |
Initialisiert eine neue Instanz der PrintStringProperty Klasse für die angegebene Eigenschaft. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| IsDisposed |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Objekt verworfen wurde. (Geerbt von PrintProperty) |
| IsInitialized |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Objekt initialisiert wurde. (Geerbt von PrintProperty) |
| Name |
Ruft beim Überschreiben in einer abgeleiteten Klasse den Namen der Eigenschaft ab, die das Objekt darstellt. (Geerbt von PrintProperty) |
| Value |
Dient zum Abrufen oder Festlegen des Werts der Eigenschaft, die die PrintStringProperty darstellt. |
Methoden
| Name | Beschreibung |
|---|---|
| Dispose() |
Gibt alle Ressourcen frei, die von der PrintProperty. (Geerbt von PrintProperty) |
| Dispose(Boolean) |
Gibt die nicht verwalteten Ressourcen frei, die von den PrintProperty verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von PrintProperty) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| InternalDispose(Boolean) |
Gibt die nicht verwalteten Ressourcen frei, die von den PrintProperty verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von PrintProperty) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| OnDeserialization(Object) |
Wenn die Schnittstelle in einer abgeleiteten Klasse überschrieben wird, wird die ISerializable Schnittstelle implementiert und das Deserialisierungsereignis ausgelöst, wenn die Deserialisierung abgeschlossen ist. (Geerbt von PrintProperty) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Operatoren
| Name | Beschreibung |
|---|---|
| Implicit(PrintStringProperty to String) |
Stellt eine implizite Konvertierung in einen Wert von einem String Zeiger in ein PrintStringProperty. |