System.Messaging Przestrzeń nazw

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

AccessControlEntry	Określa prawa dostępu dla trustee (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 służy Cursor do obsługi określonej lokalizacji w obiekcie MessageQueue 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 przodu, który ma być wyliczany za pośrednictwem komunikatów w kolejce komunikatów.
MessagePropertyFilter	Kontroluje i wybiera właściwości pobierane podczas przeglądania 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 trustee (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 przodu, który ma być wyliczany za pośrednictwem 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 elementu MessageQueue.
MessageQueuePermission	Umożliwia kontrolę nad uprawnieniami dostępu do kodu na potrzeby obsługi komunikatów.
MessageQueuePermissionAttribute	Zezwala na kontrole uprawnień deklaratywnych MessageQueue .
MessageQueuePermissionEntry	Definiuje najmniejszą jednostkę zestawu uprawnień zabezpieczeń dostępu do kodu dla komunikatów.
MessageQueuePermissionEntryCollection	Zawiera silnie typizowane kolekcje MessageQueuePermissionEntry obiektów.
MessageQueueTransaction	Udostępnia transakcję wewnętrzną kolejkowania komunikatów.
MessagingDescriptionAttribute	Określa opis właściwości lub zdarzenia.
PeekCompletedEventArgs	Udostępnia dane dla zdarzenia PeekCompleted. Gdy asynchroniczna operacja podglądu wywołuje procedurę obsługi zdarzeń, wystąpienie tej klasy jest przekazywane do procedury obsługi.
ReceiveCompletedEventArgs	Udostępnia dane dla zdarzenia ReceiveCompleted. Gdy asynchroniczna operacja odbierania wywołuje procedurę obsługi zdarzeń, wystąpienie tej klasy jest przekazywane do procedury 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

IMessageFormatter

Serializuje lub deserializuje obiekty z treści komunikatu kolejkowania komunikatów.

Wyliczenia

AccessControlEntryType	Określa, czy zezwolić, odmówić lub odwołać prawa dostępu dla zaufania.
AcknowledgeTypes	Określa typy komunikatów potwierdzenia, które kolejkowanie 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, który ma zostać wyświetlony lub odebrany 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ł MessageQueueException wyjątek.
MessageQueuePermissionAccess	Definiuje poziomy dostępu używane przez System.Messaging klasy uprawnień.
MessageQueueTransactionStatus	Określa stan wewnętrznej transakcji kolejkowania komunikatów.
MessageQueueTransactionType	Określa typ transakcji kolejkowania komunikatów.
MessageType	Identyfikuje typ komunikatu. Komunikat może być typowym komunikatem kolejkowania komunikatów, pozytywną (przybyciem i odczytem) lub negatywną (przybyciem i odczytem) lub komunikatem o potwierdzeniu raportu.
PeekAction	Wskazuje, czy należy zajrzeć do bieżącego komunikatu w kolejce, czy też następnego komunikatu.
QueueAccessMode	Określa tryb dostępu dla MessageQueue elementu 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

PeekCompletedEventHandler	Reprezentuje metodę, która obsłuży PeekCompleted zdarzenie klasy MessageQueue.
ReceiveCompletedEventHandler	Reprezentuje metodę, która obsłuży 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ć wiadomość przy użyciu elementu Message (który zapewnia szczegółową kontrolę nad wysyłanymi informacjami) lub innych zarządzanych obiektów, 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ą przetwarzanie kolejek transakcyjnych. Te metody zapewniają również przeciążenia z przekroczeniem limitu czasu.

  Parametry, 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ż , na przykład PeekReceive, 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 przybycie 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 kolejek 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 podglądu 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 używania śledzenia, dzienniki serwera i kolejki utraconych wiadomości oraz dane transakcji.

Składnik MessageQueue jest skojarzony z następującymi trzema formaterami, które umożliwiają serializowanie i deserializacji komunikatów wysyłanych i odbieranych z kolejek:

• Usługa XmlMessageFormatter zapewnia luźno powiązane komunikaty, umożliwiając niezależne wersje typów serializowanych 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 połączonych komunikatów.

Inne klasy w Messaging przestrzeni nazw obsługują zabezpieczenia oparte na kodzie i listy ACL, filtrowanie Message właściwości podczas odczytywania komunikatów z kolejki oraz używanie transakcji podczas wysyłania i odbierania komunikatów.