System.Messaging Przestrzeń nazw
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Udostępnia klasy, które umożliwiają łączenie się, monitorowanie i administrowanie kolejkami komunikatów w sieci oraz wysyłanie, odbieranie lub wyświetlanie komunikatów.
Klasy
| Nazwa | Opis |
|---|---|
| AccessControlEntry |
Określa prawa dostępu dla zaufania (użytkownika, grupy lub komputera) do wykonywania implementacji specyficznych dla aplikacji typowych zadań. |
| AccessControlList |
Zawiera listę wpisów kontroli dostępu, określając prawa dostępu dla co najmniej jednego zaufania. |
| ActiveXMessageFormatter |
Serializuje lub deserializuje pierwotne typy danych i inne obiekty do lub z treści komunikatu kolejkowania komunikatów przy użyciu formatu zgodnego ze składnikiem ActiveX MSMQ. |
| BinaryMessageFormatter |
Serializuje lub deserializuje obiekt lub cały graf połączonych obiektów do lub z treści komunikatu kolejkowania komunikatów przy użyciu formatu binarnego. |
| Cursor |
Element A Cursor służy do obsługi określonej lokalizacji w MessageQueue obiekcie podczas odczytywania komunikatów kolejki. |
| DefaultPropertiesToSend |
Określa domyślne wartości właściwości, które będą używane podczas wysyłania obiektów innych niż Message wystąpienia do kolejki komunikatów. |
| Message |
Zapewnia dostęp do właściwości wymaganych do zdefiniowania komunikatu kolejkowania komunikatów. |
| MessageEnumerator |
Udostępnia kursor tylko do przekazywania w celu wyliczenia komunikatów w kolejce komunikatów. |
| MessagePropertyFilter |
Steruje i wybiera właściwości, które są pobierane podczas podglądu lub odbierania komunikatów z kolejki komunikatów. |
| MessageQueue |
Zapewnia dostęp do kolejki na serwerze kolejkowania komunikatów. |
| MessageQueueAccessControlEntry |
Określa prawa dostępu dla zaufania (użytkownika, grupy lub komputera) do wykonywania zadań kolejkowania komunikatów. |
| MessageQueueCriteria |
Filtruje kolejki komunikatów podczas wykonywania zapytania przy użyciu MessageQueue metody klasy GetPublicQueues() . |
| MessageQueueEnumerator |
Udostępnia kursor tylko do przekazywania w celu wyliczenia komunikatów w kolejce komunikatów. |
| MessageQueueException |
Wyjątek zgłaszany, jeśli wystąpi błąd wewnętrzny kolejkowania komunikatów firmy Microsoft. |
| MessageQueueInstaller |
Umożliwia zainstalowanie i skonfigurowanie kolejki wymaganej przez aplikację do uruchomienia. Ta klasa jest wywoływana przez narzędzie instalacyjne, na przykład InstallUtil.exe, podczas instalowania MessageQueueprogramu . |
| MessageQueuePermission |
Umożliwia kontrolę nad uprawnieniami dostępu do kodu na potrzeby obsługi komunikatów. |
| MessageQueuePermissionAttribute |
Umożliwia sprawdzanie uprawnień deklaratywnych MessageQueue . |
| MessageQueuePermissionEntry |
Definiuje najmniejszą jednostkę zestawu uprawnień zabezpieczeń dostępu do kodu na potrzeby obsługi komunikatów. |
| MessageQueuePermissionEntryCollection |
Zawiera silnie typizowana kolekcja MessageQueuePermissionEntry obiektów. |
| MessageQueueTransaction |
Udostępnia transakcję wewnętrzną kolejkowania komunikatów. |
| MessagingDescriptionAttribute |
Określa opis właściwości lub zdarzenia. |
| PeekCompletedEventArgs |
Dostarcza dane dla PeekCompleted zdarzenia. Gdy asynchroniczna operacja podglądu wywołuje procedurę obsługi zdarzeń, wystąpienie tej klasy jest przekazywane do programu obsługi. |
| ReceiveCompletedEventArgs |
Dostarcza dane dla ReceiveCompleted zdarzenia. Gdy asynchroniczna operacja odbierania wywołuje program obsługi zdarzeń, wystąpienie tej klasy jest przekazywane do programu obsługi. |
| SecurityContext |
Reprezentuje kontekst zabezpieczeń komunikatu w kolejce. |
| Trustee |
Określa konto użytkownika, konto grupy lub sesję logowania, do której ma zastosowanie wpis kontroli dostępu. |
| XmlMessageFormatter |
Serializuje i deserializuje obiekty do lub z treści komunikatu przy użyciu formatu XML opartego na definicji schematu XSD. |
Interfejsy
| Nazwa | Opis |
|---|---|
| IMessageFormatter |
Serializuje lub deserializuje obiekty z treści komunikatu kolejkowania komunikatów. |
Wyliczenia
| Nazwa | Opis |
|---|---|
| AccessControlEntryType |
Określa, czy zezwalać, odmawiać lub odwoływać prawa dostępu dla zaufania. |
| AcknowledgeTypes |
Określa typy komunikatów potwierdzenia, które usługa kolejkowania komunikatów powraca do aplikacji wysyłającej. |
| Acknowledgment |
Określa wynik próby dostarczenia komunikatu. |
| CryptographicProviderType |
Określa dostawców usług kryptograficznych dostępnych do weryfikowania podpisów cyfrowych. |
| EncryptionAlgorithm |
Określa algorytm szyfrowania używany do szyfrowania treści komunikatu prywatnego. |
| EncryptionRequired |
Określa poziom prywatności komunikatów odbieranych przez kolejkę. |
| GenericAccessRights |
Używa formatu dostępu Windows 2000 i Windows NT, aby określić zestaw wspólnych praw dostępu, które kolejkowanie komunikatów mapuje zarówno na standardowe, jak i specyficzne dla obiektu prawa dostępu do odczytu, zapisu i wykonywania. |
| HashAlgorithm |
Określa algorytm wyznaczania skrótu używany przez kolejkowanie komunikatów podczas uwierzytelniania komunikatów. |
| MessageLookupAction |
Określa komunikat, aby zajrzeć do kolejki komunikatów lub odebrać z kolejki komunikatów. |
| MessagePriority |
Określa priorytet kolejkowania komunikatów ma zastosowanie do komunikatu, gdy jest on kierowany do kolejki, a podczas wstawiania komunikatu do kolejki docelowej. |
| MessageQueueAccessRights |
Określa zestaw praw dostępu specyficznych dla obiektu dla operacji specyficznych dla kolejkowania komunikatów. |
| MessageQueueErrorCode |
Identyfikuje źródło błędu, który wystąpił w aplikacji kolejkowania komunikatów i wygenerował wyjątek MessageQueueException. |
| MessageQueuePermissionAccess |
Definiuje poziomy dostępu używane przez klasy uprawnień System.Messaging. |
| MessageQueueTransactionStatus |
Określa stan wewnętrznej transakcji kolejkowania komunikatów. |
| MessageQueueTransactionType |
Określa typ transakcji kolejkowania komunikatów. |
| MessageType |
Określa typ komunikatu. Komunikat może być typowym komunikatem kolejkowania komunikatów, pozytywnym (przybyciem i odczytem) lub negatywnym (przybycie i odczytanie) komunikatem potwierdzenia lub komunikatem raportu. |
| PeekAction |
Wskazuje, czy zajrzeć do bieżącego komunikatu w kolejce, czy następnego komunikatu. |
| QueueAccessMode |
Określa tryb dostępu dla MessageQueue w czasie tworzenia. |
| StandardAccessRights |
Określa zestaw standardowych praw dostępu, które odpowiadają operacjom typowym dla większości typów zabezpieczanych obiektów. |
| TrusteeType |
Określa typ zaufania. |
Delegaci
| Nazwa | Opis |
|---|---|
| PeekCompletedEventHandler |
Reprezentuje metodę, która będzie obsługiwać PeekCompleted zdarzenie klasy MessageQueue. |
| ReceiveCompletedEventHandler |
Reprezentuje metodę, która będzie obsługiwać ReceiveCompleted zdarzenie klasy MessageQueue. |
Uwagi
MessageQueue Elementy członkowskie klasy obejmują następujące metody odczytywania i zapisywania komunikatów w kolejce:
Metoda Send umożliwia aplikacji zapisywanie komunikatów w kolejce. Przeciążenia metody umożliwiają określenie, czy wysyłać komunikat przy użyciu elementu Message (który zapewnia szczegółową kontrolę nad wysyłanymi informacjami) lub dowolnego innego obiektu zarządzanego, w tym klas specyficznych dla aplikacji. Metoda obsługuje również wysyłanie komunikatów w ramach transakcji.
Metody Receive, ReceiveByIdi ReceiveByCorrelationId zapewniają funkcjonalność odczytywania komunikatów z kolejki. Podobnie jak metoda Send , te metody zapewniają przeciążenia, które obsługują transakcyjne przetwarzanie kolejek. Te metody zapewniają również przeciążenia z przekroczeniem limitu czasu.
Parametry wychodzące, które umożliwiają kontynuowanie przetwarzania, jeśli kolejka jest pusta. Ponieważ te metody są przykładami synchronicznego przetwarzania, przerywają bieżący wątek do momentu udostępnienia komunikatu, chyba że określono limit czasu.
Metoda jest podobna Peek do Receivemetody , ale nie powoduje usunięcia komunikatu z kolejki podczas jego odczytywania. Ponieważ Peek nie zmienia zawartości kolejki, nie ma przeciążeń do obsługi przetwarzania transakcyjnego. Jednak ponieważ Peek, na Receiveprzykład , odczytuje komunikaty synchronicznie z kolejki, przeciążenia metody obsługują określenie limitu czasu, aby zapobiec oczekiwaniu wątku na czas nieokreślony.
Metody BeginPeek, EndPeek(IAsyncResult), BeginReceivei EndReceive(IAsyncResult) zapewniają sposoby asynchronicznego odczytywania komunikatów z kolejki. Nie przerywają bieżącego wątku podczas oczekiwania na nadejście komunikatu do kolejki.
Następujące metody MessageQueue klasy zapewniają funkcjonalność pobierania list kolejek według określonych kryteriów i określania, czy istnieją określone kolejki:
GetPrivateQueuesByMachine(String) umożliwia pobieranie kolejek prywatnych na komputerze.
GetPublicQueuesByCategory(Guid), GetPublicQueuesByLabel(String)i GetPublicQueuesByMachine(String) zapewniają sposoby pobierania kolejek publicznych według typowych kryteriów. Przeciążenie GetPublicQueues zapewnia jeszcze bardziej szczegółowe informacje dotyczące wybierania kolejek na podstawie wielu kryteriów wyszukiwania.
Inne metody MessageQueue klasy zapewniają następujące funkcje:
Tworzenie i usuwanie kolejek kolejkowania komunikatów.
Używanie modułu wyliczającego komunikatów do przechodzenia przez komunikaty w kolejce.
Używanie modułu wyliczającego kolejki do iterowania za pośrednictwem kolejek w systemie.
Ustawianie praw dostępu na podstawie listy ACL.
Praca z pamięcią podręczną połączeń.
Klasa Message zapewnia szczegółową kontrolę nad informacjami wysyłanymi do kolejki i jest obiektem używanym podczas odbierania lub przeglądania komunikatów z kolejki. Oprócz treści komunikatu Message właściwości klasy obejmują ustawienia potwierdzenia, wybór formatatora, identyfikację, uwierzytelnianie i szyfrowanie informacji, sygnatury czasowe, wskazówki dotyczące korzystania z śledzenia, dzienniki serwera i kolejki utraconych komunikatów oraz dane transakcji.
Składnik jest skojarzony z następującymi trzema MessageQueue formaterami, co umożliwia serializowanie i deserializacji komunikatów wysyłanych i odbieranych z kolejek:
Zapewnia XmlMessageFormatter luźno powiązane komunikaty, umożliwiając niezależne przechowywanie wersji serializowanych typów na kliencie i serwerze.
Element ActiveXMessageFormatter jest zgodny z kontrolką COM MSMQ. Umożliwia wysyłanie typów, które mogą być odbierane przez kontrolkę i odbieranie typów, które zostały wysłane przez kontrolkę.
Zapewnia BinaryMessageFormatter szybszą alternatywę dla XmlMessageFormatterelementu , ale bez korzyści luźno sprzężonych komunikatów.
Inne klasy w Messaging przestrzeni nazw obsługują zabezpieczenia oparte na kodzie i listy ACL, filtrowanie właściwości podczas odczytywania Message komunikatów z kolejki oraz używanie transakcji podczas wysyłania i odbierania komunikatów.
