PrintStringProperty Classe

Definição

Namespace:

System.Printing.IndexedProperties

Assembly:

System.Printing.dll

Representa uma propriedade String (e seu valor) de um componente de hardware ou de software do sistema de impressão.

public ref class PrintStringProperty sealed : System::Printing::IndexedProperties::PrintProperty

public sealed class PrintStringProperty : System.Printing.IndexedProperties.PrintProperty

type PrintStringProperty = class
    inherit PrintProperty

Public NotInheritable Class PrintStringProperty
Inherits PrintProperty

Herança

Object

PrintProperty

PrintStringProperty

Exemplos

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

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

Construtores

PrintStringProperty(String)	Inicializa uma nova instância da classe PrintStringProperty para a propriedade especificada.
PrintStringProperty(String, Object)	Inicializa uma nova instância da classe PrintStringProperty que tem o valor especificado para a propriedade especificada.

Propriedades

IsDisposed	Obtém ou define um valor que indica se o objeto foi descartado. (Herdado de PrintProperty)
IsInitialized	Obtém ou define um valor que indica se o objeto foi inicializado. (Herdado de PrintProperty)
Name	Quando substituído em uma classe derivada, obtém o nome da propriedade representada pelo objeto. (Herdado de PrintProperty)
Value	Obtém ou define o valor da propriedade representada pelo PrintStringProperty.

Métodos

Dispose()	Libera todos os recursos que estão sendo usados pelo PrintProperty. (Herdado de PrintProperty)
Dispose(Boolean)	Libera os recursos não gerenciados que estão sendo usados pelo PrintProperty e libera opcionalmente os recursos gerenciados. (Herdado de PrintProperty)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InternalDispose(Boolean)	Libera os recursos não gerenciados que estão sendo usados pelo PrintProperty e libera opcionalmente os recursos gerenciados. (Herdado de PrintProperty)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnDeserialization(Object)	Quando substituído em uma classe derivada, implementa a interface ISerializable e gera o evento de desserialização quando a desserialização é concluída. (Herdado de PrintProperty)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Operadores

Implicit(PrintStringProperty to String)

Fornece a conversão implícita para um valor String de um ponteiro em um PrintStringProperty.