System.Messaging

Constructs a new sys description.

description text.

Retrieves the description text.

description

Specifies access rights for a trustee (user, group, or computer) to perform application-specific implementations of common tasks.

Initializes a new instance of the class that specifies neither a trustee nor set of rights to apply.

Initializes a new instance of the class that specifies a trustee to grant or deny rights to.

A that specifies a user, group, computer, domain, or alias.

Initializes a new instance of the class that specifies a trustee, rights to assign, and whether to grant or deny these rights.

A that specifies a user, group, computer, domain, or alias. A bitwise combination of the values. A bitwise combination of the values. One of the values, which specifies whether to allow, deny, set, or revoke the specified rights.

Gets or sets a value that indicates how the access rights apply to the trustee.

Gets or sets custom access rights.

Gets or sets a set of common access rights that map to both standard and object-specific access rights for reading, writing, and executing.

Gets or sets a set of standard access rights that correspond to operations common to most types of securable objects.

Gets or sets the user, group, domain, or alias to which you are assigning access rights.

Specifies whether to allow, deny, or revoke access rights for a trustee.

An access-allowed entry that causes the new rights to be added to any existing rights the trustee has.

An access-allowed entry that is similar to , except that the new entry allows only the specified rights. Using it discards any existing rights, including all existing access-denied entries for the trustee.

An access-denied entry that denies the specified rights in addition to any currently denied rights of the trustee.

An entry that removes all existing allowed or denied rights for the specified trustee.

Contains a list of access control entries, specifying access rights for one or more trustees.

Initializes a new instance of the class.

Appends an access control entry to the access control list.

An to append to the end of the access control list. The position into which the new access control entry was inserted.

Inserts an access control entry into the access control list at the specified position.

The zero-based index at which the access control entry should be inserted. An to insert into the access control list.

Determines the specific index of an access control entry in the access control list.

The to locate in the access control list. The index of the entry if it was found in the list; otherwise, -1

Determines whether the access control list contains a specific access control entry.

The to locate in the access control list. if the access control entry is found in the access control list; otherwise, .

Removes the first occurrence of a specific access control entry from the access control list.

The to remove from the access control list.

Copies the entire access control list to a compatible one-dimensional array of access control entries, starting at the specified index of the target array.

An array of type to which the access control list entries will be copied. The array must have zero-based indexing. The index in the array at which to begin copying the access control list entries.

Specifies the result of an attempted message delivery.

The message is not an acknowledgment message.

A negative arrival acknowledgment indicating that the sending application does not have the necessary rights to send a message to the destination queue.

A negative arrival acknowledgment indicating that the destination queue is not available to the sending application.

A negative arrival acknowledgment indicating that the destination queue manager could not decrypt a private message.

A negative arrival acknowledgment indicating that the original message's digital signature is not valid and could not be authenticated by Message Queuing.

A negative arrival acknowledgment indicating that the source queue manager could not encrypt a private message.

A negative arrival acknowledgment indicating that the original message's hop count (which indicates the number of intermediate servers) was exceeded. The maximum hop count, 15, is set by Message Queuing and is immutable.

A negative arrival acknowledgment indicating that a transactional message was sent to a non-transactional queue.

A negative arrival acknowledgment indicating that a nontransactional message was sent to a transactional queue.

A negative arrival acknowledgment indicating that the message was purged before reaching its destination queue.

A negative read acknowledgment indicating that the queue was deleted before the message could be read.

A negative arrival acknowledgment indicating that the original message was not delivered because its destination queue is full.

A negative read acknowledgment indicating that the queue was purged before the message could be read.

A positive arrival acknowledgment indicating that the original message reached its destination queue.

A negative arrival acknowledgment indicating that the time-to-reach-queue or time-to-be-received timer expired before the original message could reach the destination queue.

A negative read acknowledgment indicating that the original message was not received from the queue before its time-to-be-received timer expired.

A positive read acknowledgment indicating that the original message was received by the receiving application.

Specifies the types of acknowledgment message Message Queuing returns to the sending application.

A mask used to request a positive acknowledgment when the original message reaches the queue.

A mask used to request a positive acknowledgment when the original message is successfully retrieved from the queue.

A mask used to request a negative acknowledgment when the original message fails to be received from the queue. Using the method does not remove a message from the queue, so this acknowledgment type could be returned even if you did peek the message. Only the method (or the related asynchronous method) removes a message from the queue.

A mask used to request that no acknowledgment messages (positive or negative) be posted.

A mask used to request a negative acknowledgment when the original message cannot reach the queue. This can happen when the time-to-reach-queue timer expires, or if a message cannot be authenticated.

A mask used to request a negative acknowledgment when an error occurs that prevents the original message from being received from the queue before its time-to-be-received timer expires.

A mask used to request positive acknowledgment if the original message reaches the queue, or negative acknowledgment if the time-to-reach-queue timer expires or if the original message cannot be authenticated.

A mask used to request positive acknowledgment if the original message is received from the queue before its time-to-be-received timer expires, or negative acknowledgment otherwise.

Serializes or deserializes primitive data types and other objects to or from the body of a Message Queuing message, using a format that is compatible with the MSMQ ActiveX Component.

Serializes or deserializes objects from the body of a Message Queuing message.

When implemented in a class, determines whether the formatter can deserialize the contents of the message.

The to inspect. if the formatter can deserialize the message; otherwise, .

When implemented in a class, reads the contents from the given message and creates an object containing data from the message.

The to deserialize. The deserialized message.

When implemented in a class, serializes an object into the body of the message.

The that will contain the serialized object. The object to be serialized into the message.

Determine whether the formatter can deserialize the contents of the message.

The to inspect. if the can deserialize the message; otherwise, .

Creates an instance of the class that is identical to the current .

An object whose properties are identical to those of this .

Provides a utility to help the serialize COM objects that implement IPersistStream and require IPersistStreamInit to be called.

An OLE object that implements IPersistStreamInit.

Reads the contents from the given message and creates an object containing the deserialized message.

The , in MSMQ ActiveX control format, to deserialize. The deserialized message.

Serializes an object into the body of the message.

The whose property will contain the serialized object. The object to be serialized into the message body.

Serializes or deserializes an object, or an entire graph of connected objects, to or from the body of a Message Queuing message, using a binary format.

Initializes a new instance of the class, without specifying a type style or top object assembly style.

Initializes a new instance of the class, specifying the formats of the root object and the type descriptions.

Determines how the top (root) object of a graph is laid out in the serialized stream. Determines how type descriptions are laid out in the serialized stream.

Determines whether the formatter can deserialize the contents of the message.

The to inspect. if the binary message formatter can deserialize the message; otherwise, .

Creates an instance of the class whose read/write properties (the root object and type description formats) are the same as the current .

An object whose properties are identical to those of this , but whose metadata does not specify it to be a formatter class instance.

Reads the contents from the given message and creates an object containing the deserialized message.

The , in binary format, to deserialize. The deserialized message.

Serializes an object into the body of the message.

The whose property will contain the serialized object. The object to be serialized into the message body.

Gets or sets a value that defines how the top (root) object of a graph is laid out in the serialized stream.

Gets or sets a value that defines how type descriptions are laid out in the serialized stream.

Specifies the cryptographic service providers available for validating digital signatures.

No cryptographic provider type specified.

The full RSA provider type, which supports both digital signatures and data encryption. Considered a general purpose cryptographic services provider. The RSA public-key algorithm is used for all public-key operations. RSA Data Security, Inc., is a major developer and publisher of public-key cryptography standards. The "RSA" in the name stands for the names of the company's three developers and the owners: Rivest, Shamir, and Adelman

A subset of the provider type, which supports only those functions and algorithms required for hashes and digital signatures.

A provider type that, like , only supports hashes and digital signatures. specifies the DSA (Digital Signature Algorithm) signature algorithm.

A provider type that contains a set of cryptographic protocols and algorithms owned by the National Institute of Standards and Technology.

A provider type designed for the cryptographic needs of the Microsoft Exchange mail application and other applications compatible with Microsoft Mail. This provider type is preliminary.

A provider type that supports the Secure Sockets Layer (SSL) protocol.

Secure Transaction Technology Provider.

Specifies the default property values that will be used when sending objects other than instances to a message queue.

Initializes a new instance of the class.

Gets or sets the type of acknowledgement message to be returned to the sending application.

Gets or sets the queue that receives acknowledgement messages generated by Message Queuing.

Gets or sets additional, application-specific information.

Gets or sets a value indicating whether the sender ID should be attached to the message.

Gets or sets the encryption algorithm used to encrypt the body of a private message.

Gets or sets additional information associated with the message.

Gets or sets the hashing algorithm used when authenticating messages or creating a digital signature for a message.

Gets or sets an application-defined string that describes the message.

Gets or sets the message priority, used to determine where the message is placed in the queue.

Gets or sets a value indicating whether the message is guaranteed to be delivered in the event of a computer failure or network problem.

Gets or sets the queue that receives application-generated response messages.

Gets or sets the time limit for the message to be retrieved from the destination queue.

Gets or sets the time limit for the message to reach the queue.

Gets the transaction status queue on the source computer.

Gets or sets a value indicating whether the message must be authenticated before being sent.

Gets or sets a value indicating whether a copy of the message that could not be delivered should be sent to a dead-letter queue.

Gets or sets a value indicating whether to make the message private.

Gets or sets a value indicating whether a copy of the message should be kept in a machine journal on the originating computer.

Gets or sets a value indicating whether to trace a message as it moves toward its destination queue.

Specifies the encryption algorithm used to encrypt the message body of a private message.

No encryption.

The value MQMSG_CALG_RC2. This is the default value for the encryption property of the Message Queuing application's message object.

The value MQMSG_CALG_RC4. This corresponds to the less secure option for the encryption property of the Message Queuing application's message object.

Specifies the privacy level of messages received by the queue.

Accepts only nonprivate (nonencrypted) messages.

Does not force privacy. Accepts private (encrypted) messages and nonprivate (nonencrypted) messages.

Accepts only private (encrypted) messages.

Uses the Windows 2000/Windows NT access format to specify a set of common access rights that Message Queuing maps to both standard and object-specific access rights for reading, writing, and executing.

Read, write, and execute access.

Execute access.

Write access.

Read access.

No access.

Specifies the hash algorithm used by Message Queuing when authenticating messages.

No hashing algorithm.

MD2 hashing algorithm.

MD4 hashing algorithm.

MD5 hashing algorithm.

SHA hashing algorithm.

MAC keyed hashing algorithm.

Provides access to the properties needed to define a Message Queuing message.

Specifies that no timeout exists.

Initializes a new instance of the class with an empty body.

Initializes a new instance of the class, using the to serialize the specified object into the body of the message.

The object to be serialized into the body of the message.

Initializes a new instance of the class, using the specified formatter to serialize the specified object into the body of the message.

The object to be serialized into the body of the message. An that specifies the formatter with which to serialize the message body.

Gets the classification of acknowledgment that this message represents.

Gets or sets the type of acknowledgment message to be returned to the sending application.

Gets or sets the queue that receives the acknowledgement messages that Message Queuing generates.

Gets or sets additional, application-specific information.

Gets the time that the message arrived in the destination queue.

Gets or sets a value indicating whether the sender identifier should be attached to the message.

Gets a value indicating whether the message was authenticated.

Gets or sets the name of the cryptographic provider used to generate the digital signature of the message.

Gets or sets the type of cryptographic provider used to generate the digital signature of the message.

Gets or sets the content of the message.

Gets or sets the information in the body of the message.

Gets or sets the type of data that the message body contains.

Gets or sets a value that indicates that some message properties typically set by Message Queuing were set by the sending application.

Gets or sets the message identifier used by acknowledgment, report, and response messages to reference the original message.

Gets the intended destination queue for a message.

Gets or sets the symmetric key used to encrypt application-encrypted messages or messages sent to foreign queues.

Gets or sets the digital signature that Message Queuing uses to authenticate the message.

Gets or sets the encryption algorithm used to encrypt the body of a private message.

Gets or sets additional, application-defined information associated with the message.

Gets or sets the formatter used to serialize an object into or deserialize an object from the message body.

Gets or sets the hashing algorithm that Message Queuing uses when authenticating a message or creating a digital signature for a message.

Gets the message's identifier.

Gets a value indicating whether the message was the first message sent in a transaction.

Gets a value indicating whether the message was the last message sent in a transaction.

Gets or sets an application-defined Unicode string that describes the message.

Gets the message type: normal, acknowledgment, or report.

Gets or sets the message priority, which determines where in the queue the message is placed.

Gets or sets a value indicating whether the message is guaranteed to be delivered in the event of a computer failure or network problem.

Gets or sets the queue that receives application-generated response messages.

Gets or sets the security certificate used to authenticate messages.

Gets the identifier of the sending user.

Gets the version of Message Queuing used to send the message.

Gets the date and time on the sending computer that the message was sent by the source queue manager.

Gets the computer from which the message originated.

Gets or sets the maximum amount of time for the message to be received from the destination queue.

Gets or sets the maximum amount of time for the message to reach the queue.

Gets the identifier for the transaction of which the message was a part.

Gets the transaction status queue on the source computer.

Gets or sets a value indicating whether the message was (or must be) authenticated before being sent.

Gets or sets a value indicating whether a copy of the message that could not be delivered should be sent to a dead-letter queue.

Gets or sets a value indicating whether to make the message private.

Gets or sets a value indicating whether a copy of the message should be kept in a machine journal on the originating computer.

Gets or sets a value indicating whether to trace a message as it moves toward its destination queue.

Provides a forward-only cursor to enumerate through messages in a message queue.

Frees the resources associated with the enumerator.

Releases all resources used by the .

Releases the unmanaged resources used by the and optionally releases the managed resources.

to release both managed and unmanaged resources; to release only unmanaged resources.

Advances the enumerator to the next message in the queue, if one is currently available.

if the enumerator was succesfully advanced to the next message; if the enumerator has reached the end of the queue.

Advances the enumerator to the next message in the queue. If the enumerator is positioned at the end of the queue, waits until a message is available or the given timeout expires.

The to wait for a message to be available if the enumerator is positioned at the end of the queue. if the enumerator successfully advanced to the next message; if the enumerator has reached the end of the queue and a message does not become available within the time specified by the parameter.

Removes the current message from a transactional or non-transactional queue and returns the message to the calling application. There is no timeout specified for a message to arrive in the queue.

A that references the first message available in the queue.

Removes the current message from a transactional queue and returns the message to the calling application. There is no timeout specified for a message to arrive in the queue.

The object that specifies the transaction in which the message will be removed. A that references the first message available in the queue.

Removes the current message from a queue and returns the message to the calling application. There is no timeout specified for a message to arrive in the queue.

One of the values, describing the type of transaction context to associate with the message. A that references the first message available in the queue.

Removes the current message from the queue and returns the message to the calling application. If there is a message to remove, the method returns it immediately. Otherwise, the method waits the specified timeout for a new message to arrive.

The interval of time to wait for a message to arrive in the queue. A that references the first message available in the queue.

Removes the current message from a transactional queue and returns the message to the calling application. If there is a message to remove, the method returns it immediately. Otherwise, the method waits the specified timeout for a new message to arrive.

The interval of time to wait for the message to be removed. The object that specifies the transaction context for the message. A that references the first message available in the queue.

Removes the current message from a queue and returns the message to the calling application. If there is a message to remove, the method returns it immediately. Otherwise, the method waits the specified timeout for a new message to arrive.

The interval of time to wait for the message to be removed. One of the values, describing the type of transaction context to associate with the message. A that references the first message available in the queue.

Resets the current enumerator so it points to the head of the queue.

Gets the current that this enumerator points to.

Gets the native Message Queuing cursor handle used to browse messages in the queue.

Specifies the priority Message Queuing applies to a message while it is en route to a queue, and when inserting the message into the destination queue.

Lowest message priority.

Between and message priority.

Low message priority.

Normal message priority.

Between and message priority.

High message priority.

Between and message priority.

Highest message priority.

Controls and selects the properties that are retrieved when peeking or receiving messages from a message queue.

Initializes a new instance of the class and sets default values for all properties.

Sets all Boolean filter values to , so that no message properties are retrieved when receiving a message.

Use to set all Boolean properties to . This causes no message properties to be retrieved when receiving messages. does not affect the values for , , or . After calling , it is necessary to set at least one filter property to in order to receive data related to a message. You can either set individual properties to , or you can call or .

Sets the filter values of common Message Queuing properties to and the integer-valued properties to their default values.

Specifies to retrieve all message properties when receiving a message.

Gets or sets a value indicating whether to retrieve property information when receiving or peeking a message.

Gets or sets the size, in bytes, of the default body buffer.

Gets or sets the size, in bytes, of the default extension buffer.

Gets or sets the size, in bytes, of the default label buffer.

Gets or sets a value indicating whether to retrieve property information when receiving or peeking a message.

Provides access to a queue on a Message Queuing server.

Specifies that no time-out exists for methods that peek or receive messages.

Specifies that no size restriction exists for a queue.

Initializes a new instance of the class. After the default constructor initializes the new instance, you must set the instance's property before you can use the instance.

Initializes a new instance of the class that references the Message Queuing queue at the specified path.

The location of the queue referenced by this . For information on the proper syntax for this parameter, see the Remarks section.

Initializes a new instance of the class that references the Message Queuing queue at the specified path and with the specified read-access restriction.

The location of the queue referenced by this , which can be "." for the local computer. For information on the proper syntax for this parameter, see the Remarks section. to grant exclusive read access to the first application that accesses the queue; otherwise, .

Initiates an asynchronous peek operation that has no time-out. The operation is not complete until a message becomes available in the queue.

The that identifies the posted asynchronous request.

Initiates an asynchronous peek operation that has a specified time-out. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

A that indicates the interval of time to wait for a message to become available. The that identifies the posted asynchronous request.

Initiates an asynchronous peek operation that has a specified time-out and a specified state object, which provides associated information throughout the operation's lifetime. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

A that indicates the interval of time to wait for a message to become available. A state object, specified by the application, that contains information associated with the asynchronous operation. The that identifies the posted asynchronous request.

Initiates an asynchronous peek operation that has a specified time-out and a specified state object, which provides associated information throughout the operation's lifetime. This overload receives notification, through a callback, of the identity of the event handler for the operation. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

Initiates an asynchronous receive operation that has no time-out. The operation is not complete until a message becomes available in the queue.

The that identifies the posted asynchronous request.

Initiates an asynchronous receive operation that has a specified time-out. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

A that indicates the interval of time to wait for a message to become available. The that identifies the posted asynchronous request.

Initiates an asynchronous receive operation that has a specified time-out and a specified state object, which provides associated information throughout the operation's lifetime. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

Initiates an asynchronous receive operation that has a specified time-out and a specified state object, which provides associated information throughout the operation's lifetime. This overload receives notification, through a callback, of the identity of the event handler for the operation. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

Clears the connection cache.

Frees all resources allocated by the .

Creates a nontransactional Message Queuing queue at the specified path.

The path of the queue to create. A that represents the new queue.

Creates a transactional or nontransactional Message Queuing queue at the specified path.

The path of the queue to create. to create a transactional queue; to create a nontransactional queue. A that represents the new queue.

Deletes a queue on a Message Queuing server.

The location of the queue to be deleted.

Completes the specified asynchronous peek operation.

The that identifies the asynchronous peek operation to finish, and from which to retrieve an end result. The associated with the completed asynchronous operation.

Completes the specified asynchronous receive operation.

The that identifies the asynchronous receive operation to finish, and from which to retrieve an end result. The associated with the completed asynchronous operation.

Determines whether a Message Queuing queue at the specified path exists.

The location of the queue to find. if a queue with the specified path exists; otherwise, .

Returns all the messages that are in the queue.

An array of type that represents all the messages in the queue, in the same order as they appear in the Message Queuing queue.

Enumerates the messages in a queue.

An that provides a dynamic connection to the messages in the queue.

Gets the identifier of the computer on which the queue referenced by this is located.

The name of the computer that contains the queue, without the two preceding backslashes (\\). A that represents a unique identifier for the computer on which the queue is located.

Provides forward-only cursor semantics to enumerate through all public queues on the network.

A that provides a dynamic listing of all the public message queues on the network.

Provides forward-only cursor semantics to enumerate through all public queues on the network that meet the specified criteria.

A that contains the criteria used to filter the available message queues. A that provides a dynamic listing of the public message queues on the network that satisfy the restrictions specified by the parameter.

Creates an enumerator object for all the messages in the queue.

The holding the messages that are contained in the queue.

Retrieves all the private queues on the specified computer.

The computer from which to retrieve the private queues. An array of objects that reference the retrieved private queues.

Retrieves all the public queues on the network.

An array of objects that reference the retrieved public queues.

Retrieves all the public queues on the network that meet the specified criteria.

A that contains the criteria used to filter the queues. An array of objects that reference the retrieved public queues.

Retrieves all the public queues on the network that belong to the specified category.

A that groups the set of queues to be retrieved. An array of objects that reference the retrieved public queues.

Retrieves all the public queues on the network that carry the specified label.

A label that groups the set of queues to be retrieved. An array of objects that reference the retrieved public queues.

Retrieves all the public queues that reside on the specified computer.

The name of the computer that contains the set of public queues to be retrieved. An array of objects that reference the public queues on the computer.

Returns without removing (peeks) the first message in the queue referenced by this . The method is synchronous, so it blocks the current thread until a message becomes available.

The that represents the first message in the queue.

Returns without removing (peeks) the first message in the queue referenced by this . The method is synchronous, so it blocks the current thread until a message becomes available or the specified time-out occurs.

A that indicates the maximum time to wait for the queue to contain a message. The that represents the first message in the queue.

Peeks the message whose message identifier matches the parameter.

The of the message to peek. The whose property matches the parameter.

Peeks the message whose message identifier matches the parameter. Waits until the message appears in the queue or a time-out occurs.

The of the message to peek. A that indicates the maximum amount of time to wait for the message to appear in the queue. The whose property matches the parameter.

Peeks the message that matches the given correlation identifier and immediately raises an exception if no message with the specified correlation identifier currently exists in the queue.

The of the message to peek. The whose matches the parameter passed in.

Peeks the message that matches the given correlation identifier and waits until either a message with the specified correlation identifier is available in the queue, or the time-out expires.

The of the message to peek. A that indicates the time to wait until a new message is available for inspection . The whose matches the parameter passed in.

Deletes all the messages contained in the queue.

Receives the first message available in the queue referenced by the . This call is synchronous, and blocks the current thread of execution until a message is available.

A that references the first message available in the queue.

Receives the first message available in the transactional queue referenced by the . This call is synchronous, and blocks the current thread of execution until a message is available.

The object. A that references the first message available in the queue.

Receives the first message available in the queue referenced by the . This call is synchronous, and blocks the current thread of execution until a message is available.

One of the values, describing the type of transaction context to associate with the message. A that references the first message available in the queue.

Receives the first message available in the queue referenced by the and waits until either a message is available in the queue, or the time-out expires.

A that indicates the time to wait until a new message is available for inspection. A that references the first message available in the queue.

Receives the first message available in the transactional queue referenced by the and waits until either a message is available in the queue, or the time-out expires.

A that indicates the time to wait until a new message is available for inspection. The object. A that references the first message available in the queue.

Receives the first message available in the queue referenced by the . This call is synchronous, and waits until either a message is available in the queue, or the time-out expires.

A that indicates the time to wait until a new message is available for inspection. One of the values, describing the type of transaction context to associate with the message. A that references the first message available in the queue.

Receives the message that matches the given identifier from a non-transactional queue, and immediately raises an exception if no message with the specified identifier currently exists in the queue.

The of the message to receive. The whose property matches the parameter passed in.

Receives the message that matches the given identifier, from a transactional queue, and immediately raises an exception if no message with the specified identifier currently exists in the queue.

The of the message to receive. The object . The whose property matches the parameter passed in.

Receives the message that matches the given identifier, and immediately raises an exception if no message with the specified identifier currently exists in the queue.

The of the message to receive. One of the values, describing the type of transaction context to associate with the message. The whose property matches the parameter passed in.

Receives the message that matches the given identifier, from a nontransactional queue, and waits until either a message with the specified identifier is available in the queue or the time-out expires.

The of the message to receive. A that indicates the time to wait until a new message is available for inspection. The whose property matches the parameter passed in.

Receives the message that matches the given identifier, from a transactional queue, and waits until either a message with the specified identifier is available in the queue or the time-out expires.

The of the message to receive. A that indicates the time to wait until a new message is available for inspection. The object . The whose property matches the parameter passed in.

Receives the message that matches the given identifier, and waits until either a message with the specified identifier is available in the queue or the time-out expires.

The of the message to receive. A that indicates the time to wait until a new message is available for inspection. One of the values, describing the type of transaction context to associate with the message. The whose property matches the parameter passed in.

Receives the message that matches the given correlation identifier, from a nontransactional queue, and immediately raises an exception if no message with the specified correlation identifier currently exists in the queue.

The of the message to receive. The whose matches the parameter passed in.

Receives the message that matches the given correlation identifier, from a transactional queue, and immediately raises an exception if no message with the specified correlation identifier currently exists in the queue.

The of the message to receive. The object. The whose matches the parameter passed in.

Receives the message that matches the given correlation identifier, and immediately raises an exception if no message with the specified correlation identifier currently exists in the queue.

The of the message to receive. One of the values, describing the type of transaction context to associate with the message. The whose matches the parameter passed in.

Receives the message that matches the given correlation identifier, from a nontransactional queue, and waits until either a message with the specified correlation identifier is available in the queue, or the time-out expires.

The of the message to receive. A that indicates the time to wait until a new message is available for inspection . The whose matches the parameter passed in.

Receives the message that matches the given correlation identifier, from a transactional queue, and waits until either a message with the specified correlation identifier is available in the queue, or the time-out expires.

The of the message to receive. A that indicates the time to wait until a new message is available for inspection . The object. The whose matches the parameter passed in.

Receives the message that matches the given correlation identifier, and waits until either a message with the specified correlation identifier is available in the queue, or the time-out expires.

The of the message to receive. A that indicates the time to wait until a new message is available for inspection . One of the values, describing the type of transaction context to associate with the message. The whose matches the parameter passed in.

Refreshes the properties presented by the to reflect the current state of the resource.

Sends an object to nontransactional queue referenced by this .

The object to send to the queue.

Sends an object to the transactional queue referenced by this .

The object to send to the queue. The object.

Sends an object to the queue referenced by this .

The object to send to the queue. One of the values, describing the type of transaction context to associate with the message.

Sends an object to the nontransactional queue referenced by this and specifies a label for the message.

The object to send to the queue. The label of the message.

Sends an object to the transactional queue referenced by this and specifies a label for the message.

The object to send to the queue. The label of the message. The object.

Sends an object to the queue referenced by this and specifies a label for the message.

The object to send to the queue. The label of the message. One of the values, describing the type of transaction context to associate with the message.

Resets the permission list to the operating system's default values. Removes any queue permissions you have appended to the default list.

Gives a computer, group, or user the specified access rights.

The individual, group, or computer that gets additional rights to the queue. A that indicates the set of rights to the queue that Message Queuing assigns to the passed in.

Gives a computer, group, or user the specified access rights, with the specified access control type (allow, deny, revoke, or set).

The individual, group, or computer that gets additional rights to the queue. A that indicates the set of rights to the queue that Message Queuing assigns to the passed in. An that specifies whether to grant, deny, or revoke the permissions specified by the parameter.

Assigns access rights to the queue based on the contents of an access control entry.

A that specifies a user, an access type, and a permission type.

Assigns access rights to the queue based on the contents of an access control list.

An that contains one or more access control entries that specify the trustees and the permissions to grant.

Gets or sets a value indicating whether the queue accepts only authenticated messages.

Gets or sets the base priority Message Queuing uses to route a public queue's messages over the network.

Gets a value indicating whether the can be read.

Gets a value indicating whether the can be written to.

Gets or sets the queue category.

Gets the time and date that the queue was created in Message Queuing.

Gets or sets the message property values to be used by default when the application sends messages to the queue.

Gets or sets a value indicating whether this has exclusive access to receive messages from the Message Queuing queue.

Gets or sets a value indicating whether a cache of connections will be maintained by the application.

Gets or sets a value indicating whether the queue accepts only nonprivate (nonencrypted) messages.

Gets the unique queue name that Message Queuing generated at the time of the queue's creation.

Gets or sets the formatter used to serialize an object into or deserialize an object from the body of a message read from or written to the queue.

Gets the unique Message Queuing identifier of the queue.

Gets or sets the queue description.

Gets the last time the properties of a queue were modified.

Gets or sets the name of the computer where the Message Queuing queue is located.

Gets or sets the maximum size of the journal queue.

Gets or sets the maximum size of the queue.

Gets or sets the property filter for receiving or peeking messages.

Gets or sets the queue's path. Setting the causes the to point to a new queue.

Gets or sets the friendly name that identifies the queue.

Gets the native handle used to read messages from the message queue.

Gets or sets the object that marshals the event-handler call resulting from a or event.

Gets a value indicating whether the queue accepts only transactions.

Gets or sets a value indicating whether received messages are copied to the journal queue.

Gets the native handle used to send messages to the message queue.

Occurs when a message is read without being removed from the queue. This is a result of the asynchronous operation, .

Occurs when a message has been removed from the queue. This event is raised by the asynchronous operation, .

IAsyncResult implementation

Specifies access rights for a trustee (user, group, or computer) to perform Message Queuing tasks.

Initializes a new instance of the class, granting the specified Message Queuing access rights to the specified trustee.

A that specifies a user, group, computer, domain, or alias. A bitwise combination of the values which defines the combination of rights to grant to the trustee.

Initializes a new instance of the class, with the specified trustee and Message Queuing access rights. The type of access (such as or ) is defined by the entry type you pass in.

A that specifies a user, group, computer, domain, or alias. A bitwise combination of the values which defines the combination of rights to grant to the trustee. One of the values, which specifies whether to allow, deny, set or revoke the specified rights.

Gets or sets the set of Message Queuing-specific rights to apply to the trustee.

Specifies a set of object-specific access rights for operations specific to Message Queuing.

The right to delete messages from the queue.

The right to peek messages from the queue.

The right to send messages to the queue.

The right to delete messages from the journal queue.

The right to modify properties of the queue.

The right to read properties of the queue.

The right to delete the queue.

The right to read queue permissions.

The right to modify queue permissions.

The right to take ownership of the queue.

The right to receive messages from the queue. This includes the rights to delete and peek messages.

The right to receive messages from the journal queue. This includes the rights to delete and peek messages from the journal queue.

A combination of , , , and .

A combination of , , and .

Full rights to the queue. A union of all other rights in the enumeration.

Filters message queues when performing a query using the class's method.

Clears all properties from being built into a filter and puts all property values into a "not set" state.

Gets or sets the lower boundary of the queue creation date and time by which to filter queues on the network.

Gets or sets the upper boundary of the queue creation date and time by which to filter queues on the network.

Gets or sets the label by which to filter queues in the network.

Gets or sets the computer name by which to filter queues in the network.

Gets or sets the lower boundary of the queue modification date and time by which to filter queues on the network.

Gets or sets the upper boundary of the queue modification date and time by which to filter queues on the network.

Gets or sets the category by which to filter queues in the network.

Provides a forward-only cursor to enumerate through messages in a message queue.

Frees the resources associated with the enumerator.

Releases all resources used by the .

Releases the unmanaged resources used by the and optionally releases the managed resources.

to release both managed and unmanaged resources; to release only unmanaged resources.

Advances the enumerator to the next queue of the enumeration, if one is currently available.

if the enumerator was succesfully advanced to the next queue; , if the enumerator has reached the end of the enumeration.

Resets the cursor, so it points to the beginning of the enumeration.

Gets the current of the enumeration.

Gets the native Message Queuing handle used to locate queues in a network.

Identifies the source of an error that occurred within the Message Queuing application and generated a exception.

Message text: Generic Error. Message Queuing returns this error if it cannot identify a more specific source.

Message text: The queue is not registered in the directory service. Message Queuing returns this error if it cannot find the queue. This includes public queues not registered in the directory service and Internet queues that do not exist in the Message Queuing namespace.

Message text: A queue with the same pathname is already registered. Message Queuing registers public queues in the directory service, and registers private queues on the local computer.

Message text: The operation was canceled before it could be completed.

Message text: Sharing violation. The queue is already opened for exclusive receive. Message Queuing returns this error if an application is trying to open an already opened queue that has exclusive read rights. For more information about receiving messages exclusively from a queue, see the class's property.

Message text: The Message Queues service is not available. Message Queuing returns this error if the application is unable to connect to the Queue Manager.

Message text: The specified computer could not be found. Message Queuing returns this error if it cannot find the queue's computer in the directory service.

Message text: The user has an invalid user name. Message Queuing returns this error if your application is connecting to it through an invalid user name.

Message text: No connection with this site's controller(s). Message Queuing returns this error if the application cannot access the directory service. If this error is returned, verify permissions for accessing the directory service.

Message text: Invalid queue path name. See the class's property for valid path syntax options.

Message text: Invalid property value.

Message text: The receive or peek message time-out has expired. Message Queuing returns this error if the time-out specified in a call to or expires before a new message arrives in the queue. This can only happen if there was no message already in the queue; both methods would return immediately if a message exists.

Message text: A message that is currently pointed at by the cursor has been removed from the queue by another process or by another call to receive the message without the use of this cursor. Message Queuing returns this error when some other cursor, application, or the system administrator has already removed the message from the queue. This error is most likely to occur when using the class, such as the instance returned through a call to or .

Message text: The given format name is invalid. For valid format name syntax options, see the class's property.

Message text: The requested operation for the specified format name is not supported. Message Queuing returns this error when the requested operation is not supported for the specified format name. Operations include trying to open a queue to receive messages by specifying a direct format name.

Message text: The RPC server cannot impersonate the client application, hence security credentials could not be verified. Message Queuing returns this error if the directory service server cannot impersonate the client application. This is necessary to verify the security credentials.

Message text: Access is denied. Message Queuing returns this error if access to the specified queue or computer is denied. If this error is returned, verify that you have access rights for the operation, such as creating, deleting, or setting properties for a queue. For information about changing access rights for a queue, see the and topics.

Message text: Client does not have the required privileges to perform the operation.

Message text: Insufficient resources to perform operation. Message Queuing returns this error, for example, if there is not enough memory to complete the operation. When this error is returned, the operation fails.

Message text: Could not store a recoverable or journal message. Message was not sent. Message Queuing returns this error if the local computer cannot store a recoverable message (one whose delivery is guaranteed in the case of a network problem) or a journal message. See the class's and properties for more information about these message sending options.

Message text: The user certificate is not valid. Message Queuing returns this error if the security certificate specified in the class's property is invalid, or if the certificate is not correctly placed in the Microsoft Internet Explorer personal certificate store.

Message text: The internal Message Queuing certificate is corrupted. This error applies only to Message Queuing 1.0.

Message text: The internal Message Queuing certificate for the user does not exist. Message Queuing returns this error if no internal certificate is registered or the registered certificate is corrupted.

Message text: A cryptographic function has failed.

Message text: The personal certificate store is corrupted. Message Queuing returns this error when the Microsoft Internet Explorer personal certificate store is corrupted.

Message text: The computer does not support encryption operations. Message Queuing returns this error when the application requests encryption and the computer (source or destination) does not support encryption operations. When this error is returned, the encryption operation fails. For more information about using encryption, see the and topics.

Message text: Could not get the SID information out of the thread token. For more information about sender identifiers, see the class's property.

Message text: Could not get the account information for the user.

Message text: Invalid property for the requested operation

Message text: Not all the required properties for the operation were specified in the input parameters.

Message text: Computer with the same name already exists in the site.

Message text: Directory service is full. Message Queuing returns this error if the information store is full. This error applies only to Message Queuing 1.0.

Message text: Internal directory service error.

Message text: Invalid object owner. For example CreateQueue failed because the Queue Manager object is invalid. Message Queuing returns this error, for example, if your application attempts to create a queue on a computer on which Message Queuing is not installed.

Message text: The specified access mode is not supported. Message Queuing returns this error if the access mode specified when opening the queue is set to an invalid value, or the access mode and the share mode specified are not compatible.

Message text: The connected network cannot be deleted; it is in use. Message Queuing returns this error if it cannot delete the specified connected network because the network is defined in at least one other computer. Remove the connected network from all connected network lists and try again to delete it.

Message text: No response from object owner. Message Queuing returns this error if there is no response from the directory service server. When this error is returned, the status of the operation is unknown.

Message text: Object owner is not reachable. Message Queuing returns this error if the directory service server for the object is not available. When this error is returned, the operation fails.

Message text: Error while reading from a queue residing on a remote computer.

Message text: Cannot connect to MS DTC. Message Queuing returns this error if it is unable to connect to the Microsoft Distributed Transaction Coordinator.

Message text: Cannot import the transaction.

Message text: Wrong transaction usage. Message Queuing returns this error if an attempt was made to open a remote queue for read access from within a transaction, or an attempt was made to read a message from a nontransactional queue from within a transaction.

Message text: Wrong transaction operations sequence.

Message text: Connector Type is mandatory when sending an Acknowledgment or secure message. Message Queuing returns this error when the application sets a property typically set by Message Queuing, but doesn't specify the connector to use. For more information about connector types, see the class's property.

Message text: Cannot enlist the transaction.

Message text: The queue was deleted. Messages cannot be received anymore using this queue instance. The queue should be closed.

Message text: Invalid context parameter.

Message text: The list of MQIS servers (in registry) is empty. This error applies only to Message Queuing 1.0.

Message text: MQIS database is in read-only mode.

Message text: The operation is invalid on foreign message queuing systems.

Message text: Another MQIS server is being installed; write operations to the database are not allowed at this time.

Message text: Message Queuing-independent clients cannot serve Message Queuing-dependent clients.

Message text: The number of dependent clients served by this Message Queuing server reached its upper limit.

Message text: The .ini file for the queue in LQS was deleted because it was corrupted.

Message text: The remote machine is not available.

Message text: The operation is not supported for a WORKGROUP installation computer.

Message text: The Cryptographic Service Provider is not supported by Message Queuing.

Message text: Unable to set the security descriptor for the cryptographic keys. For information about cryptographic providers, see the and topics.

Message text: A user attempted to send an authenticated message without a certificate. Message Queuing returns this error if the sending application attempts to use security context information to authenticate a message, and the security context does not include a certificate. For more information about certificates, see the class's property.

Message text: Unable to create a certificate store for the internal certificate. Message Queuing returns this error if you do not have permission to manipulate your own profile.

Message text: Unable to open the certificates store for the internal certificate. Message Queuing returns this error if you do not have permission to manipulate your own profile.

Message text: The operation is invalid for a Message Queuing services object.

Message text: Failed to grant the "Add Guid" permission to current user.

Message text: Cannot load the MSMQOCM.DLL library.

Message text: Cannot locate an entry point in the MSMQOCM.DLL library.

Message text: Failed to find Message Queuing servers on domain controllers.

Message text: Failed to join Message Queuing enterprise on Windows 2000 domain.

Message text: Failed to create an object on a specified global catalog server.

Message text: Failed to create Message Queuing configuration object with a GUID that matches the computer installation. You must uninstall Message Queuing and then reinstall it.

Message text: Unable to find the public key for computer. Message Queuing returns this error, for example, if you are trying to retrieve the computer properties of a computer running Message Queuing 1.0 or if you are trying to get remote computer properties while working offline. This error applies only to Message Queuing 2.0.

Message text: The public key for the computer does not exist. Message Queuing returns this error if it was able to query the directory service, but the enhanced key was not found. This error applies only to Message Queuing 2.0.

Message text: Unable to find Global Catalog servers in the specified domain.

Message text: Failed to find Message Queuing servers on Global Catalog domain controllers.

Message text: Failed to retrieve the distinguished name of local computer.

Message text: Unable to hash data for an authenticated message.

Message text: Unable to sign data before sending an authenticated message. See the class's property for more information about signing data.

Message text: Unable to create a hash object for an authenticated message. See the class's property for more information about hash algorithms.

Message text: Signature of received message is not valid.

The exception that is thrown if a Microsoft Message Queuing internal error occurs.

Populates a serialization information object with the data needed to serialize the .

A that holds the serialized data associated with the . A that contains the source and destination of the serialized stream associated with the .

Gets a value that indicates the error code associated with this exception.

Gets a value that describes the Message Queuing error.

Allows you to install and configure a queue that your application needs in order to run. This class is called by the installation utility, for example InstallUtil.exe, when installing a .

Initializes a new instance of the class. Does not set any instance properties.

Initializes a new instance of the class, initializing the installation settings to those of an existing instance.

The component whose settings determine the property settings of the new queue installed.

Completes the installation process by committing the installation information that the method wrote to the Registry. This method is meant to be used by installation tools, which automatically call the appropriate methods.

An that contains the post-installation state of the computer.

Copies the property values of a component that are required at install time for a message queue.

An to use as a template for the .

Performs the installation and writes message queue information to the Registry. This method is meant to be used by installation tools, which automatically call the appropriate methods.

An used to save information needed to perform a commit, rollback, or uninstall operation.

Determines whether the specified installer can handle the same kind of installation as this installer.

The installer to compare. if this installer and the installer specified by the parameter can handle the same kind of installation; otherwise, .

Restores the computer to the state it was in before the installation, by rolling back the queue information that the installation procedure wrote to the Registry. This method is meant to be used by installation tools, which automatically call the appropriate methods.

An that contains the pre-installation state of the computer.

Removes an installation by removing queue information from the Registry. This method is meant to be used by uninstallation tools, which automatically call the appropriate methods.

An that contains the post-installation state of the computer.

Gets or sets a value indicating whether the queue to be installed accepts only authenticated messages.

Gets or sets the base priority that is used to route a public queue's messages over the network.

Gets or sets an implementation-specific queue type.

Gets or sets a value indicating whether the queue accepts only private, or encrypted, messages.

Gets or sets a description of the queue.

Gets or sets the maximum size of the journal that is associated with the queue.

Gets or sets the maximum size of the queue.

Gets or sets the location of the queue that is referenced by this object.

Gets or sets permissions associated with the queue.

Gets or sets a value indicating whether the queue accepts only messages sent as part of a transaction.

Gets or sets a value indicating what the installer does with the queue at uninstall time: remove it, restore it to its pre-installation state, or leave it in its current installed state.

Gets or sets a value indicating whether messages that are retrieved from the queue are also copied to the associated journal queue.

Allows control of code access permissions for messaging.

Initializes a new instance of the class.

Initializes a new instance of the class with the specified permission state.

One of the values.

Initializes a new instance of the class with the specified access levels and the path of the queue.

One of the values. The path of the queue that is referenced by the .

Initializes a new instance of the class with the specified access levels, computer to use, queue description, and queue category.

One of the values. The name of the computer where the Message Queuing queue is located. The queue description. The queue category (Message Queuing type identifier).

Initializes a new instance of the class with the specified permission access level entries.

An array of objects. The property is set to this value.

Gets the collection of permission entries for this permissions request.

Defines access levels used by permission classes.

The has no permissions.

The can look at the queues that are available.

The can look at the queues that are available and send messages.

The can look at the queues that are available and read the messages in the queue.

The can look at the queues that are available, read the messages in the queue, and receive messages.

The can look at the queues that are available, read the messages in the queue, and send and receive messages.

Allows declaritive permission checks.

Initializes a new instance of the class.

One of the values.

Creates the permission based on the requested access levels, category, label, computer name, and path that are set through the , , , , and properties on the attribute.

An that represents the created permission.

Gets or sets the queue category.

Gets or sets the queue description.

Gets or sets the name of the computer where the Message Queuing queue is located.

Gets or sets the queue's path.

Gets or sets the permission access levels used in the permissions request.

Defines the smallest unit of a code access security permission set for messaging.

Initializes a new instance of the class with the specified permission access levels and the path of the queue.

A bitwise combination of the values. The property is set to this value. The path of the queue that is referenced by the object. The property is set to this value.

Initializes a new instance of the class with the specified permission access levels, the name of the computer where the queue is located, the queue description, and the queue category.

A bitwise combination of the values. The property is set to this value. The name of the computer where the Message Queuing queue is located. The property is set to this value. The queue description. The property is set to this value. The queue category (Message Queuing type identifier). The property is set to this value.

Gets the queue category.

Gets the queue description.

Gets the name of the computer where the Message Queuing queue is located.

Gets the queue's path.

Gets the permission access levels used in the permissions request.

Contains a strongly typed collection of objects.

Adds a specified to this collection.

The to add. The zero-based index of the added .

Appends a set of specified permission entries to this collection.

An array of type objects that contains the permission entries to add.

Appends a set of specified permission entries to this collection.

A that contains the permission entries to add.

Determines whether this collection contains a specified .

The to find. if the specified belongs to this collection; otherwise, .

Copies the permission entries from this collection to an array, starting at a particular index of the array.

An array of type that receives this collection's permission entries. The zero-based index at which to begin copying the permission entries.

Determines the index of a specified permission entry in this collection.

The permission entry to search for. The zero-based index of the specified permission entry, or -1 if the permission entry was not found in the collection.

Inserts a permission entry into this collection at a specified index.

The zero-based index into the collection at which to insert the permission entry. The permission entry to insert into this collection.

Removes a specified permission entry from this collection.

The permission entry to remove.

Gets or sets the object at a specified index.

The zero-based index into the collection.

Provides a Message Queuing internal transaction.

Initializes a new instance of the class.

Rolls back the pending internal transaction.

Begins a new Message Queuing internal transaction.

Commits a pending internal transaction.

Releases all resources used by the .

Releases the unmanaged resources used by the and optionally releases the managed resources.

to release both managed and unmanaged resources; to release only unmanaged resources.

Gets the status of the transaction.

Specifies the state of an internal Message Queuing transaction.

The transaction has been aborted and all participants have been notified.

The transaction has been committed and all participants have been notified.

The transaction has been initialized. It has not yet been started.

The transaction has been started. It has not yet been either committed or rolled back.

Specifies the type of a Message Queuing transaction.

Operation will not be transactional.

A transaction type used for Microsoft Transaction Server (MTS) or COM+ 1.0 Services. If there is already an MTS transaction context, it will be used when sending or receiving the message.

A transaction type used for single internal transactions.

Identifies the type of a message. A message can be a typical Message Queuing message, a positive (arrival and read) or negative (arrival and read) acknowledgment message, or a report message.

An acknowledgment message.

A normal Message Queuing message.

A report message.

Specifies a description for a property or event.

Initializes a new instance of the class, using the specified description.

The application-defined description text.

Gets description text associated with the item monitored.

Provides data for the event. When your asynchronous peek operation calls an event handler, an instance of this class is passed to the handler.

Gets or sets the result of the asynchronous operation requested.

Gets the message associated with the asynchronous peek operation.

Represents the method that will handle the event of a .

The source of the event, the . A that contains the event data.

Provides data for the event. When your asynchronous receive operation calls an event handler, an instance of this class is passed to the handler.

Gets or sets the result of the asynchronous operation requested.

Gets the message associated with the asynchronous receive operation.

Represents the method that will handle the event of a .

The source of the event, the . A that contains the event data.

Specifies a set of standard access rights that correspond to operations common to most types of securable objects.

The right to delete the object.

The right to read the information in the object's security descriptor.

The right to modify the discretionary access control list (DACL) in the security descriptor. The DACL controls access to the object. Being able to write to the DACL gives the user the ability to set security for the object.

The right to use the object for synchronization. This enables a thread to wait until the object is in a specific state.

The right to change the owner in the object's security descriptor.

The right to read the information in the object's security descriptor. is currently defined to equal .

The right to read the information in the object's security descriptor. On Windows 2000 and Windows NT, the security descriptor contains the security information for a securable object. It identifies the object's owner and primary group. is currently defined to equal .

Combines , , , and access.

Combines , , , , and access.

No access.

Specifies a user account, group account, or logon session to which an access control entry applies.

Initializes a new instance of the class without setting any of its read/write properties.

Initializes a new instance of the class of type , setting the property to the value specified, and the to .

The value to assign to the property.

Initializes a new instance of the class of type , setting the and the properties to the values specified.

The value to assign to the property. The value to assign to the property.

Initializes a new instance of the class of the specified type, setting the and the properties to the values specified.

The value to assign to the property. The value to assign to the property. A that indicates the account type of the trustee.

Gets or sets the name of the trustee.

Gets or sets the computer on which to look up the trustee's account.

Gets or sets the type of the trustee, which identifies whether the trustee is a user, group, computer, domain, or alias.

Specifies the type of a trustee.

The trustee type is unknown, but not necessarily invalid.

The trustee is a user.

The trustee is a group.

The trustee is a domain.

The trustee is an alias.

The trustee is a computer.

Serializes and deserializes objects to or from the body of a message, using the XML format based on the XSD schema definition.

Initializes a new instance of the class, without target types set.

Initializes a new instance of the class, setting target types passed in as an array of (fully qualified) string values.

An array of type that specifies the set of possible types that will be deserialized by the formatter from the message provided. These values must be fully qualified, for example, "MyNamespace.MyOrders, MyOrdersAssemblyName".

Initializes a new instance of the class, setting target types passed in as an array of object types.

An array of type that specifies the set of possible types that will be deserialized by the formatter from the message provided.

Determines whether the formatter can deserialize the message.

The to inspect. if the XML formatter can deserialize the message; otherwise, .

Creates an instance of the class whose read/write properties (the sets of target types) are the same as the current instance.

An object whose properties are identical to those of this instance, but whose metadata does not specify it to be a formatter class instance.

Reads the contents from the given message and creates an object containing the deserialized message.

The , in XML format, to deserialize. The deserialized message.

Serializes an object into the body of the message.

The whose property will contain the serialized object. The to be serialized into the message body.

Specifies the set of possible types that will be deserialized by the formatter from the message provided.

Gets a value indicating whether this converter can convert an object to the given destination type using the context.

An that provides a format context. A that represents the type you wish to convert to. if this converter can perform the conversion; otherwise, .

Creates a path editor control. This will create also a tree view control, and an ImageList with the icons.

[To be supplied.]

Edits the given object value using the editor style provided by GetEditorStyle. A service provider is provided so that any required editing services can be obtained.

A type descriptor context that can be used to provide additional context information. A service provider object through which editing services may be obtained. An instance of the value being edited. The new value of the object. If the value of the object hasn't changed, this should return the same object it was passed.

Retrieves the editing style of the Edit method. If the method is not supported, this will return None.

A type descriptor context that can be used to provide additional context information. An enum value indicating the provided editing style.

Determines if this converter can convert an object in the given source type to the native type of the converter.

A formatter context. This object can be used to extract additional information about the environment this converter is being invoked from. This may be null, so you should always check. Also, properties on the context object may also return null. The type you wish to convert from. True if this object can perform the conversion.

Converts the given object to the converter's native type.

A formatter context. This object can be used to extract additional information about the environment this converter is being invoked from. This may be null, so you should always check. Also, properties on the context object may also return null. Culture to use to perform the conversion The object to convert. The converted object. This will throw an excetpion if the converson could not be performed.

Converts the given object to another type. The most common types to convert are to and from a string object. The default implementation will make a call to ToString on the object if the object is valid and if the destination type is string. If this cannot convert to the desitnation type, this will throw a NotSupportedException.

A formatter context. This object can be used to extract additional information about the environment this converter is being invoked from. This may be null, so you should always check. Also, properties on the context object may also return null. Culture to use to perform the conversion The object to convert. The type to convert the object to. The converted object.