PrintPropertyDictionary Třída

Definice

Obor názvů:

System.Printing.IndexedProperties

Sestavení:

System.Printing.dll

Představuje kolekci vlastností a hodnot, které jsou přidruženy k objektu System.Printing v oboru názvů.

public ref class PrintPropertyDictionary : System::Collections::Hashtable, IDisposable

public class PrintPropertyDictionary : System.Collections.Hashtable, IDisposable

type PrintPropertyDictionary = class
    inherit Hashtable
    interface IDisposable
    interface IDeserializationCallback
    interface ISerializable

Public Class PrintPropertyDictionary
Inherits Hashtable
Implements IDisposable

Dědičnost

Object

Hashtable

PrintPropertyDictionary

Implementuje

IDisposable IDeserializationCallback ISerializable

Příklady

Následující příklad ukazuje, jak pomocí této třídy nainstalovat druhou tiskárnu, která se liší ve svých vlastnostech od existující tiskárny pouze v umístění, portu a sdíleném stavu.

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

Následující příklad ukazuje, jak pomocí této třídy zjistit za běhu vlastnosti a typy těchto vlastností tiskového systémového objektu bez použití reflexe.

// Enumerate the properties, and their types, of a queue without using Reflection
LocalPrintServer localPrintServer = new LocalPrintServer();
PrintQueue defaultPrintQueue = LocalPrintServer.GetDefaultPrintQueue();

PrintPropertyDictionary printQueueProperties = defaultPrintQueue.PropertiesCollection;

Console.WriteLine("These are the properties, and their types, of {0}, a {1}", defaultPrintQueue.Name, defaultPrintQueue.GetType().ToString() +"\n");

foreach (DictionaryEntry entry in printQueueProperties)
{
    PrintProperty property = (PrintProperty)entry.Value;

    if (property.Value != null)
    {
        Console.WriteLine(property.Name + "\t(Type: {0})", property.Value.GetType().ToString());
    }
}
Console.WriteLine("\n\nPress Return to continue...");
Console.ReadLine();

' Enumerate the properties, and their types, of a queue without using Reflection
Dim localPrintServer As New LocalPrintServer()
Dim defaultPrintQueue As PrintQueue = LocalPrintServer.GetDefaultPrintQueue()

Dim printQueueProperties As PrintPropertyDictionary = defaultPrintQueue.PropertiesCollection

Console.WriteLine("These are the properties, and their types, of {0}, a {1}", defaultPrintQueue.Name, defaultPrintQueue.GetType().ToString() + vbLf)

For Each entry As DictionaryEntry In printQueueProperties
    Dim [property] As PrintProperty = CType(entry.Value, PrintProperty)

    If [property].Value IsNot Nothing Then
        Console.WriteLine([property].Name & vbTab & "(Type: {0})", [property].Value.GetType().ToString())
    End If
Next entry
Console.WriteLine(vbLf & vbLf & "Press Return to continue...")
Console.ReadLine()

Poznámky

Kolekce má podobu slovníku Hashtable . Vlastnost Value každého DictionaryEntry v kolekci je instance třídy, která je odvozena z PrintProperty.

Konstruktory

Name	Description
PrintPropertyDictionary()	Inicializuje novou instanci PrintPropertyDictionary třídy.
PrintPropertyDictionary(SerializationInfo, StreamingContext)	Inicializuje novou instanci PrintPropertyDictionary třídy a poskytuje ji se zadaným SerializationInfo a StreamingContext.

Metody

Name	Description
Add(PrintProperty)	Přidá zadaný objekt (třídy odvozené z PrintProperty) do slovníku.
Dispose()	Uvolní všechny prostředky používané nástrojem PrintPropertyDictionary.
Dispose(Boolean)	Uvolní nespravované prostředky, které používají PrintPropertyDictionary a volitelně uvolní spravované prostředky.
GetObjectData(SerializationInfo, StreamingContext)	Naplní SerializationInfo data, která jsou potřebná k serializaci PrintPropertyDictionary.
GetProperty(String)	Získá objekt (třídy, která je odvozena z PrintProperty), který představuje zadanou vlastnost.
OnDeserialization(Object)	Implementuje ISerializable rozhraní a vyvolá deserializační událost po dokončení deserializace.
SetProperty(String, PrintProperty)	Nastaví hodnotu zadaného atributu na objekt třídy, která je odvozena z PrintProperty.