訓練
模組
Dual-write implementation for Dynamics 365 solutions - Training
The Dual-write implementation workshop guides you through key points to help identify and resolve potential blockers to a successful dual-write implementation.
雙面範例 (英文) 示範如何定義和實作雙面合約。 用戶端建立與服務的工作階段,並提供服務所需的通道以供服務將訊息傳回用戶端,這個程序即是所謂的雙工通訊。 這個範例以使用者入門為基礎。 雙工合約被定義為一對介面,其中的主要介面從用戶端到服務,回呼介面從服務到用戶端。 在此範例中,ICalculatorDuplex
介面允許用戶端執行數學運算,透過工作階段執行結果。 服務傳回 ICalculatorDuplexCallback
介面上的結果。 雙工合約需要一個工作階段,因為必須建立內容,將用戶端與服務之間傳送的訊息關聯在一起。
注意
此範例的安裝程序與建置指示位於本主題的結尾。
在這個範例中,用戶端是主控台應用程式 (.exe),而服務則是由網際網路資訊服務 (IIS) 所裝載。 雙工合約的定義如下:
[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples", SessionMode=SessionMode.Required,
CallbackContract=typeof(ICalculatorDuplexCallback))]
public interface ICalculatorDuplex
{
[OperationContract(IsOneWay = true)]
void Clear();
[OperationContract(IsOneWay = true)]
void AddTo(double n);
[OperationContract(IsOneWay = true)]
void SubtractFrom(double n);
[OperationContract(IsOneWay = true)]
void MultiplyBy(double n);
[OperationContract(IsOneWay = true)]
void DivideBy(double n);
}
public interface ICalculatorDuplexCallback
{
[OperationContract(IsOneWay = true)]
void Result(double result);
[OperationContract(IsOneWay = true)]
void Equation(string eqn);
}
CalculatorService
類別會實作主要的 ICalculatorDuplex
介面。 服務會使用 PerSession 執行個體模式維持各工作階段的結果。 而名為 Callback
的私用屬性用於存取用戶端的回呼通道。 服務會使用回呼,以透過回呼介面將訊息傳回用戶端。
[ServiceBehavior(InstanceContextMode = InstanceContextMode.PerSession)]
public class CalculatorService : ICalculatorDuplex
{
double result = 0.0D;
string equation;
public CalculatorService()
{
equation = result.ToString();
}
public void Clear()
{
Callback.Equation($"{equation} = {result}");
equation = result.ToString();
}
public void AddTo(double n)
{
result += n;
equation += $" + {n}";
Callback.Result(result);
}
//...
ICalculatorDuplexCallback Callback
{
get
{
return OperationContext.Current.GetCallbackChannel<ICalculatorDuplexCallback>();
}
}
}
用戶端必須提供實作雙工合約回呼介面的類別,用於接收來自服務的訊息。 在範例中,定義 CallbackHandler
類別以實作 ICalculatorDuplexCallback
介面。
public class CallbackHandler : ICalculatorDuplexCallback
{
public void Result(double result)
{
Console.WriteLine("Result({0})", result);
}
public void Equation(string equation)
{
Console.WriteLine("Equation({0}", equation);
}
}
針對雙工合約所產生的 Proxy,會要求在建構時提供 InstanceContext。 這個 InstanceContext 會用來做為站台,讓物件實作回呼介面並處理服務傳回的訊息。 InstanceContext 是以 CallbackHandler
類別的執行個體所建構。 這個物件會處理回呼介面上,從服務傳回至用戶端的訊息。
// Construct InstanceContext to handle messages on callback interface.
InstanceContext instanceContext = new InstanceContext(new CallbackHandler());
// Create a client.
CalculatorDuplexClient client = new CalculatorDuplexClient(instanceContext);
Console.WriteLine("Press <ENTER> to terminate client once the output is displayed.");
Console.WriteLine();
// Call the AddTo service operation.
double value = 100.00D;
client.AddTo(value);
// Call the SubtractFrom service operation.
value = 50.00D;
client.SubtractFrom(value);
// Call the MultiplyBy service operation.
value = 17.65D;
client.MultiplyBy(value);
// Call the DivideBy service operation.
value = 2.00D;
client.DivideBy(value);
// Complete equation.
client.Clear();
Console.ReadLine();
//Closing the client gracefully closes the connection and cleans up resources.
client.Close();
組態已經過修改,以提供同時支援工作階段通訊和雙工通訊的繫結。 wsDualHttpBinding
支援工作階段通訊,並且藉由提供雙重 HTTP 連接 (一個方向一個連接) 允許雙工通訊。 在服務上,組態中的唯一差異是所使用的繫結。 在用戶端上,您必須設定伺服器可用來連接用戶端的位址,如下面的範例組態中所示。
<client>
<endpoint name=""
address="http://localhost/servicemodelsamples/service.svc"
binding="wsDualHttpBinding"
bindingConfiguration="DuplexBinding"
contract="Microsoft.ServiceModel.Samples.ICalculatorDuplex" />
</client>
<bindings>
<!-- Configure a binding that support duplex communication. -->
<wsDualHttpBinding>
<binding name="DuplexBinding"
clientBaseAddress="http://localhost:8000/myClient/">
</binding>
</wsDualHttpBinding>
</bindings>
執行範例時,您會看到傳回用戶端的訊息,該用戶端位於從服務傳送出的回呼介面上。 顯示每個中繼結果,接著顯示在完成所有操作時的整個方程式。 按 ENTER 鍵關閉用戶端。
若要建置方案的 C#、C++ 或 Visual Basic .NET 版本,請遵循 建置 Windows Communication Foundation 範例 (部分機器翻譯) 中的指示。
若要在單一或多部電腦組態中執行此範例,請遵循執行 Windows Communication Foundation 範例中的指示進行。
重要
在跨電腦設定中執行用戶端時,請務必以適當電腦的名稱取代<用戶端>元素之<端點的 >address
屬性,以及 <wsDualHttpBinding> 元素之<繫結>元素 clientBaseAddress
屬性中的「localhost」,如下所示:
<client>
<endpoint name = ""
address="http://service_machine_name/servicemodelsamples/service.svc"
... />
</client>
...
<wsDualHttpBinding>
<binding name="DuplexBinding" clientBaseAddress="http://client_machine_name:8000/myClient/">
</binding>
</wsDualHttpBinding>
訓練
模組
Dual-write implementation for Dynamics 365 solutions - Training
The Dual-write implementation workshop guides you through key points to help identify and resolve potential blockers to a successful dual-write implementation.