PrintPropertyDictionary Classe

Definição

Namespace:

System.Printing.IndexedProperties

Assembly:

System.Printing.dll

Representa uma coleção de propriedades e valores associados a um objeto no namespace System.Printing.

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

Herança

Object

Hashtable

PrintPropertyDictionary

Implementações

IDisposable IDeserializationCallback ISerializable

Exemplos

O exemplo a seguir mostra como usar essa classe para instalar uma segunda impressora que difere em suas propriedades de uma impressora existente somente no local, na porta e na status compartilhada.

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

O exemplo a seguir mostra como usar essa classe para descobrir em tempo de execução as propriedades e os tipos dessas propriedades, de um objeto do sistema de impressão, sem usar reflexão.

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

Comentários

A coleção assume a forma de um Hashtable dicionário. A Value propriedade de cada DictionaryEntry na coleção é uma instância de uma classe derivada de PrintProperty.

Construtores

PrintPropertyDictionary()	Inicializa uma nova instância da classe PrintPropertyDictionary.
PrintPropertyDictionary(SerializationInfo, StreamingContext)	Inicializa uma nova instância da classe PrintPropertyDictionary e a fornece com o SerializationInfo e o StreamingContext especificados.

Propriedades

comparer	Obtém ou define o IComparer a ser usado para o Hashtable. (Herdado de Hashtable)
Count	Obtém o número de pares chave-valor contidos no Hashtable. (Herdado de Hashtable)
EqualityComparer	Obtém o IEqualityComparer a ser usado para o Hashtable. (Herdado de Hashtable)
hcp	Obtém ou define o objeto que pode dispensar códigos hash. (Herdado de Hashtable)
IsFixedSize	Obtém um valor que indica se o Hashtable tem um tamanho fixo. (Herdado de Hashtable)
IsReadOnly	Obtém um valor que indica se o Hashtable é somente leitura. (Herdado de Hashtable)
IsSynchronized	Obtém um valor que indica se o acesso à Hashtable é sincronizado (thread-safe). (Herdado de Hashtable)
Item[Object]	Obtém ou define o valor associado à chave especificada. (Herdado de Hashtable)
Keys	Obtém uma ICollection que contém as chaves na Hashtable. (Herdado de Hashtable)
SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso ao Hashtable. (Herdado de Hashtable)
Values	Obtém um ICollection que contém os valores no Hashtable. (Herdado de Hashtable)

Métodos

Add(Object, Object)	Adiciona um elemento com a chave e o valor especificados ao Hashtable. (Herdado de Hashtable)
Add(PrintProperty)	Adiciona o objeto especificado (de uma classe derivada de PrintProperty) no dicionário.
Clear()	Remove todos os elementos do Hashtable. (Herdado de Hashtable)
Clone()	Cria uma cópia superficial do Hashtable. (Herdado de Hashtable)
Contains(Object)	Determina se a Hashtable contém uma chave específica. (Herdado de Hashtable)
ContainsKey(Object)	Determina se a Hashtable contém uma chave específica. (Herdado de Hashtable)
ContainsValue(Object)	Determinará se o Hashtable contiver um valor específico. (Herdado de Hashtable)
CopyTo(Array, Int32)	Copia os elementos Hashtable para uma instância Array unidimensional no índice especificado. (Herdado de Hashtable)
Dispose()	Libera todos os recursos que estão sendo usados pelo PrintPropertyDictionary.
Dispose(Boolean)	Libera os recursos não gerenciados que estão sendo usados pelo PrintPropertyDictionary e libera opcionalmente os recursos gerenciados.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Retorna um IDictionaryEnumerator que itera pelo Hashtable. (Herdado de Hashtable)
GetHash(Object)	Retorna o código hash da chave especificada. (Herdado de Hashtable)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)	Preenche um SerializationInfo com os dados necessários para serializar o PrintPropertyDictionary.
GetProperty(String)	Obtém o objeto (de uma classe derivada de PrintProperty) que representa a propriedade especificada.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
KeyEquals(Object, Object)	Compara um Object específico com uma chave específica no Hashtable. (Herdado de Hashtable)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnDeserialization(Object)	Implementa a interface ISerializable e gera o evento de desserialização quando a desserialização for concluída.
Remove(Object)	Remove o elemento com a chave especificada do Hashtable. (Herdado de Hashtable)
SetProperty(String, PrintProperty)	Define o valor do atributo especificado como um objeto de uma classe derivada de PrintProperty.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Métodos de Extensão