LocalPrintServer Constructores

Referencia

Definición

Espacio de nombres:: System.Printing

Ensamblado:: System.Printing.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Inicializa una nueva instancia de la clase LocalPrintServer.

Sobrecargas

LocalPrintServer()	Inicializa una nueva instancia de la clase LocalPrintServer.
LocalPrintServer(LocalPrintServerIndexedProperty[])	Inicializa una nueva instancia de la clase LocalPrintServer que tiene la matriz LocalPrintServerIndexedProperty especificada.
LocalPrintServer(PrintSystemDesiredAccess)	Inicializa una nueva instancia de la clase LocalPrintServer que con la propiedad PrintSystemDesiredAccess especificada.
LocalPrintServer(String[])	Inicializa una nueva instancia de la clase LocalPrintServer que tiene las propiedades especificadas.
LocalPrintServer(LocalPrintServerIndexedProperty[], PrintSystemDesiredAccess)	Inicializa una nueva instancia de la clase LocalPrintServer que tiene la matriz LocalPrintServerIndexedProperty especificada y los derechos, PrintSystemDesiredAccess especificados.
LocalPrintServer(String[], PrintSystemDesiredAccess)	Inicializa una instancia nueva de la clase LocalPrintServer que tiene las propiedades y el acceso PrintSystemDesiredAccess especificados.

LocalPrintServer()

Inicializa una nueva instancia de la clase LocalPrintServer.

public:
 LocalPrintServer();

public LocalPrintServer ();

Public Sub New ()

Ejemplos

En el ejemplo siguiente se muestra cómo usar este constructor en el código que prueba las funcionalidades de una impresora y configura un trabajo de impresión para aprovecharlos.

// ---------------------- GetPrintTicketFromPrinter -----------------------
/// <summary>
///   Returns a PrintTicket based on the current default printer.</summary>
/// <returns>
///   A PrintTicket for the current local default printer.</returns>
PrintTicket^ GetPrintTicketFromPrinter ()
{
   PrintQueue^ printQueue = nullptr;

   LocalPrintServer^ localPrintServer = gcnew LocalPrintServer();

   // Retrieving collection of local printer on user machine
   PrintQueueCollection^ localPrinterCollection = localPrintServer->GetPrintQueues();

   System::Collections::IEnumerator^ localPrinterEnumerator = localPrinterCollection->GetEnumerator();

   if (localPrinterEnumerator->MoveNext())
   {
      // Get PrintQueue from first available printer
      printQueue = ((PrintQueue^)localPrinterEnumerator->Current);
   } else
   {
      return nullptr;
   }
   // Get default PrintTicket from printer
   PrintTicket^ printTicket = printQueue->DefaultPrintTicket;

   PrintCapabilities^ printCapabilities = printQueue->GetPrintCapabilities();

   // Modify PrintTicket
   if (printCapabilities->CollationCapability->Contains(Collation::Collated))
   {
      printTicket->Collation = Collation::Collated;
   }
   if (printCapabilities->DuplexingCapability->Contains(Duplexing::TwoSidedLongEdge))
   {
      printTicket->Duplexing = Duplexing::TwoSidedLongEdge;
   }
   if (printCapabilities->StaplingCapability->Contains(Stapling::StapleDualLeft))
   {
      printTicket->Stapling = Stapling::StapleDualLeft;
   }
   return printTicket;
};// end:GetPrintTicketFromPrinter()

// ---------------------- GetPrintTicketFromPrinter -----------------------
/// <summary>
///   Returns a PrintTicket based on the current default printer.</summary>
/// <returns>
///   A PrintTicket for the current local default printer.</returns>
private PrintTicket GetPrintTicketFromPrinter()
{
    PrintQueue printQueue = null;

    LocalPrintServer localPrintServer = new LocalPrintServer();

    // Retrieving collection of local printer on user machine
    PrintQueueCollection localPrinterCollection =
        localPrintServer.GetPrintQueues();

    System.Collections.IEnumerator localPrinterEnumerator =
        localPrinterCollection.GetEnumerator();

    if (localPrinterEnumerator.MoveNext())
    {
        // Get PrintQueue from first available printer
        printQueue = (PrintQueue)localPrinterEnumerator.Current;
    }
    else
    {
        // No printer exist, return null PrintTicket
        return null;
    }

    // Get default PrintTicket from printer
    PrintTicket printTicket = printQueue.DefaultPrintTicket;

    PrintCapabilities printCapabilities = printQueue.GetPrintCapabilities();

    // Modify PrintTicket
    if (printCapabilities.CollationCapability.Contains(Collation.Collated))
    {
        printTicket.Collation = Collation.Collated;
    }

    if ( printCapabilities.DuplexingCapability.Contains(
            Duplexing.TwoSidedLongEdge) )
    {
        printTicket.Duplexing = Duplexing.TwoSidedLongEdge;
    }

    if (printCapabilities.StaplingCapability.Contains(Stapling.StapleDualLeft))
    {
        printTicket.Stapling = Stapling.StapleDualLeft;
    }

    return printTicket;
}// end:GetPrintTicketFromPrinter()

' ---------------------- GetPrintTicketFromPrinter -----------------------
''' <summary>
'''   Returns a PrintTicket based on the current default printer.</summary>
''' <returns>
'''   A PrintTicket for the current local default printer.</returns>
Private Function GetPrintTicketFromPrinter() As PrintTicket
    Dim printQueue As PrintQueue = Nothing

    Dim localPrintServer As New LocalPrintServer()

    ' Retrieving collection of local printer on user machine
    Dim localPrinterCollection As PrintQueueCollection = localPrintServer.GetPrintQueues()

    Dim localPrinterEnumerator As System.Collections.IEnumerator = localPrinterCollection.GetEnumerator()

    If localPrinterEnumerator.MoveNext() Then
        ' Get PrintQueue from first available printer
        printQueue = CType(localPrinterEnumerator.Current, PrintQueue)
    Else
        ' No printer exist, return null PrintTicket
        Return Nothing
    End If

    ' Get default PrintTicket from printer
    Dim printTicket As PrintTicket = printQueue.DefaultPrintTicket

    Dim printCapabilities As PrintCapabilities = printQueue.GetPrintCapabilities()

    ' Modify PrintTicket
    If printCapabilities.CollationCapability.Contains(Collation.Collated) Then
        printTicket.Collation = Collation.Collated
    End If

    If printCapabilities.DuplexingCapability.Contains(Duplexing.TwoSidedLongEdge) Then
        printTicket.Duplexing = Duplexing.TwoSidedLongEdge
    End If

    If printCapabilities.StaplingCapability.Contains(Stapling.StapleDualLeft) Then
        printTicket.Stapling = Stapling.StapleDualLeft
    End If

    Return printTicket
End Function ' end:GetPrintTicketFromPrinter()

Se aplica a

LocalPrintServer(LocalPrintServerIndexedProperty[])

Inicializa una nueva instancia de la clase LocalPrintServer que tiene la matriz LocalPrintServerIndexedProperty especificada.

public:
 LocalPrintServer(cli::array <System::Printing::LocalPrintServerIndexedProperty> ^ propertiesFilter);

public LocalPrintServer (System.Printing.LocalPrintServerIndexedProperty[] propertiesFilter);

new System.Printing.LocalPrintServer : System.Printing.LocalPrintServerIndexedProperty[] -> System.Printing.LocalPrintServer

Public Sub New (propertiesFilter As LocalPrintServerIndexedProperty())

Parámetros

propertiesFilter: LocalPrintServerIndexedProperty[]

Matriz de las propiedades que el constructor inicializa.

Se aplica a

LocalPrintServer(PrintSystemDesiredAccess)

Inicializa una nueva instancia de la clase LocalPrintServer que con la propiedad PrintSystemDesiredAccess especificada.

public:
 LocalPrintServer(System::Printing::PrintSystemDesiredAccess desiredAccess);

public LocalPrintServer (System.Printing.PrintSystemDesiredAccess desiredAccess);

new System.Printing.LocalPrintServer : System.Printing.PrintSystemDesiredAccess -> System.Printing.LocalPrintServer

Public Sub New (desiredAccess As PrintSystemDesiredAccess)

Parámetros

desiredAccess: PrintSystemDesiredAccess

Valor que especifica el tipo de acceso al servidor de impresión que la aplicación necesita.

Excepciones

PrintServerException

desiredAccess es un valor que sólo puede aplicarse a un objeto PrintQueue, no a un objeto LocalPrintServer. Por ejemplo, UsePrinter.

Ejemplos

En el ejemplo siguiente se muestra cómo usar este constructor en el código que instalará una segunda impresora que difiere en sus propiedades de una impresora existente solo en la ubicación, el puerto y el estado compartido.

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

Se aplica a

LocalPrintServer(String[])

Inicializa una nueva instancia de la clase LocalPrintServer que tiene las propiedades especificadas.

public:
 LocalPrintServer(cli::array <System::String ^> ^ propertiesFilter);

public LocalPrintServer (string[] propertiesFilter);

new System.Printing.LocalPrintServer : string[] -> System.Printing.LocalPrintServer

Public Sub New (propertiesFilter As String())

Parámetros

propertiesFilter: String[]

Matriz de los nombres de las propiedades que el constructor inicializa.

Se aplica a

LocalPrintServer(LocalPrintServerIndexedProperty[], PrintSystemDesiredAccess)

Inicializa una nueva instancia de la clase LocalPrintServer que tiene la matriz LocalPrintServerIndexedProperty especificada y los derechos, PrintSystemDesiredAccess especificados.

public:
 LocalPrintServer(cli::array <System::Printing::LocalPrintServerIndexedProperty> ^ propertiesFilter, System::Printing::PrintSystemDesiredAccess desiredAccess);

public LocalPrintServer (System.Printing.LocalPrintServerIndexedProperty[] propertiesFilter, System.Printing.PrintSystemDesiredAccess desiredAccess);

new System.Printing.LocalPrintServer : System.Printing.LocalPrintServerIndexedProperty[] * System.Printing.PrintSystemDesiredAccess -> System.Printing.LocalPrintServer

Public Sub New (propertiesFilter As LocalPrintServerIndexedProperty(), desiredAccess As PrintSystemDesiredAccess)

Parámetros

propertiesFilter: LocalPrintServerIndexedProperty[]

Matriz de las propiedades que el constructor inicializa.

desiredAccess: PrintSystemDesiredAccess

Valor que especifica el tipo de acceso al servidor de impresión que el programa necesita.

Excepciones

PrintServerException

desiredAccess es un valor que sólo puede aplicarse a un objeto PrintQueue, no a un objeto LocalPrintServer. Por ejemplo, UsePrinter.

Se aplica a

LocalPrintServer(String[], PrintSystemDesiredAccess)

Inicializa una instancia nueva de la clase LocalPrintServer que tiene las propiedades y el acceso PrintSystemDesiredAccess especificados.

public:
 LocalPrintServer(cli::array <System::String ^> ^ propertiesFilter, System::Printing::PrintSystemDesiredAccess desiredAccess);

public LocalPrintServer (string[] propertiesFilter, System.Printing.PrintSystemDesiredAccess desiredAccess);

new System.Printing.LocalPrintServer : string[] * System.Printing.PrintSystemDesiredAccess -> System.Printing.LocalPrintServer

Public Sub New (propertiesFilter As String(), desiredAccess As PrintSystemDesiredAccess)

Parámetros

propertiesFilter: String[]

Matriz de los nombres de las propiedades que el constructor inicializa.

desiredAccess: PrintSystemDesiredAccess

Valor que especifica el tipo de acceso al servidor de impresión que la aplicación necesita.

Excepciones

PrintServerException

desiredAccess es un valor que sólo puede aplicarse a un objeto PrintQueue, no a un objeto LocalPrintServer. Por ejemplo, UsePrinter.

Se aplica a

LocalPrintServer Constructores

Definición

Sobrecargas

LocalPrintServer()

Ejemplos

Se aplica a

LocalPrintServer(LocalPrintServerIndexedProperty[])

Parámetros

Se aplica a

LocalPrintServer(PrintSystemDesiredAccess)

Parámetros

Excepciones

Ejemplos

Se aplica a

LocalPrintServer(String[])

Parámetros

Se aplica a

LocalPrintServer(LocalPrintServerIndexedProperty[], PrintSystemDesiredAccess)

Parámetros

Excepciones

Se aplica a

LocalPrintServer(String[], PrintSystemDesiredAccess)

Parámetros

Excepciones

Se aplica a

Comentarios

Recursos adicionales