System.Messaging Obor názvů
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje třídy, které umožňují připojit se, monitorovat a spravovat fronty zpráv v síti a odesílat, přijímat nebo zobrazit zprávy.
Třídy
| Name | Description |
|---|---|
| AccessControlEntry |
Určuje přístupová práva pro správce (uživatele, skupinu nebo počítač) k provádění implementací běžných úloh specifických pro aplikaci. |
| AccessControlList |
Obsahuje seznampoložekch |
| ActiveXMessageFormatter |
Serializuje nebo deserializuje primitivní datové typy a další objekty do nebo z těla zprávy služby Řízení front zpráv pomocí formátu, který je kompatibilní s komponentou ACTIVEX MSMQ. |
| BinaryMessageFormatter |
Serializuje nebo deserializuje objekt nebo celý graf propojených objektů do textu zprávy služby Řízení front zpráv nebo z textu zprávy služby Řízení front zpráv pomocí binárního formátu. |
| Cursor |
Používá Cursor se k udržování konkrétního umístění v MessageQueue určitém umístění při čtení zpráv fronty. |
| DefaultPropertiesToSend |
Určuje výchozí hodnoty vlastností, které se použijí 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řeposílání výčtu zpráv ve frontě zpráv. |
| MessagePropertyFilter |
Řídí a vybere vlastnosti, které se načtou při zobrazení 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řeposílání výčtu 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 společnosti Microsoft. |
| 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í 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 se předá 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, účet skupiny nebo přihlašovací relaci, na kterou se vztahuje položka řízení přístupu. |
| XmlMessageFormatter |
Serializuje a deserializuje objekty do textu zprávy nebo z textu zprávy pomocí formátu XML na základě definice schématu XSD. |
Rozhraní
| Name | Description |
|---|---|
| IMessageFormatter |
Serializuje nebo deserializuje objekty z textu zprávy služby Řízení front zpráv. |
Výčty
| Name | Description |
|---|---|
| AccessControlEntryType |
Určuje, jestli se mají povolit, odepřít nebo odvolat přístupová práva pro správce. |
| AcknowledgeTypes |
Určuje typy potvrzovací zprávy, kterou služba Řízení front zpráv vrátí do odesílající aplikace. |
| Acknowledgment |
Určuje výsledek pokusu o doručení zprávy. |
| CryptographicProviderType |
Určuje poskytovatele 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 Windows 2000 a Windows NT k určení sady běž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 provádě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řijímat z fronty zpráv. |
| MessagePriority |
Určuje prioritu služby Řízení front zpráv, která se vztahuje na zprávu v době, kdy je směrována do fronty, a při vkládání zprávy do cílové fronty. |
| MessageQueueAccessRights |
Určuje sadu přístupovýchprávch |
| MessageQueueErrorCode |
Identifikuje zdroj chyby, ke které došlo v aplikaci Řízení front zpráv, a vygeneruje MessageQueueException výjimku. |
| MessageQueuePermissionAccess |
Definuje úrovně přístupu používané System.Messaging třídami 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 |
Identifikuje typ zprávy. Zpráva může být typická zpráva o frontě zpráv, pozitivní (doručení a čtení) nebo záporná (příchozí a přečtená) zpráva o potvrzení nebo zpráva sestavy. |
| PeekAction |
Určuje, jestli se má zobrazit aktuální zpráva ve frontě, nebo jestli se má zobrazit další zpráva. |
| QueueAccessMode |
Určuje režim přístupu pro MessageQueue při 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
| Name | Description |
|---|---|
| PeekCompletedEventHandler |
Představuje metodu, která bude zpracovávat PeekCompleted událost .MessageQueue |
| ReceiveCompletedEventHandler |
Představuje metodu, která bude zpracovávat ReceiveCompleted událost .MessageQueue |
Poznámky
MessageQueue Členové třídy zahrnují následující metody pro čtení a zápis zpráv do fronty:
Tato Send metoda umožňuje vaší aplikaci psát zprávy do fronty. Přetížení metody umožňují určit, zda se má zpráva odeslat pomocí Message (která poskytuje podrobnou kontrolu nad informacemi, které odesíláte) nebo jakýkoli jiný spravovaný objekt, včetně tříd specifických pro aplikaci. Metoda také podporuje odesílání zpráv jako součást transakce.
Funkce Receive, ReceiveByIda ReceiveByCorrelationId metody pro čtení zpráv z fronty. Send Podobně jako metoda tyto metody poskytují přetížení, které podporují zpracování transakční fronty. Tyto metody také poskytují přetížení s časovým limitem.
Parametry, které umožňují zpracování pokračovat, 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 nezadáte časový limit.
Metoda Peek je podobná Receive, ale nezpůsobí odebrání zprávy z fronty při čtení. Vzhledem k tomu Peek , že nemění obsah fronty, neexistují žádné přetížení pro podporu transakčního zpracování. Vzhledem k tomu, že Peeknapříklad Receive, čte zprávy synchronně z fronty, přetížení metody podporují určení časového limitu, aby se zabránilo čekání vlákna na neomezenou dobu.
Metody BeginPeek, EndPeek(IAsyncResult), BeginReceivea EndReceive(IAsyncResult) metody poskytují způsoby, jak asynchronně číst zprávy z fronty. Při čekání na doručení zprávy do fronty nepřeruší aktuální vlákno.
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í privátních front v počítači.
GetPublicQueuesByCategory(Guid), GetPublicQueuesByLabel(String)a GetPublicQueuesByMachine(String) poskytnout způsoby, jak načíst veřejné fronty běžnými kritérii. Přetížení GetPublicQueues poskytuje ještě podrobnější podrobnosti pro výběr front na základě řady kritérií hledání.
Další metody MessageQueue třídy poskytují následující funkce:
Vytváření a odstraňování front zpráv
Pomocí enumerátoru zpráv můžete procházet zprávy ve frontě.
Použití enumerátoru fronty pro iteraci prostřednictvím front v systému.
Nastavení přístupových práv založených na 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 objekt použitý při přijímání nebo náhledu zpráv z fronty. Kromě textu zprávy zahrnují vlastnosti Message třídy nastavení potvrzení, formátovací výběr, identifikaci, ověřování a šifrování informací, časová razítka, označení použití trasování, deníkování serveru a fronty nedoručených zpráv a transakční data.
Komponenta MessageQueue je přidružená k následujícím třem formátovacím rutinám, které umožňují serializovat a deserializovat zprávy odeslané a přijaté z front:
Poskytuje XmlMessageFormatter volně svázané zasílání zpráv, což umožňuje nezávislé správy 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 odeslané ovládacím prvku.
Poskytuje BinaryMessageFormatter rychlejší alternativu XmlMessageFormatterk , ale bez výhody volně propojených zpráv.
Jiné třídy v Messaging oboru názvů podporují zabezpečení založené na kódu a seznamu ACL, filtrování Message vlastností při čtení zpráv z fronty a použití transakcí při odesílání a přijímání zpráv.
