トレーニング
モジュール
Azure Communication Services を使用して C# コンソール アプリケーションから SMS メッセージを送信する - Training
このモジュールでは、Azure Communication Services を介してプロビジョニングされた電話番号を使用して SMS メッセージを送信する C# コンソール アプリケーションを作成します。
このブラウザーはサポートされなくなりました。
Microsoft Edge にアップグレードすると、最新の機能、セキュリティ更新プログラム、およびテクニカル サポートを利用できます。
ASMX サンプルでは、Windows Communication Foundation (WCF) を使用してサービスを作成した後、ASMX クライアントなどの WCF 以外のクライアントからサービスにアクセスする方法を示します。
注意
このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。
このサンプルは、クライアント コンソール プログラム (.exe) と、インターネット インフォメーション サービス (IIS) によってホストされるサービス ライブラリ (.dll) で構成されています。 サービスは、要求/応答通信パターンを定義するコントラクトを実装します。 このコントラクトは ICalculator
インターフェイスによって定義されており、算術演算 (Add
、Subtract
、Multiply
、Divide
) を公開しています。 ASMX クライアントは算術演算を同期要求し、サービスは結果を添えて応答します。
サービスは、次に示すコードで定義される ICalculator
コントラクトを実装します。
[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples"), XmlSerializerFormat]
public interface ICalculator
{
[OperationContract]
double Add(double n1, double n2);
[OperationContract]
double Subtract(double n1, double n2);
[OperationContract]
double Multiply(double n1, double n2);
[OperationContract]
double Divide(double n1, double n2);
}
DataContractSerializer と XmlSerializer は、CLR 型を XML 表現にマップします。 DataContractSerializer は一部の XML 表現を、XmlSerializer とは異なる方法で解釈します。 XmlSerializer を使用する場合、Wsdl.exe などの WCF 以外のプロキシ ジェネレーターでは、より使いやすいインターフェイスが生成されます。 XmlSerializerFormatAttribute が ICalculator
インターフェイスに適用され、CLR 型を XML へマップする際に XmlSerializer が使用されるようになります。 このサービス実装は、計算を行い、結果を返します。
サービスは、そのサービスとの通信に使用する単一エンドポイントを公開します。エンドポイントは構成ファイル (Web.config) で定義します。 エンドポイントは、アドレス、バインディング、およびコントラクトがそれぞれ 1 つずつで構成されます。 サービスは、インターネット インフォメーション サービス (IIS) ホストから提供されるベース アドレスで、エンドポイントを公開します。 binding
属性は basicHttpBinding に設定されます。これにより、WS-I Basic Profile 1.1 に準拠した SOAP 1.1 を使用する HTTP 通信を実現します。次のサンプル構成を参照してください。
<services>
<service name="Microsoft.ServiceModel.Samples.CalculatorService"
behaviorConfiguration="CalculatorServiceBehavior">
<!-- This endpoint is exposed at the base address provided by the host: http://localhost/servicemodelsamples/service.svc. -->
<endpoint address=""
binding="basicHttpBinding"
contract="Microsoft.ServiceModel.Samples.ICalculator" />
</service>
</services>
ASMX クライアントでは、WCF サービスとの通信に、Web サービス記述言語 (WSDL) ユーティリティ (Wsdl.exe) によって生成された、型指定のあるプロキシを使用します。 型指定のあるプロキシは、ファイル generatedClient.cs に含まれています。 WSDL ユーティリティは、指定されたサービスが使用するメタデータを取得し、クライアントが通信に使用する型指定のあるプロキシを生成します。 既定では、フレームワークはメタデータを公開しません。 プロキシの生成に必要なメタデータを公開するには、次の構成に示すように、<serviceMetadata> を追加し、その httpGetEnabled
属性を True
に設定する必要があります。
<behaviors>
<serviceBehaviors>
<behavior name="CalculatorServiceBehavior">
<!-- Setting httpGetEnabled to True on the serviceMetadata
behavior exposes the service's wsdl at <base address>?wsdl :
http://localhost/servicemodelsamples/service.svc?wsdl -->
<serviceMetadata httpGetEnabled="True"/>
<serviceDebug includeExceptionDetailInFaults="False" />
</behavior>
</serviceBehaviors>
</behaviors>
次のコマンドをクライアント ディレクトリでコマンド プロンプトから実行して、型指定のあるプロキシを生成します。
wsdl /n:Microsoft.ServiceModel.Samples /o:generatedClient.cs /urlkey:CalculatorServiceAddress http://localhost/servicemodelsamples/service.svc?wsdl
生成された型指定のあるプロキシを使用することにより、クライアントは適切なアドレスを構成して、指定のサービス エンドポイントにアクセスできます。 クライアントは構成ファイル (App.config) を使用して、通信するエンドポイントを指定します。
<appSettings>
<add key="CalculatorServiceAddress"
value="http://localhost/ServiceModelSamples/service.svc"/>
</appSettings>
クライアント実装は型指定のあるプロキシのインスタンスを構築し、サービスとの通信を開始します。
// Create a client to the CalculatorService.
using (CalculatorService client = new CalculatorService())
{
// Call the Add service operation.
double value1 = 100.00D;
double value2 = 15.99D;
double result = client.Add(value1, value2);
Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);
// Call the Subtract service operation.
value1 = 145.00D;
value2 = 76.54D;
result = client.Subtract(value1, value2);
Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);
// Call the Multiply service operation.
value1 = 9.00D;
value2 = 81.25D;
result = client.Multiply(value1, value2);
Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);
// Call the Divide service operation.
value1 = 22.00D;
value2 = 7.00D;
result = client.Divide(value1, value2);
Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);
}
Console.WriteLine();
Console.WriteLine("Press <ENTER> to terminate client.");
Console.ReadLine();
このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。 クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。
Add(100,15.99) = 115.99
Subtract(145,76.54) = 68.46
Multiply(9,81.25) = 731.25
Divide(22,7) = 3.14285714285714
Press <ENTER> to terminate client.
Windows Communication Foundation サンプルの 1 回限りのセットアップの手順を実行したことを確認します。
ソリューションの C# 版または Visual Basic .NET 版をビルドするには、「 Building the Windows Communication Foundation Samples」の手順に従います。
単一または複数コンピューター構成でサンプルを実行するには、「Windows Communication Foundation サンプルの実行」の手順に従います。
注意
複合データ型を渡す方法と返す方法の詳細については、「Windows フォーム クライアントのデータ バインディング」、「Windows Presentation Foundation クライアントでのデータ バインディング」、「ASP.NET クライアントでのデータ バインディング」を参照してください。
トレーニング
モジュール
Azure Communication Services を使用して C# コンソール アプリケーションから SMS メッセージを送信する - Training
このモジュールでは、Azure Communication Services を介してプロビジョニングされた電話番号を使用して SMS メッセージを送信する C# コンソール アプリケーションを作成します。