MsmqIntegrationBinding Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
A classe MsmqIntegrationBinding mapeia Microsoft mensagens de Fila de Mensagens (MSMQ) para mensagens Windows Communication Foundation (WCF).
public ref class MsmqIntegrationBinding : System::ServiceModel::MsmqBindingBase
public class MsmqIntegrationBinding : System.ServiceModel.MsmqBindingBase
type MsmqIntegrationBinding = class
inherit MsmqBindingBase
Public Class MsmqIntegrationBinding
Inherits MsmqBindingBase
- Herança
Exemplos
O seguinte excerto do ficheiro de configuração ilustra como configurar a MsmqIntegrationBinding ligação no cliente:
O seguinte excerto de ficheiro de configuração ilustra como configurar a MsmqIntegrationBinding ligação no serviço:
[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]
[ServiceKnownType(typeof(PurchaseOrder))]
public interface IOrderProcessor
{
[OperationContract(IsOneWay = true, Action = "*")]
void SubmitPurchaseOrder(MsmqMessage<PurchaseOrder> msg);
}
<ServiceContract(Namespace:="http:'Microsoft.ServiceModel.Samples")> _
<ServiceKnownType(GetType(PurchaseOrder))> _
Public Interface IOrderProcessor
<OperationContract(IsOneWay:=True, Action:="*")> _
Sub SubmitPurchaseOrder(ByVal msg As MsmqMessage(Of PurchaseOrder))
End Interface
O código seguinte ilustra como usar a MsmqIntegrationBinding ligação no serviço programáticamente:
public class OrderProcessorService : IOrderProcessor
{
[OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = true)]
public void SubmitPurchaseOrder(MsmqMessage<PurchaseOrder> ordermsg)
{
PurchaseOrder po = (PurchaseOrder)ordermsg.Body;
Random statusIndexer = new Random();
po.Status = (OrderStates)statusIndexer.Next(3);
Console.WriteLine("Processing {0} ", po);
}
// Host the service within this EXE console application.
public static void Main()
{
// Get base address from appsettings in configuration.
Uri baseAddress = new Uri(ConfigurationManager.AppSettings["baseAddress"]);
// Create a ServiceHost for the CalculatorService type and provide the base address.
using (ServiceHost serviceHost = new ServiceHost(typeof(IOrderProcessor), baseAddress))
{
// Open the ServiceHostBase to create listeners and start listening for messages.
serviceHost.Open();
// The service can now be accessed.
Console.WriteLine("The service is ready.");
Console.WriteLine("The service is running in the following account: {0}", WindowsIdentity.GetCurrent().Name);
Console.WriteLine("Press <ENTER> to terminate service.");
Console.WriteLine();
Console.ReadLine();
// Close the ServiceHostBase to shutdown the service.
serviceHost.Close();
}
}
}
Public Class OrderProcessorService
Implements IOrderProcessor
<OperationBehavior(TransactionScopeRequired:=True, TransactionAutoComplete:=True)> _
Public Sub SubmitPurchaseOrder(ByVal ordermsg As MsmqMessage(Of PurchaseOrder)) Implements IOrderProcessor.SubmitPurchaseOrder
Dim po As PurchaseOrder = ordermsg.Body
Dim statusIndexer As New Random()
po.Status = statusIndexer.Next(3)
Console.WriteLine("Processing {0} ", po)
End Sub
End Class
O código seguinte ilustra como usar a MsmqIntegrationBinding ligação no cliente programaticamente:
MsmqIntegrationBinding binding = new MsmqIntegrationBinding();
EndpointAddress address = new EndpointAddress("msmq.formatname:DIRECT=OS:.\\private$\\Orders");
ChannelFactory<IOrderProcessor> channelFactory = new ChannelFactory<IOrderProcessor>(binding, address);
IOrderProcessor channel = channelFactory.CreateChannel();
PurchaseOrder po = new PurchaseOrder();
po.customerId = "somecustomer.com";
po.poNumber = Guid.NewGuid().ToString();
PurchaseOrderLineItem lineItem1 = new PurchaseOrderLineItem();
lineItem1.productId = "Blue Widget";
lineItem1.quantity = 54;
lineItem1.unitCost = 29.99F;
PurchaseOrderLineItem lineItem2 = new PurchaseOrderLineItem();
lineItem2.productId = "Red Widget";
lineItem2.quantity = 890;
lineItem2.unitCost = 45.89F;
po.orderLineItems = new PurchaseOrderLineItem[2];
po.orderLineItems[0] = lineItem1;
po.orderLineItems[1] = lineItem2;
MsmqMessage<PurchaseOrder> ordermsg = new MsmqMessage<PurchaseOrder>(po);
using (TransactionScope scope = new TransactionScope(TransactionScopeOption.Required))
{
channel.SubmitPurchaseOrder(ordermsg);
scope.Complete();
}
Console.WriteLine("Order has been submitted:{0}", po);
Dim binding As New MsmqIntegrationBinding()
Dim address As New EndpointAddress("msmq.formatname:DIRECT=OS:.\\private$\\Orders")
Dim channelFactory As New ChannelFactory(Of IOrderProcessor)(binding, address)
Dim channel As IOrderProcessor = channelFactory.CreateChannel()
Dim po As New PurchaseOrder()
po.customerId = "somecustomer.com"
po.poNumber = Guid.NewGuid().ToString()
Dim lineItem1 As New PurchaseOrderLineItem()
lineItem1.productId = "Blue Widget"
lineItem1.quantity = 54
lineItem1.unitCost = 29.99F
Dim lineItem2 = New PurchaseOrderLineItem()
lineItem2.productId = "Red Widget"
lineItem2.quantity = 890
lineItem2.unitCost = 45.89F
Dim lineItems(1) As PurchaseOrderLineItem
lineItems(0) = lineItem1
lineItems(1) = lineItem2
po.orderLineItems = lineItems
Dim ordermsg As MsmqMessage(Of PurchaseOrder) = New MsmqMessage(Of PurchaseOrder)(po)
Using scope As New TransactionScope(TransactionScopeOption.Required)
channel.SubmitPurchaseOrder(ordermsg)
scope.Complete()
End Using
Console.WriteLine("Order has been submitted:{0}", po)
Observações
Important
Chamar métodos dessa classe com dados não confiáveis é um risco de segurança. Chame os métodos dessa classe somente com dados confiáveis. Para obter mais informações, consulte Validar todas as informações inseridas.
Esta ligação pode ser usada para permitir que aplicações WCF enviem e recebam mensagens para e a partir de aplicações MSMQ existentes que utilizam COM, APIs nativas C++ ou os tipos definidos no System.Messaging espaço de nomes.
Construtores
| Name | Description |
|---|---|
| MsmqIntegrationBinding() |
Inicializa uma nova instância da MsmqIntegrationBinding classe. |
| MsmqIntegrationBinding(MsmqIntegrationSecurityMode) |
Inicializa uma nova instância da MsmqIntegrationBinding classe usando o especificado MsmqIntegrationSecurityMode. |
| MsmqIntegrationBinding(String) |
Inicializa uma nova instância da MsmqIntegrationBinding classe a partir das definições de um elemento de ligação de configuração especificado. |
Propriedades
| Name | Description |
|---|---|
| CloseTimeout |
Obtém ou define o intervalo de tempo fornecido para que uma ligação se feche antes de o transporte levantar uma exceção. (Herdado de Binding) |
| CustomDeadLetterQueue |
Recebe ou define um URI que contém a localização da fila de letras mortas para cada aplicação, onde são colocadas mensagens que expiraram ou que falharam na transferência ou entrega. (Herdado de MsmqBindingBase) |
| DeadLetterQueue |
Recebe ou define um valor de enumeração que indica o tipo de fila de letras mortas a utilizar. (Herdado de MsmqBindingBase) |
| Durable |
Recebe ou define um valor que indica se as mensagens processadas por esta ligação são duráveis ou voláteis. (Herdado de MsmqBindingBase) |
| ExactlyOnce |
Recebe ou define um valor que indica se as mensagens processadas por esta ligação são recebidas exatamente uma vez. (Herdado de MsmqBindingBase) |
| MaxReceivedMessageSize |
Obtém ou define o tamanho máximo, em bytes, para uma mensagem processada por esta ligação. (Herdado de MsmqBindingBase) |
| MaxRetryCycles |
Obtém ou define o número máximo de ciclos de retentativa para tentar a entrega das mensagens à aplicação recetora. (Herdado de MsmqBindingBase) |
| MessageVersion |
Obtém a versão da mensagem usada por clientes e serviços configurada com a ligação. (Herdado de Binding) |
| Name |
Recebe ou define o nome da ligação. (Herdado de Binding) |
| Namespace |
Obtém ou define o namespace XML do binding. (Herdado de Binding) |
| OpenTimeout |
Obtém ou define o intervalo de tempo fornecido para que uma ligação se abra antes de o transporte levantar uma exceção. (Herdado de Binding) |
| ReceiveContextEnabled |
Recebe ou define um valor que indica se o comportamento do contexto de receção é solicitado. (Herdado de MsmqBindingBase) |
| ReceiveErrorHandling |
Recebe ou define um valor de enumeração que especifica como as mensagens de veneno são tratadas. (Herdado de MsmqBindingBase) |
| ReceiveRetryCount |
Obtém ou define o número máximo de tentativas imediatas de entrega numa mensagem lida da fila da aplicação. (Herdado de MsmqBindingBase) |
| ReceiveTimeout |
Obtém ou define o intervalo de tempo em que uma ligação pode permanecer inativa, durante o qual não são recebidas mensagens de aplicação, antes de ser cortada. (Herdado de Binding) |
| RetryCycleDelay |
Recebe ou define um valor que indica o atraso temporal entre ciclos de retentativa ao tentar entregar uma mensagem que não pode ser entregue imediatamente. (Herdado de MsmqBindingBase) |
| Scheme |
Devolve o esquema para esta ligação. (Herdado de MsmqBindingBase) |
| Security |
Obtém-se o MsmqIntegrationSecurity que está associado a esta ligação. |
| SendTimeout |
Obtém ou define o intervalo de tempo fornecido para que uma operação de escrita seja concluída antes de o transporte levantar uma exceção. (Herdado de Binding) |
| SerializationFormat |
Obtém ou define o formato de serialização a ser usado para serializar ou desserializar a mensagem. |
| TimeToLive |
Obtém ou define o intervalo de tempo que indica quanto tempo as mensagens processadas por esta ligação podem permanecer na fila antes de expirarem. (Herdado de MsmqBindingBase) |
| UseMsmqTracing |
Obtém ou define um valor que indica se as mensagens processadas por esta ligação devem ser rastreadas. (Herdado de MsmqBindingBase) |
| UseSourceJournal |
Recebe ou define um valor que indica se cópias das mensagens processadas por esta ligação devem ser armazenadas na fila de diário de origem. (Herdado de MsmqBindingBase) |
| ValidityDuration |
Recebe ou define um valor que especifica a duração em que uma mensagem será bloqueada pela funcionalidade de contexto de receção. (Herdado de MsmqBindingBase) |
Métodos
| Name | Description |
|---|---|
| BuildChannelFactory<TChannel>(BindingParameterCollection) |
Constrói a pilha de channel factory no cliente que cria um tipo específico de canal e que satisfaz as características especificadas por um conjunto de parâmetros de ligação. (Herdado de Binding) |
| BuildChannelFactory<TChannel>(Object[]) |
Constrói a stack de channel factory no cliente que cria um tipo específico de canal e que satisfaz as características especificadas por um array de objetos. (Herdado de Binding) |
| BuildChannelListener<TChannel>(BindingParameterCollection) |
Constrói o ouvinte de canal no serviço que aceita um tipo específico de canal e que satisfaz as características especificadas por um conjunto de parâmetros de ligação. (Herdado de Binding) |
| BuildChannelListener<TChannel>(Object[]) |
Constrói o ouvinte de canal no serviço que aceita um tipo específico de canal e que satisfaz as funcionalidades especificadas. (Herdado de Binding) |
| BuildChannelListener<TChannel>(Uri, BindingParameterCollection) |
Constrói o ouvinte de canal no serviço que aceita um tipo específico de canal e que satisfaz as funcionalidades especificadas. (Herdado de Binding) |
| BuildChannelListener<TChannel>(Uri, Object[]) |
Constrói o ouvinte de canal no serviço que aceita um tipo específico de canal e que satisfaz as funcionalidades especificadas. (Herdado de Binding) |
| BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) |
Constrói o ouvinte de canal no serviço que aceita um tipo específico de canal e que satisfaz as funcionalidades especificadas. (Herdado de Binding) |
| BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) |
Constrói o ouvinte de canal no serviço que aceita um tipo específico de canal e que satisfaz as funcionalidades especificadas. (Herdado de Binding) |
| BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) |
Constrói o ouvinte de canal no serviço que aceita um tipo específico de canal e que satisfaz as funcionalidades especificadas. (Herdado de Binding) |
| BuildChannelListener<TChannel>(Uri, String, Object[]) |
Constrói o ouvinte de canal no serviço que aceita um tipo específico de canal e que satisfaz as funcionalidades especificadas. (Herdado de Binding) |
| CanBuildChannelFactory<TChannel>(BindingParameterCollection) |
Devolve um valor que indica se a ligação atual pode construir uma pilha de channel factory no cliente que satisfaz a coleção de parâmetros de ligação especificada. (Herdado de Binding) |
| CanBuildChannelFactory<TChannel>(Object[]) |
Devolve um valor que indica se a ligação atual pode construir uma stack de channel factory no cliente que satisfaz os requisitos especificados por um array de objetos. (Herdado de Binding) |
| CanBuildChannelListener<TChannel>(BindingParameterCollection) |
Devolve um valor que indica se a ligação atual pode construir uma pilha de ouvintes de canal no serviço que satisfaz a coleção de parâmetros de ligação especificada. (Herdado de Binding) |
| CanBuildChannelListener<TChannel>(Object[]) |
Devolve um valor que indica se a ligação atual pode construir uma pilha de ouvintes de canal no serviço que satisfaça os critérios especificados num array de objetos. (Herdado de Binding) |
| CreateBindingElements() |
Devolve os elementos de ligação na pilha básica de perfis. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetProperty<T>(BindingParameterCollection) |
Devolve um objeto tipado solicitado, se presente, da camada apropriada na pilha de ligação. (Herdado de Binding) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ShouldSerializeName() |
Devolve se o nome da ligação deve ser serializado. (Herdado de Binding) |
| ShouldSerializeNamespace() |
Devolve se o namespace da ligação deve ser serializado. (Herdado de Binding) |
| ShouldSerializeSecurity() |
Recebe um valor que especifica se a informação de segurança deve ser serializada. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| IBindingRuntimePreferences.ReceiveSynchronously |
Obtém um valor que indica se os pedidos recebidos podem ser tratados de forma mais eficiente, síncrona ou assíncrona. (Herdado de MsmqBindingBase) |