MsmqTransportBindingElement Classe

Définition

Représente l’élément de liaison utilisé pour spécifier les propriétés de communication de la mise en file d’attente pour un service Windows Communication Foundation (WCF) qui utilise le protocole MSMQ (Message Queuing) natif.Represents the binding element used to specify the queuing communication properties for a Windows Communication Foundation (WCF) service that uses the native Message Queuing (MSMQ) protocol.

public ref class MsmqTransportBindingElement sealed : System::ServiceModel::Channels::MsmqBindingElementBase
public sealed class MsmqTransportBindingElement : System.ServiceModel.Channels.MsmqBindingElementBase
type MsmqTransportBindingElement = class
    inherit MsmqBindingElementBase
Public NotInheritable Class MsmqTransportBindingElement
Inherits MsmqBindingElementBase
Héritage

Exemples

string queueName = @".\private$\ServiceModelSamples";

if (!MessageQueue.Exists(queueName))
    MessageQueue.Create(queueName, true);

using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService)))
{
    BinaryMessageEncodingBindingElement encodingBindingElement = new BinaryMessageEncodingBindingElement();
    MsmqTransportBindingElement transportBindingElement = new MsmqTransportBindingElement();
    CustomBinding binding = new CustomBinding(encodingBindingElement, transportBindingElement);
    
    serviceHost.AddServiceEndpoint(
        typeof(IQueueCalculator),
        binding,
        "net.msmq://localhost/private/ServiceModelSamples");

    serviceHost.Open();

    // The service can now be accessed.
    Console.WriteLine("The service is ready.");
    Console.WriteLine("Press <ENTER> to terminate service.");
    Console.WriteLine();
    Console.ReadLine();

    // Close the ServiceHost to shutdown the service.
    serviceHost.Close();

Remarques

La MsmqTransportBindingElement permet à l'utilisateur de définir les propriétés du canal de communication mis en file d'attente.The MsmqTransportBindingElement enables the user to set the properties of the queued communication channel. Le canal de communication mis en file d'attente utilise Message Queuing pour son transport.The queued communication channel uses Message Queuing for its transport.

Cet élément de liaison est l’élément de liaison par défaut utilisé par la liaison standard Message Queuing (NetMsmqBinding).This binding element is the default binding element used by the Message Queuing standard binding (NetMsmqBinding).

Constructeurs

MsmqTransportBindingElement()

Initialise une nouvelle instance de la classe MsmqTransportBindingElement.Initializes a new instance of the MsmqTransportBindingElement class.

Propriétés

CustomDeadLetterQueue

Obtient ou définit un Uri qui identifie une file d'attente de lettres mortes personnalisée dans laquelle les messages qui ont expiré ou ceux dont la remise a échoué sont envoyés.Gets or sets a Uri that identifies a custom dead-letter queue where expired messages or messages that failed to be delivered are sent.

(Hérité de MsmqBindingElementBase)
DeadLetterQueue

Obtient ou définit le paramètre DeadLetterQueue pour la liaison.Gets or sets the DeadLetterQueue setting for this binding.

(Hérité de MsmqBindingElementBase)
Durable

Obtient ou définit une valeur qui spécifie si les messages envoyés avec cette liaison sont durables ou volatils.Gets or sets a value that specifies whether messages sent with this binding are durable or volatile.

(Hérité de MsmqBindingElementBase)
ExactlyOnce

Obtient ou définit une valeur qui spécifie si les messages envoyés avec cette liaison ont des assurances Exactly Once.Gets or sets a value that specifies whether messages sent with this binding have exactly once assurances.

(Hérité de MsmqBindingElementBase)
ManualAddressing

Obtient ou définit une valeur qui indique si l'adressage manuel du message est requis.Gets or sets a value that indicates whether manual addressing of the message is required.

(Hérité de TransportBindingElement)
MaxBufferPoolSize

Obtient ou définit la taille maximale (en octets) des pools de mémoires tampons utilisés par le transport.Gets or sets the maximum size, in bytes, of any buffer pools used by the transport.

(Hérité de TransportBindingElement)
MaxPoolSize

Obtient ou définit un entier qui spécifie la taille maximale du pool qui contient des objets de message Message Queuing (MSMQ) internes.Gets or sets an integer that specifies the maximum size of the pool that contains internal Message Queuing (MSMQ) message objects.

MaxReceivedMessageSize

Obtient ou définit la taille maximale du message autorisée (en octets) qui peut être reçue.Gets or sets the maximum allowable message size, in bytes, that can be received.

(Hérité de TransportBindingElement)
MaxRetryCycles

Obtient ou définit le nombre maximal de cycles de nouvelle tentative de livraison de messages à l'application de réception.Gets or sets the maximum number of retry cycles to attempt delivery of messages to the receiving application.

(Hérité de MsmqBindingElementBase)
MsmqTransportSecurity

Obtient l'objet MsmqTransportSecurity associé à cet élément de liaison.Gets the MsmqTransportSecurity that is associated with this binding element.

(Hérité de MsmqBindingElementBase)
QueueTransferProtocol

Obtient ou définit une valeur d'énumération qui indique le transport de canal de communication mis en file d'attente que cette liaison utilise.Gets or sets an enumeration value that indicates the queued communication channel transport that this binding uses.

ReceiveContextEnabled

Obtient ou définit une valeur qui indique si le comportement de contexte de réception est demandé.Gets or sets a value that indicates whether the receive context behavior is requested.

(Hérité de MsmqBindingElementBase)
ReceiveErrorHandling

Obtient ou définit une valeur d'énumération qui spécifie la façon dont les messages incohérents ou ne pouvant pas être distribués sont gérés.Gets or sets an enumeration value that specifies how poison and other messages that cannot be dispatched are handled.

(Hérité de MsmqBindingElementBase)
ReceiveRetryCount

Obtient ou définit le nombre maximal de fois où le gestionnaire de files d'attente doit tenter d'envoyer un message avant de le transférer à la file d'attente des nouvelles tentatives.Gets or sets the maximum number of times the queue manager should attempt to send a message before transferring it to the retry queue.

(Hérité de MsmqBindingElementBase)
RetryCycleDelay

Obtient ou définit une valeur qui spécifie le délai d'attente avant de tenter un autre cycle de nouvelle tentative lors d'une tentative de remise d'un message qui n'a pas pu l'être.Gets or sets a value that specifies how long to wait before attempting another retry cycle when attempting to deliver a message that could not be delivered.

(Hérité de MsmqBindingElementBase)
Scheme

Retourne un objet String qui contient le modèle d'adressage utilisé par cet élément de liaison de transport.Returns a String that contains the addressing scheme that is used by this transport binding element.

TimeToLive

Obtient ou définit une valeur qui spécifie la durée pendant laquelle les messages sont valides.Gets or sets a value that specifies how long messages are valid. Lorsque ce délai est écoulé, le message est placé dans une file d'attente de lettres mortes selon le paramètre DeadLetterQueue.When this time has elapsed the message is placed in a dead-letter queue depending on the DeadLetterQueue setting.

(Hérité de MsmqBindingElementBase)
TransactedReceiveEnabled

Obtient une valeur qui spécifie si une transaction est requise pour recevoir des messages avec cette liaison.Gets a value that specifies whether a transaction is required to receive messages with this binding.

(Hérité de MsmqBindingElementBase)
UseActiveDirectory

Renvoie une valeur booléenne qui indique si des adresses de file d'attente doivent être converties à l'aide d'Active Directory.Returns a Boolean value that indicates whether queue addresses should be converted using Active Directory.

UseMsmqTracing

Obtient ou définit une valeur qui active ou désactive la fonctionnalité intégrée de traçage des messages Message Queuing (MSMQ).Gets or sets a value that enables or disables the Message Queuing (MSMQ) built-in message tracing facility.

(Hérité de MsmqBindingElementBase)
UseSourceJournal

Obtient ou définit une valeur qui indique si les copies des messages traités par cette liaison doivent être stockées dans la file d'attente du journal source.Gets or sets a value that indicates whether copies of messages processed by this binding should be stored in the source journal queue.

(Hérité de MsmqBindingElementBase)
ValidityDuration

Obtient ou définit une valeur qui spécifie la durée de verrouillage d'un message par la fonctionnalité de contexte de réception.Gets or sets a value that specifies the duration a message will be locked by the receive context feature.

(Hérité de MsmqBindingElementBase)

Méthodes

BuildChannelFactory<TChannel>(BindingContext)

Génère une fabrique de canal à l'aide du contexte fourni.Builds a channel factory using the context provided.

BuildChannelListener<TChannel>(BindingContext)

Génère un écouteur de canal à l'aide du contexte fourni.Builds a channel listener using the context provided.

CanBuildChannelFactory<TChannel>(BindingContext)

Retourne une valeur Boolean qui indique si vous pouvez générer une fabrique de canaux avec le contexte fourni.Returns a Boolean value that indicates whether you can build a channel factory with the context provided.

CanBuildChannelListener<TChannel>(BindingContext)

Retourne une valeur booléenne qui indique si vous pouvez générer un écouteur de canal avec le contexte fourni.Returns a Boolean value that indicates whether you can build a channel listener with the context provided.

Clone()

Retourne un clone de l'élément de liaison.Returns a clone of the binding element.

Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetProperty<T>(BindingContext)

En cas de remplacement dans une classe dérivée, récupère un type d'objet spécifié pour le contexte de liaison indiqué.When overridden in a derived class, retrieves a specified type of object for the binding context provided.

(Hérité de MsmqBindingElementBase)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)

Implémentations d’interfaces explicites

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)

Exporte des assertions de stratégie personnalisée concernant les liaisons.Exports custom policy assertions about bindings.

(Hérité de MsmqBindingElementBase)
IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)

Écrit des éléments WSDL (Web Services Description Language) personnalisés dans le WSDL généré pour un contrat.Writes custom Web Services Description Language (WSDL) elements into the generated WSDL for a contract.

(Hérité de MsmqBindingElementBase)
IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)

Écrit des éléments WSDL (Web Services Description Language) personnalisés dans le WSDL généré pour un point de terminaison.Writes custom Web Services Description Language (WSDL) elements into the generated WSDL for an endpoint.

(Hérité de MsmqBindingElementBase)

S’applique à