Udostępnij za pośrednictwem


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:

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.