MessageQueueEnumerator MessageQueueEnumerator MessageQueueEnumerator MessageQueueEnumerator Class

Definition

Stellt einen Vorwärtscursor zum Aufzählen der Nachrichten in einer Nachrichtenwarteschlange bereit.Provides a forward-only cursor to enumerate through messages in a message queue.

public ref class MessageQueueEnumerator : MarshalByRefObject, IDisposable, System::Collections::IEnumerator
public class MessageQueueEnumerator : MarshalByRefObject, IDisposable, System.Collections.IEnumerator
type MessageQueueEnumerator = class
    inherit MarshalByRefObject
    interface IEnumerator
    interface IDisposable
Public Class MessageQueueEnumerator
Inherits MarshalByRefObject
Implements IDisposable, IEnumerator
Vererbung
MessageQueueEnumeratorMessageQueueEnumeratorMessageQueueEnumeratorMessageQueueEnumerator
Implementiert

Beispiele

Im folgenden Codebeispiel durchläuft alle Meldungswarteschlangen im Netzwerk und untersucht den Pfad für jede Warteschlange.The following code example iterates through all the message queues in the network, and examines the path for each queue. Schließlich wird die Anzahl von öffentlichen Warteschlangen im Netzwerk.Finally, it displays the number of public queues on the network.

#using <System.dll>
#using <System.Messaging.dll>

using namespace System;
using namespace System::Messaging;

//**************************************************
// Iterates through message queues and examines the
// path for each queue. Also displays the number of
// public queues on the network.
//**************************************************
void ListPublicQueues()
{
   
   // Holds the count of private queues.
   int numberQueues = 0;
   
   // Get a cursor into the queues on the network.
   MessageQueueEnumerator^ myQueueEnumerator = MessageQueue::GetMessageQueueEnumerator();
   
   // Move to the next queue and read its path.
   while ( myQueueEnumerator->MoveNext() )
   {
      
      // Increase the count if priority is Lowest.
      Console::WriteLine( myQueueEnumerator->Current->Path );
      numberQueues++;
   }

   
   // Display final count.
   Console::WriteLine( "Number of public queues: {0}", numberQueues );
   return;
}


//**************************************************
// Provides an entry point into the application.
//   
// This example uses a cursor to step through the
// message queues and list the public queues on the
// network.
//**************************************************
int main()
{
   
   // Output the count of Lowest priority messages.
   ListPublicQueues();
}

using System;
using System.Messaging;

namespace MyProject
{
	/// <summary>
	/// Provides a container class for the example.
	/// </summary>
	public class MyNewQueue
	{

		//**************************************************
		// Provides an entry point into the application.
		//		 
		// This example uses a cursor to step through the
		// message queues and list the public queues on the
		// network.
		//**************************************************

		public static void Main()
		{
			// Create a new instance of the class.
			MyNewQueue myNewQueue = new MyNewQueue();

			// Output the count of Lowest priority messages.
			myNewQueue.ListPublicQueues();
						
			return;
		}


		//**************************************************
		// Iterates through message queues and examines the
		// path for each queue. Also displays the number of
		// public queues on the network.
		//**************************************************
		
		public void ListPublicQueues()
		{
			// Holds the count of private queues.
			uint numberQueues = 0;
	
			// Get a cursor into the queues on the network.
			MessageQueueEnumerator myQueueEnumerator = 
				MessageQueue.GetMessageQueueEnumerator();

			// Move to the next queue and read its path.
			while(myQueueEnumerator.MoveNext())
			{
				// Increase the count if priority is Lowest.
				Console.WriteLine(myQueueEnumerator.Current.Path);
				numberQueues++;
			}

			// Display final count.
			Console.WriteLine("Number of public queues: " + 
				numberQueues.ToString());
			
			return;
		}
	}
}
Imports System
Imports System.Messaging



Public Class MyNewQueue


        
        ' Provides an entry point into the application.
        '		 
        ' This example uses a cursor to step through the
        ' message queues and list the public queues on the
        ' network.
        

        Public Shared Sub Main()

            ' Create a new instance of the class.
            Dim myNewQueue As New MyNewQueue()

            ' Output the count of Lowest priority messages.
            myNewQueue.ListPublicQueues()

            Return

        End Sub 'Main


        
        ' Iterates through message queues and examines the
        ' path for each queue. Also displays the number of
        ' public queues on the network.
        

        Public Sub ListPublicQueues()

            ' Holds the count of private queues.
            Dim numberQueues As Int32 = 0

            ' Get a cursor into the queues on the network.
            Dim myQueueEnumerator As MessageQueueEnumerator = _
                MessageQueue.GetMessageQueueEnumerator()

            ' Move to the next queue and read its path.
            While myQueueEnumerator.MoveNext()
                ' Increase the count if the priority is Lowest.
                Console.WriteLine(myQueueEnumerator.Current.Path)
                numberQueues += 1
            End While

            ' Display final count.
            Console.WriteLine(("Number of public queues: " + _
                numberQueues.ToString()))

            Return

        End Sub 'ListPublicQueues

End Class 'MyNewQueue

Hinweise

Verwendung MessageQueueEnumerator dynamische Interaktion mit Warteschlangen im Netzwerk.Use MessageQueueEnumerator for dynamic interaction with queues on the network. Methoden zur Verfügung, über die MessageQueue Klasse kann entweder Zurückgeben einer MessageQueueEnumerator mit einer dynamischen Liste von Warteschlangen oder ein Array mit einer Momentaufnahme der Warteschlange Auflistung, an der Zeit die angegebene Methode aufgerufen wurde.Methods available through the MessageQueue class can return either a MessageQueueEnumerator containing a dynamic list of queues, or an array that contains a snapshot of the queue collection at the time the specified method was called.

Es ist keine festgelegte Reihenfolge von Warteschlangen in einem Netzwerk.There is no defined ordering of queues in a network. Sie sind nicht sortiert ist, z. B. nach Computer "," Label "," öffentlichen oder privaten Status oder einen anderen Benutzer zugänglichen Kriterien.They are not ordered, for example, by computer, label, public or private status, or other user-accessible criteria. Ein MessageQueueEnumerator wird ein Cursor, an den Anfang einer dynamischen Liste initialisiert.A MessageQueueEnumerator is a cursor, initialized to the head of a dynamic list. Sie können den Cursor an der ersten Warteschlange der Enumeration verschieben, durch den Aufruf MoveNext.You can move the cursor to the first queue of the enumeration by calling MoveNext. Nachdem der Enumerator initialisiert wurde, können Sie MoveNext vorwärts zu durchlaufen, bis die verbleibenden Warteschlangen.After the enumerator has been initialized, you can use MoveNext to step forward through the remaining queues.

Es ist nicht möglich, auf eine MessageQueueEnumerator.It is not possible to step backward with a MessageQueueEnumerator. Ein Cursor kann nur vorwärtsbewegung Warteschlangen in der Enumeration.A cursor only allows forward movement through the queue enumeration. Sie können jedoch aufrufen Reset die Enumeration zurückgesetzt, und platzieren Sie den Cursor am Anfang der Liste erneut.However, you can call Reset to reset the enumeration and put the cursor at the beginning of the list again. Da der Enumerator dynamisch ist, kann eine Warteschlange, die außerhalb der aktuellen Cursorposition angefügt wird vom Enumerator zugegriffen werden.Because the enumerator is dynamic, a queue that is appended beyond the cursor's current position can be accessed by the enumerator. Eine Warteschlange, die vor der aktuellen Cursorposition eingefügt wird, kann ohne Zurücksetzen des ersten Aufruf zugegriffen werden.A queue that is inserted before the cursor's current position cannot be accessed without first calling Reset.

Eigenschaften

Current Current Current Current

Ruft die aktuelle MessageQueue der Enumeration ab.Gets the current MessageQueue of the enumeration.

LocatorHandle LocatorHandle LocatorHandle LocatorHandle

Ruft das systemeigene Handle von Message Queuing ab, das zum Suchen von Warteschlangen in einem Netzwerk verwendet wird.Gets the native Message Queuing handle used to locate queues in a network.

Methoden

Close() Close() Close() Close()

Gibt die dem Enumerator zugeordneten Ressourcen frei.Frees the resources associated with the enumerator.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Gibt alle vom MessageQueueEnumerator verwendeten Ressourcen frei.Releases all resources used by the MessageQueueEnumerator.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von MessageQueueEnumerator verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the MessageQueueEnumerator and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Gibt die von dieser Warteschlange reservierten Ressourcen frei.Releases the resources held by the queue.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MoveNext() MoveNext() MoveNext() MoveNext()

Setzt den Enumerator auf die nächste Warteschlange der Enumeration, sofern eine Warteschlange verfügbar ist.Advances the enumerator to the next queue of the enumeration, if one is currently available.

Reset() Reset() Reset() Reset()

Setzt den Cursor zurück auf den Anfang der Enumeration.Resets the cursor, so it points to the beginning of the enumeration.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

IEnumerator.Current IEnumerator.Current IEnumerator.Current IEnumerator.Current

Ruft die aktuelle MessageQueue der Enumeration ab.Gets the current MessageQueue of the enumeration.

Gilt für:

Siehe auch