System.Messaging Névtér

Olyan osztályokat biztosít, amelyek lehetővé teszik az üzenetsorok hálózati csatlakoztatását, monitorozását és felügyeletét, valamint üzenetek küldését, fogadását vagy betekintőbe helyezését.

Osztályok

Name	Description
AccessControlEntry	Hozzáférési jogosultságokat ad meg egy megbízhatónak (felhasználónak, csoportnak vagy számítógépnek) a gyakori feladatok alkalmazásspecifikus implementációinak végrehajtásához.
AccessControlList	A hozzáférés-vezérlés bejegyzéseinek listáját tartalmazza, amely egy vagy több megbízható hozzáférési jogosultságát adja meg.
ActiveXMessageFormatter	Szerializálja vagy deszerializálja a primitív adattípusokat és más objektumokat egy Üzenetsor-üzenet törzsébe vagy törzséből az MSMQ ActiveX-összetevővel kompatibilis formátum használatával.
BinaryMessageFormatter	Bináris formátumban szerializál vagy deszerializál egy objektumot vagy egy csatlakoztatott objektumok teljes gráfját egy Üzenetsor-üzenet törzsébe vagy törzséből.
Cursor	Az A Cursor egy adott hely fenntartására szolgál az MessageQueue üzenetsor üzeneteinek olvasása során.
DefaultPropertiesToSend	Megadja azokat az alapértelmezett tulajdonságértékeket, amelyeket a példányokon kívüli Message objektumok üzenetsorba való küldésekor használnak.
Message	Hozzáférést biztosít a Message Queuing-üzenetek definiálásához szükséges tulajdonságokhoz.
MessageEnumerator	Csak előre mutató kurzort biztosít az üzenetsor üzenetsorában lévő üzenetek számbavételéhez.
MessagePropertyFilter	Szabályozza és kiválasztja az üzenetek üzenetsorból való betekintésekor vagy fogadásakor lekért tulajdonságokat.
MessageQueue	Hozzáférést biztosít egy üzenetsorhoz egy Üzenetsor-kezelő kiszolgálón.
MessageQueueAccessControlEntry	Hozzáférési jogosultságokat ad meg egy megbízhatónak (felhasználónak, csoportnak vagy számítógépnek) a Message Queuing-feladatok végrehajtásához.
MessageQueueCriteria	Szűri az üzenetsorokat, amikor lekérdezést hajt végre az MessageQueue osztály metódusával GetPublicQueues() .
MessageQueueEnumerator	Csak előre mutató kurzort biztosít az üzenetsor üzenetsorában lévő üzenetek számbavételéhez.
MessageQueueException	A Microsoft Message Queuing belső hibája esetén jelentkező kivétel.
MessageQueueInstaller	Lehetővé teszi az alkalmazás számára szükséges üzenetsor telepítését és konfigurálását a futtatáshoz. Ezt az osztályt a telepítési segédprogram hívja meg, például InstallUtil.exe, amikor telepít egy MessageQueue.
MessageQueuePermission	Lehetővé teszi az üzenetküldéshez szükséges kódhozzáférési engedélyek vezérlését.
MessageQueuePermissionAttribute	Engedélyezi a deklaratív MessageQueue engedélyellenőrzéseket.
MessageQueuePermissionEntry	Meghatározza a kódhozzáférési biztonsági engedélykészlet legkisebb egységét az üzenetküldéshez.
MessageQueuePermissionEntryCollection	Erősen gépelt objektumgyűjteményt MessageQueuePermissionEntry tartalmaz.
MessageQueueTransaction	Belső Üzenetsor-kezelési tranzakciót biztosít.
MessagingDescriptionAttribute	Megadja egy tulajdonság vagy esemény leírását.
PeekCompletedEventArgs	Adatokat biztosít az PeekCompleted eseményhez. Amikor az aszinkron betekintő művelet eseménykezelőt hív meg, az osztály egy példányát a rendszer átadja a kezelőnek.
ReceiveCompletedEventArgs	Adatokat biztosít az ReceiveCompleted eseményhez. Amikor az aszinkron fogadási művelet eseménykezelőt hív meg, az osztály egy példányát a rendszer átadja a kezelőnek.
SecurityContext	Az üzenetsor üzeneteinek biztonsági környezetét jelöli.
Trustee	Megadja azt a felhasználói fiókot, csoportfiókot vagy bejelentkezési munkamenetet, amelyre a hozzáférés-vezérlési bejegyzés vonatkozik.
XmlMessageFormatter	Szerializálja és deszerializálja az objektumokat egy üzenet törzsébe vagy törzséből az XSD-sémadefiníción alapuló XML-formátum használatával.

Interfészek

Name	Description
IMessageFormatter	Szerializálja vagy deszerializálja az objektumokat a Message Queuing-üzenet törzséből.

Enumerációk

Name	Description
AccessControlEntryType	Megadja, hogy engedélyezi, megtagadja vagy visszavonja-e a hozzáférési jogosultságokat egy megbízott számára.
AcknowledgeTypes	Megadja azokat a nyugtázási üzeneteket, amelyeket a Message Queuing visszatér a küldő alkalmazáshoz.
Acknowledgment	Az üzenetkézbesítési kísérlet eredményét adja meg.
CryptographicProviderType	Megadja a digitális aláírások érvényesítéséhez elérhető titkosítási szolgáltatókat.
EncryptionAlgorithm	Megadja a titkos üzenetek üzenettörzsének titkosításához használt titkosítási algoritmust.
EncryptionRequired	Meghatározza az üzenetsor által fogadott üzenetek adatvédelmi szintjét.
GenericAccessRights	A 2000-Windows és Windows NT-hozzáférési formátumot használja a Message Queuing által az olvasáshoz, íráshoz és végrehajtáshoz szükséges szabványos és objektumspecifikus hozzáférési jogosultságokra leképező közös hozzáférési jogosultságok halmazának megadásához.
HashAlgorithm	Meghatározza a Message Queuing által az üzenetek hitelesítése során használt kivonatoló algoritmust.
MessageLookupAction	Egy üzenetsorba betekintő vagy fogadó üzenetet ad meg.
MessagePriority	Meghatározza, hogy az üzenetsor-kezelés prioritása az üzenetsorba való továbbításkor és a célsorba való beszúráskor érvényes-e.
MessageQueueAccessRights	A Message Queuingre vonatkozó műveletek objektumspecifikus hozzáférési jogosultságainak készletét adja meg.
MessageQueueErrorCode	Azonosítja a Message Queuing alkalmazásban előforduló és kivételt generáló hiba forrását MessageQueueException .
MessageQueuePermissionAccess	Az engedélyosztályok által System.Messaging használt hozzáférési szinteket határozza meg.
MessageQueueTransactionStatus	Egy belső Message Queuing-tranzakció állapotát adja meg.
MessageQueueTransactionType	A Message Queuing tranzakció típusát adja meg.
MessageType	Az üzenet típusát azonosítja. Az üzenetek lehetnek tipikus Message Queuing-üzenetek, pozitív (érkezési és olvasási) vagy negatív (érkezési és olvasási) nyugtázási üzenetek vagy jelentésüzenetek.
PeekAction	Azt jelzi, hogy betekintse-e az aktuális üzenetet egy üzenetsorba vagy a következő üzenetbe.
QueueAccessMode	Meghatározza a létrehozási időponthoz tartozó MessageQueue hozzáférési módot.
StandardAccessRights	A legtöbb biztonságos objektumtípushoz gyakran használt műveleteknek megfelelő szabványos hozzáférési jogosultságok készletét adja meg.
TrusteeType	Megadja a megbízott típusát.

Delegáltak

Name	Description
PeekCompletedEventHandler	Azt a metódust jelöli, amely egy PeekCompleted .MessageQueue
ReceiveCompletedEventHandler	Azt a metódust jelöli, amely egy ReceiveCompleted .MessageQueue

Megjegyzések

Az osztály tagjai az MessageQueue alábbi módszereket tartalmazzák az üzenetek üzenetsorba való olvasására és írására:

• A Send metódus lehetővé teszi, hogy az alkalmazás üzeneteket írjon az üzenetsorba. A metódus túlterhelései lehetővé teszik annak megadását, hogy az üzenetet egy Message (a küldött információk részletes szabályozását lehetővé tevő) vagy bármely más felügyelt objektummal küldje el, beleértve az alkalmazásspecifikus osztályokat is. A metódus támogatja az üzenetek tranzakció részeként történő küldését is.

• A Receive, ReceiveByIdés ReceiveByCorrelationId metódusok funkcióval olvasnak üzeneteket egy üzenetsorból. A metódushoz hasonlóan ezek a Send metódusok túlterheléseket is biztosítanak, amelyek támogatják a tranzakciós üzenetsorok feldolgozását. Ezek a módszerek túlterhelést is biztosítanak időtúllépéssel.

  Olyan paraméterek kikapcsolva, amelyek lehetővé teszik a feldolgozás folytatását, ha az üzenetsor üres. Mivel ezek a metódusok példaként használhatók a szinkron feldolgozásra, addig szakítják meg az aktuális szálat, amíg el nem érhető egy üzenet, hacsak nem ad meg időtúllépést.

• A Peek metódus hasonló Receive, de olvasáskor nem távolít el egy üzenetet az üzenetsorból. Mivel Peek az üzenetsor tartalma nem változik, a tranzakciós feldolgozást nem lehet túlterhelni. Mivel azonban az PeekReceiveüzenetsorból szinkron módon olvas üzeneteket, a metódus túlterhelései támogatják az időtúllépés megadását annak érdekében, hogy a szál határozatlan ideig várakozhasson.

• A BeginPeek, EndPeek(IAsyncResult), BeginReceiveés EndReceive(IAsyncResult) metódusok lehetővé teszik az üzenetek aszinkron olvasását az üzenetsorból. Nem szakítják meg az aktuális szálat, miközben arra várnak, hogy egy üzenet megérkezik az üzenetsorba.

Az osztály alábbi módszerei biztosítják az MessageQueue üzenetsorok listájának meghatározott feltételek szerinti lekérését és annak meghatározását, hogy léteznek-e adott üzenetsorok:

• GetPrivateQueuesByMachine(String) lehetővé teszi a privát üzenetsorok lekérését a számítógépen.

• GetPublicQueuesByCategory(Guid), GetPublicQueuesByLabel(String)és GetPublicQueuesByMachine(String) adjon meg módszereket a nyilvános üzenetsorok gyakori feltételek szerinti lekérésére. A túlterheltség GetPublicQueues még finomabb részleteket biztosít az üzenetsorok számos keresési feltétel alapján történő kiválasztásához.

Az osztály egyéb módszerei a MessageQueue következő funkciókat biztosítják:

• Üzenetsor-üzenetsorok létrehozása és törlése.

• Üzenetszámláló használata az üzenetsor üzeneteinek végiglépéséhez.

• Üzenetsor-enumerátor használata a rendszer üzenetsorain való iteráláshoz.

• ACL-alapú hozzáférési jogosultságok beállítása.

• A kapcsolati gyorsítótár használata.

Az Message osztály részletes vezérlést biztosít az üzenetsorba küldött információk felett, és az üzenetsorból érkező üzenetek fogadásához vagy betekintésekor használt objektum. Az üzenettörzs mellett az osztály tulajdonságai közé tartoznak a nyugtázási beállítások, a Message formázó kiválasztása, az azonosítás, a hitelesítési és titkosítási információk, az időbélyegek, a nyomkövetés használatára vonatkozó jelzések, a kiszolgálónaplózás és a kézbesítetlen levelek üzenetsorai, valamint a tranzakciós adatok.

Az MessageQueue összetevő a következő három formátumhoz van társítva, amelyek lehetővé teszik az üzenetsorokból küldött és fogadott üzenetek szerializálását és deszerializálását:

• Ez XmlMessageFormatter lazán összekapcsolt üzenetkezelést biztosít, amely lehetővé teszi a szerializált típusok független verziószámozását az ügyfélen és a kiszolgálón.

• Ez ActiveXMessageFormatter kompatibilis az MSMQ COM vezérlővel. Lehetővé teszi a vezérlő által fogadható típusok küldését, valamint a vezérlő által küldött típusok fogadását.

• Ez BinaryMessageFormatter gyorsabb alternatívát kínál a XmlMessageFormatter, de a lazán összekapcsolt üzenetküldés előnyei nélkül.

A névtér más osztályai támogatják a kódhozzáférést és az Messaging ACL-alapú biztonságot, szűrik Message a tulajdonságokat, amikor üzeneteket olvasnak egy üzenetsorból, és tranzakciókat használnak üzenetek küldésekor és fogadásakor.