System.Messaging Przestrzeń nazw

Zawiera klasy, które umożliwiają łączenie z kolejkami komunikatów, monitorowanie ich i administrowanie nimi w sieci oraz wysyłanie, odbieranie lub wgląd w wiadomości.

Klasy

AccessControlEntry	Określa prawa dostępu dla powierni (użytkownika, grupy lub komputera) do wykonywania implementacji typowych zadań specyficznych dla aplikacji.
AccessControlList	Zawiera listę wpisów kontroli dostępu, określając prawa dostępu dla co najmniej jednego trustees.
ActiveXMessageFormatter	Serializować lub deserializacji pierwotnych typów danych i innych obiektów do lub z treści wiadomości usługi kolejkowania komunikatów przy użyciu formatu zgodnego ze składnikiem ActiveX usługi 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	CursorJest używany do obsługi określonej lokalizacji w MessageQueue trakcie odczytywania komunikatów w kolejce.
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	Steruje i wybiera właściwości, które są pobierane podczas wglą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 powiernika (użytkownika, grupy lub komputera) do wykonywania zadań usługi 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 potrzebnej do uruchomienia aplikacji. Ta klasa jest wywoływana przez narzędzie instalacyjne, na przykład InstallUtil.exe podczas instalowania klasy 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 na potrzeby obsługi komunikatów.
MessageQueuePermissionEntryCollection	Zawiera silnie typizowana kolekcja MessageQueuePermissionEntry obiektów.
MessageQueueTransaction	Dostarcza wewnętrznej transakcji usługi kolejkowania komunikatów.
MessagingDescriptionAttribute	Określa opis właściwości lub zdarzenia.
PeekCompletedEventArgs	Udostępnia dane dla zdarzenia PeekCompleted. Gdy asynchroniczna operacja wglądu wywołuje procedurę obsługi zdarzeń, wystąpienie tej klasy jest przekazywane do programu 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 programu obsługi.
SecurityContext	Reprezentuje kontekst zabezpieczeń wiadomości 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

Serializować lub deserializacji obiektów z treści wiadomości usługi kolejkowania komunikatów.

Wyliczenia

AccessControlEntryType	Określa, czy zezwalać, odmówić, czy odwołać prawa dostępu dla osoby zaufanej.
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 sprawdzania poprawności podpisów cyfrowych.
EncryptionAlgorithm	Określa algorytm szyfrowania używany do szyfrowania treści wiadomości prywatnej.
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 typowych praw dostępu, które usługa kolejkowania komunikatów mapuje zarówno na prawa dostępu standardowe, jak i specyficzne dla obiektu do odczytu, zapisu i wykonywania.
HashAlgorithm	Określa algorytm wyznaczania wartości skrótu używany przez usługę kolejkowania komunikatów podczas uwierzytelniania komunikatów.
MessageLookupAction	Określa komunikat służący do wglądu lub odbierania 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 obiektów dla operacji związanych z kolejką 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 usługi kolejkowania komunikatów.
MessageQueueTransactionType	Określa typ transakcji kolejkowania komunikatów.
MessageType	Identyfikuje typ komunikatu. Komunikatem może być typowy komunikat usługi kolejkowania komunikatów: komunikat z potwierdzeniem pozytywnym (przybycie i odczyt) lub ujemny (przybycie i odczytanie) lub komunikat raportu.
PeekAction	Wskazuje, czy ma być wyświetlany bieżący komunikat w kolejce, czy następny komunikat.
QueueAccessMode	Określa tryb dostępu podczas MessageQueue tworzenia.
StandardAccessRights	Określa zestaw standardowych praw dostępu, które odpowiadają operacji wspólnych dla większości typów zabezpieczanych obiektów.
TrusteeType	Określa typ powierni.

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

Elementy członkowskie MessageQueue klasy obejmują następujące metody odczytu i zapisu komunikatów w kolejce:

• SendMetoda umożliwia aplikacji Zapisywanie komunikatów w kolejce. Przeciążenia metody umożliwiają określenie, czy wysyłać wiadomość przy użyciu Message (która zapewnia szczegółową kontrolę nad wysyłanymi informacjami) czy dowolnego innego zarządzanego obiektu, w tym klas specyficznych dla aplikacji. Metoda obsługuje również wysyłanie komunikatów w ramach transakcji.

• ReceiveMetody, ReceiveById i ReceiveByCorrelationId zapewniają funkcje do odczytywania wiadomości z kolejki. Podobnie jak Send Metoda, te metody zapewniają przeciążenia obsługujące przetwarzanie kolejki transakcyjnej. Te metody zapewniają również przeciążenia z limitem czasu.

  Parametry out, które umożliwiają przetwarzanie do kontynuowania, jeśli kolejka jest pusta. Ponieważ te metody są przykładami przetwarzania synchronicznego, przerywają bieżący wątek do momentu, gdy nie zostanie określony limit czasu.

• PeekMetoda jest podobna do Receive , ale nie powoduje usunięcia komunikatu z kolejki podczas odczytywania. Ponieważ nie Peek zmienia zawartości kolejki, nie ma żadnych przeciążeń do obsługi przetwarzania transakcyjnego. Jednak ponieważ, Peek podobnie jak Receive , odczytuje komunikaty synchronicznie z kolejki, przeciążenia metody obsługują Określanie limitu czasu, aby zapobiec oczekiwaniu wątku przez wątek.

• BeginPeekMetody, EndPeek(IAsyncResult) , BeginReceive i EndReceive(IAsyncResult) zapewniają metody asynchroniczne odczytywanie wiadomości z kolejki. Nie przerywają bieżącego wątku podczas oczekiwania na dostarczenie komunikatu w kolejce.

Następujące metody MessageQueue klasy zapewniają funkcje pobierania list kolejek według określonych kryteriów i określania, czy istnieją określone kolejki:

• GetPrivateQueuesByMachine(String) włącza pobieranie kolejek prywatnych na komputerze.

• GetPublicQueuesByCategory(Guid), GetPublicQueuesByLabel(String) i GetPublicQueuesByMachine(String) zapewniają sposoby pobierania kolejek publicznych według wspólnych kryteriów. Przeciążenie GetPublicQueues zapewnia jeszcze dokładniejsze szczegóły dotyczące wybierania kolejek na podstawie różnych 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 komunikaty do przechodzenia między komunikatami w kolejce.

• Używanie modułu wyliczającego kolejki do iteracji w kolejkach w systemie.

• Ustawianie praw dostępu na podstawie listy ACL.

• Praca z pamięcią podręczną połączeń.

MessageKlasa zapewnia szczegółową kontrolę nad informacjami wysyłanymi do kolejki i jest obiektem używanym podczas otrzymywania lub wglądu w wiadomości z kolejki. Poza treścią wiadomości właściwości Message klasy obejmują ustawienia potwierdzania, wybór programu formatującego, identyfikację, informacje o uwierzytelnianiu i szyfrowaniu, sygnatury czasowe, wskazania dotyczące korzystania z śledzenia, rejestrowania serwera i kolejki utraconych wiadomości oraz dane transakcji.

MessageQueueSkładnik jest skojarzony z następującymi trzema programem formatującego, który umożliwia Serializowanie i deserializacja komunikatów wysyłanych i odbieranych z kolejek:

• XmlMessageFormatterZapewnia swobodną obsługę komunikatów, umożliwiając niezależnej wersji serializowanych typów na kliencie i serwerze.

• ActiveXMessageFormatterJest zgodny z kontrolką com usługi MSMQ. Umożliwia wysyłanie typów, które mogą być odbierane przez formant i odbierające typy, które zostały wysłane przez formant.

• BinaryMessageFormatterZapewnia szybszą alternatywę dla XmlMessageFormatter , ale bez korzyści płynących z swobodnie sprzężonych komunikatów.

Inne klasy w Messaging przestrzeni nazw obsługują zabezpieczenia dostępu do kodu i listy ACL, filtrowanie Message właściwości podczas odczytywania wiadomości z kolejki i używanie transakcji podczas wysyłania i otrzymywania wiadomości.