Sdílet prostřednictvím


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:

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.