System.Messaging Obor názvů

Poskytuje třídy, které umožňují připojení, monitorování a správu front zpráv v síti a odesílání, přijímání nebo náhled zpráv.

Třídy

AccessControlEntry	Určuje přístupová práva pro správce (uživatel, skupina nebo počítač) k provádění implementací běžných úloh specifických pro aplikaci.
AccessControlList	Obsahuje seznam položek řízení přístupu, které určují přístupová práva pro jednoho nebo více správců.
ActiveXMessageFormatter	Serializuje nebo deserializuje primitivní datové typy a jiné objekty do nebo z těla zprávy služby Řízení front zpráv pomocí formátu, který je kompatibilní se komponentou MSMQ ActiveX.
BinaryMessageFormatter	Serializuje nebo deserializuje objekt nebo celý graf propojených objektů do nebo z těla zprávy služby Řízení front zpráv pomocí binárního formátu.
Cursor	Při Cursor čtení zpráv fronty slouží k udržování konkrétního umístění v MessageQueue .
DefaultPropertiesToSend	Určuje výchozí hodnoty vlastností, které budou použity při odesílání objektů jiných než Message instancí do fronty zpráv.
Message	Poskytuje přístup k vlastnostem potřebným k definování zprávy služby Řízení front zpráv.
MessageEnumerator	Poskytuje kurzor jen pro přeposlání pro výčet zpráv ve frontě zpráv.
MessagePropertyFilter	Určuje a vybere vlastnosti, které se načtou při náhledu nebo příjmu zpráv z fronty zpráv.
MessageQueue	Poskytuje přístup k frontě na serveru služby Řízení front zpráv.
MessageQueueAccessControlEntry	Určuje přístupová práva pro správce (uživatele, skupinu nebo počítač) k provádění úloh služby Řízení front zpráv.
MessageQueueCriteria	Filtruje fronty zpráv při provádění dotazu pomocí MessageQueue metody třídy GetPublicQueues() .
MessageQueueEnumerator	Poskytuje kurzor jen pro přeposlání pro výčet zpráv ve frontě zpráv.
MessageQueueException	Výjimka, která je vyvolán, pokud dojde k vnitřní chybě služby Řízení front zpráv.
MessageQueueInstaller	Umožňuje nainstalovat a nakonfigurovat frontu, kterou vaše aplikace potřebuje ke spuštění. Tato třída je volána instalačním nástrojem, například InstallUtil.exe při instalaci .MessageQueue
MessageQueuePermission	Umožňuje řídit přístupová oprávnění ke kódu pro zasílání zpráv.
MessageQueuePermissionAttribute	Umožňuje kontroly deklarativních MessageQueue oprávnění.
MessageQueuePermissionEntry	Definuje nejmenší jednotku oprávnění zabezpečení přístupu kódu pro zasílání zpráv.
MessageQueuePermissionEntryCollection	Obsahuje kolekci objektů silného MessageQueuePermissionEntry typu.
MessageQueueTransaction	Poskytuje interní transakci služby Řízení front zpráv.
MessagingDescriptionAttribute	Určuje popis vlastnosti nebo události.
PeekCompletedEventArgs	Poskytuje data pro událost PeekCompleted. Když asynchronní operace náhledu volá obslužnou rutinu události, instance této třídy je předána obslužné rutině.
ReceiveCompletedEventArgs	Poskytuje data pro událost ReceiveCompleted. Když asynchronní operace příjmu volá obslužnou rutinu události, instance této třídy je předána obslužné rutině.
SecurityContext	Představuje kontext zabezpečení pro zprávu ve frontě.
Trustee	Určuje uživatelský účet, skupinový účet nebo relaci přihlášení, na kterou se vztahuje položka řízení přístupu.
XmlMessageFormatter	Serializuje a deserializuje objekty do nebo z textu zprávy pomocí formátu XML založeného na definici schématu XSD.

Rozhraní

IMessageFormatter

Serializuje nebo deserializuje objekty z textu zprávy služby Řízení front zpráv.

Výčty

AccessControlEntryType	Určuje, jestli se mají správci povolit, odepřít nebo odvolat přístupová práva.
AcknowledgeTypes	Určuje typy potvrzovací zprávy, které služba Řízení front zpráv vrací do odesílající aplikace.
Acknowledgment	Určuje výsledek pokusu o doručení zprávy.
CryptographicProviderType	Určuje zprostředkovatele kryptografických služeb, kteří jsou k dispozici pro ověřování digitálních podpisů.
EncryptionAlgorithm	Určuje šifrovací algoritmus použitý k šifrování textu zprávy soukromé zprávy.
EncryptionRequired	Určuje úroveň ochrany osobních údajů zpráv přijatých frontou.
GenericAccessRights	Používá formát přístupu systému Windows 2000 a Windows NT k určení sady společných přístupových práv, která služba Řízení front zpráv mapuje na standardní i objektová přístupová práva pro čtení, zápis a spouštění.
HashAlgorithm	Určuje algoritmus hash používaný službou Řízení front zpráv při ověřování zpráv.
MessageLookupAction	Určuje zprávu, která se má zobrazit nebo přijmout z fronty zpráv.
MessagePriority	Určuje prioritu služby Řízení front zpráv, která se vztahuje na zprávu, když je na cestě do fronty a při vkládání zprávy do cílové fronty.
MessageQueueAccessRights	Určuje sadu přístupových práv specifických pro objekt pro operace specifické pro službu Řízení front zpráv.
MessageQueueErrorCode	Identifikuje zdroj chyby, ke které došlo v aplikaci Řízení front zpráv a vygenerovala MessageQueueException výjimku.
MessageQueuePermissionAccess	Definuje úrovně přístupu používané třídami System.Messaging oprávnění.
MessageQueueTransactionStatus	Určuje stav interní transakce služby Řízení front zpráv.
MessageQueueTransactionType	Určuje typ transakce služby Řízení front zpráv.
MessageType	Určuje typ zprávy. Zpráva může být typická zpráva služby Řízení front zpráv, kladná (příchozí a přečtená) nebo negativní (příchozí a přečtená) potvrzovací zpráva nebo zpráva.
PeekAction	Určuje, jestli se má zobrazit aktuální zpráva ve frontě nebo další zpráva.
QueueAccessMode	Určuje režim přístupu pro při MessageQueue vytváření.
StandardAccessRights	Určuje sadu standardních přístupových práv, která odpovídají operacím běžným pro většinu typů zabezpečitelných objektů.
TrusteeType	Určuje typ správce.

Delegáti

PeekCompletedEventHandler	Představuje metodu, která bude zpracovávat PeekCompleted událost objektu MessageQueue.
ReceiveCompletedEventHandler	Představuje metodu, která bude zpracovávat ReceiveCompleted událost objektu MessageQueue.

Poznámky

Členové MessageQueue třídy zahrnují následující metody pro čtení a zápis zpráv do fronty:

• Metoda Send umožňuje aplikaci zapisovat zprávy do fronty. Přetížení metody umožňuje určit, zda se má zpráva odeslat pomocí Message (který poskytuje podrobnou kontrolu nad informacemi, které odesíláte) nebo jiným spravovaným objektem, včetně tříd specifických pro aplikaci. Metoda také podporuje odesílání zpráv jako součást transakce.

• Metody Receive, ReceiveByIda ReceiveByCorrelationId poskytují funkce pro čtení zpráv z fronty. Send Stejně jako metoda poskytují tyto metody přetížení, které podporují zpracování transakční fronty. Tyto metody také poskytují přetížení s časovým limitem.

  Vyvolte parametry, které umožňují pokračovat ve zpracování, pokud je fronta prázdná. Vzhledem k tomu, že tyto metody jsou příklady synchronního zpracování, přerušují aktuální vlákno, dokud není k dispozici zpráva, pokud neurčujete časový limit.

• Metoda Peek je podobná Receivemetodě , ale nezpůsobí odebrání zprávy z fronty při jejím čtení. Vzhledem k tomu Peek , že nemění obsah fronty, neexistují žádná přetížení pro podporu transakčního zpracování. PeekProtože ale , podobně jako Receive, čte zprávy synchronně z fronty, přetížení metody podporuje určení časového limitu, aby se zabránilo neomezenému čekání vlákna.

• Metody BeginPeek, EndPeek(IAsyncResult), BeginReceivea EndReceive(IAsyncResult) poskytují způsoby, jak asynchronně číst zprávy z fronty. Nepřeruší aktuální vlákno při čekání na doručení zprávy do fronty.

Následující metody MessageQueue třídy poskytují funkce pro načítání seznamů front podle zadaných kritérií a určení, zda existují konkrétní fronty:

• GetPrivateQueuesByMachine(String) umožňuje načtení soukromých front v počítači.

• GetPublicQueuesByCategory(Guid), GetPublicQueuesByLabel(String)a GetPublicQueuesByMachine(String) poskytují způsoby, jak načíst veřejné fronty podle běžných kritérií. Přetížení GetPublicQueues poskytuje ještě jemnější podrobnosti pro výběr front na základě řady kritérií hledání.

Jiné metody MessageQueue třídy poskytují následující funkce:

• Vytváření a odstraňování front message queueing

• Pomocí enumerátoru zpráv můžete procházet zprávy ve frontě.

• Použití enumerátoru front pro iteraci frontami v systému.

• Nastavení přístupových práv na základě seznamu ACL.

• Práce s mezipamětí připojení

Třída Message poskytuje podrobnou kontrolu nad informacemi, které odesíláte do fronty, a je objektem, který se používá při přijímání nebo náhledu zpráv z fronty. Kromě textu zprávy zahrnují vlastnosti Message třídy nastavení potvrzení, výběr formátovače, identifikaci, ověřování a informace o šifrování, časová razítka, indikace o použití trasování, deníkování serveru a fronty nedoručených zpráv a transakční data.

Komponenta MessageQueue je přidružena k následujícím třem formátovacím funkcím, které umožňují serializovat a deserializovat zprávy odeslané a přijaté z front:

• Poskytuje XmlMessageFormatter volně propojené zasílání zpráv, což umožňuje nezávislou správu verzí serializovaných typů na klientovi a serveru.

• Je ActiveXMessageFormatter kompatibilní s ovládacím prvku MSMQ COM. Umožňuje odesílat typy, které může ovládací prvek přijmout, a přijímat typy, které ovládací prvek odeslal.

• Poskytuje BinaryMessageFormatter rychlejší alternativu XmlMessageFormatterk , ale bez výhody volně propojeného zasílání zpráv.

Jiné třídy v Messaging oboru názvů podporují zabezpečení založené na přístupu kódu a seznamu ACL, filtrování Message vlastností při čtení zpráv z fronty a používání transakcí při odesílání a přijímání zpráv.