LocalPrintServer.GetDefaultPrintQueue Method (System.Printing)

Switch View :
ScriptFree
.NET Framework Class Library
LocalPrintServer.GetDefaultPrintQueue Method

Returns a reference to the default print queue of the LocalPrintServer.

Namespace:  System.Printing
Assembly:  System.Printing (in System.Printing.dll)
Syntax

Visual Basic
Public Shared Function GetDefaultPrintQueue As PrintQueue
C#
public static PrintQueue GetDefaultPrintQueue()
Visual C++
public:
static PrintQueue^ GetDefaultPrintQueue()
F#
static member GetDefaultPrintQueue : unit -> PrintQueue 

Return Value

Type: System.Printing.PrintQueue
The default PrintQueue.
Remarks

Your application will have only UsePrinter access to the default queue, even if you have AdministrateServer rights to the print server. To open the queue with greater access, use one of the PrintQueue constructors that enables you to specify the desired access level.

Examples

The following example shows how to use this method to discover at run time the properties, and the types of those properties, of a print queue, without using reflection.

Visual Basic


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



C#


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



Version Information

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
See Also

Reference