LocalPrintServer Costruttori

Riferimento

Definizione

Spazio dei nomi:: System.Printing

Assembly:: System.Printing.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Inizializza una nuova istanza della classe LocalPrintServer.

Overload

LocalPrintServer()	Inizializza una nuova istanza della classe LocalPrintServer.
LocalPrintServer(LocalPrintServerIndexedProperty[])	Inizializza una nuova istanza della classe LocalPrintServer con la matrice LocalPrintServerIndexedProperty specificata.
LocalPrintServer(PrintSystemDesiredAccess)	Inizializza una nuova istanza della classe LocalPrintServer con l'oggetto PrintSystemDesiredAccess specificato.
LocalPrintServer(String[])	Inizializza una nuova istanza della classe LocalPrintServer con le proprietà specificate.
LocalPrintServer(LocalPrintServerIndexedProperty[], PrintSystemDesiredAccess)	Inizializza una nuova istanza della classe LocalPrintServer con la matrice LocalPrintServerIndexedProperty e l'oggetto PrintSystemDesiredAccess specificati.
LocalPrintServer(String[], PrintSystemDesiredAccess)	Inizializza una nuova istanza della classe LocalPrintServer con le proprietà e l'oggetto PrintSystemDesiredAccess specificati.

LocalPrintServer()

Inizializza una nuova istanza della classe LocalPrintServer.

public:
 LocalPrintServer();

public LocalPrintServer ();

Public Sub New ()

Esempio

Nell'esempio seguente viene illustrato come usare questo costruttore nel codice che testa le funzionalità di una stampante e configura un processo di stampa per sfruttarli.

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

Si applica a

LocalPrintServer(LocalPrintServerIndexedProperty[])

Inizializza una nuova istanza della classe LocalPrintServer con la matrice LocalPrintServerIndexedProperty specificata.

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

Parametri

propertiesFilter: LocalPrintServerIndexedProperty[]

Matrice delle proprietà inizializzate dal costruttore.

Si applica a

LocalPrintServer(PrintSystemDesiredAccess)

Inizializza una nuova istanza della classe LocalPrintServer con l'oggetto PrintSystemDesiredAccess specificato.

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)

Parametri

desiredAccess: PrintSystemDesiredAccess

Valore che specifica il tipo di accesso al server di stampa necessario per l'applicazione.

Eccezioni

PrintServerException

desiredAccess è un valore applicabile unicamente a un oggetto PrintQueue anziché a un oggetto LocalPrintServer. Ad esempio UsePrinter.

Esempio

Nell'esempio seguente viene illustrato come usare questo costruttore nel codice che installerà una seconda stampante che differisce nelle relative proprietà da una stampante esistente solo in posizione, porta e stato condiviso.

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

Si applica a

LocalPrintServer(String[])

Inizializza una nuova istanza della classe LocalPrintServer con le proprietà specificate.

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

Parametri

propertiesFilter: String[]

Matrice dei nomi delle proprietà inizializzate dal costruttore.

Si applica a

LocalPrintServer(LocalPrintServerIndexedProperty[], PrintSystemDesiredAccess)

Inizializza una nuova istanza della classe LocalPrintServer con la matrice LocalPrintServerIndexedProperty e l'oggetto PrintSystemDesiredAccess specificati.

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)

Parametri

propertiesFilter: LocalPrintServerIndexedProperty[]

Matrice delle proprietà inizializzate dal costruttore.

desiredAccess: PrintSystemDesiredAccess

Valore che specifica il tipo di accesso al server di stampa necessario per il programma.

Eccezioni

PrintServerException

desiredAccess è un valore applicabile unicamente a un oggetto PrintQueue anziché a un oggetto LocalPrintServer. Ad esempio UsePrinter.

Si applica a

LocalPrintServer(String[], PrintSystemDesiredAccess)

Inizializza una nuova istanza della classe LocalPrintServer con le proprietà e l'oggetto PrintSystemDesiredAccess specificati.

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)

Parametri

propertiesFilter: String[]

Matrice dei nomi delle proprietà inizializzate dal costruttore.

desiredAccess: PrintSystemDesiredAccess

Valore che specifica il tipo di accesso al server di stampa necessario per l'applicazione.

Eccezioni

PrintServerException

desiredAccess è un valore applicabile unicamente a un oggetto PrintQueue anziché a un oggetto LocalPrintServer. Ad esempio UsePrinter.

Si applica a

LocalPrintServer Costruttori

Definizione

Overload

LocalPrintServer()

Esempio

Si applica a

LocalPrintServer(LocalPrintServerIndexedProperty[])

Parametri

Si applica a

LocalPrintServer(PrintSystemDesiredAccess)

Parametri

Eccezioni

Esempio

Si applica a

LocalPrintServer(String[])

Parametri

Si applica a

LocalPrintServer(LocalPrintServerIndexedProperty[], PrintSystemDesiredAccess)

Parametri

Eccezioni

Si applica a

LocalPrintServer(String[], PrintSystemDesiredAccess)

Parametri

Eccezioni

Si applica a

Commenti e suggerimenti

Risorse aggiuntive