Visual Studio でチャートコントロールと Microsoft Exchange をデータバインド

データバインドによって、UI コントロールからデータに接続できます。 CData ADO.NET Provider for Exchange を使って、Visual Studio 上でWindows Forms およびWeb Forms とMicrosoft Exchange をデータバインドできます。この記事で、Microsoft Exchange を、ウィザードから変更をリアルタイムで反映するチャートにデータバインドする方法を説明します。 Code Walk-through セクションではチャートはほんの10行のコードで作成します。

チャートへのデータバインド

データバインドは３つのステップから構成されます。コントロールのインスタンス作成、データソースの設定、最後にデータバインドです。

接続を設定してデータベースオブジェクトを選択

下の手続きにより、データソース構成ウィザードを使ってチャートコントロールとMicrosoft Exchange との接続を作成します。ウィザード上でデータバインドをするMicrosoft Exchange エンティティを使います。

1. Windows Forms プロジェクトでは、チャートコントロールをツールボックスからフォーム上にドラグ＆ドロップします。チャートプロパティのデータセクションで DataSource を選択し、メニューからプロジェクトデータソースの追加を選択します。
2. 出てくるデータソース構成ウィザードでデータベース -> データセットを選択します。
3. データ接続ステップで、「新しい接続」をクリックします。

4. データ接続の選択ダイアログで、「変更」をクリックして、CData Microsoft Exchange のデータソースを選択して、接続プロパティを入力します。下は代表的な接続文字列ですです。:

   User='myUser@mydomain.onmicrosoft.com';Password='myPassword';Server='https://outlook.office365.com/EWS/Exchange.asmx';Platform='Exchange_Online';

   Microsoft Exchange への接続

   Exchange への接続には2つのスキーマがあります。

   • Microsoft Graph
   • Exchange Web Services（EWS）（非推奨）
     Note：Microsoft は、Exchange Online ユーザーに対してMicrosoft Graph への切り替えを推奨しています。

   Microsoft Graph とEWS を切り替えるには、Schema をMSGraph またはEWS（非推奨）に設定します。

   Microsoft Exchange OnPremises への認証

   Microsoft Exchange OnPremises は、Basic（デフォルト）、Digest、Negotiate、NTLM 認証をサポートします。

   Basic（デフォルト）

   Microsoft Exchange OnPremises では、Basic がデフォルトの認証として設定されます。 Basic 認証を使用するには、以下のプロパティを設定します。
   • AuthScheme：Basic。
   • User：ユーザーのログインID。
   • Password：ユーザーのログインパスワード。

   他の認証方法については、ヘルプドキュメントの「はじめに」を参照してください。

   Microsoft Exchange Online への認証

   Microsoft Exchange Online は、複数のOAuth ベースの認証をサポートしています。 Microsoft Graph を介してExchange Online に接続する場合は、Schema をMSGraph に設定します。

   認証方法の詳細は、ヘルプドキュメントの「はじめに」を参照してください。


5. 使用するデータソースオブジェクトを選択します。例は Contacts テーブルです。

DataBind

データソースの追加とデータベースオブジェクトを選択したら、チャートにオブジェクトをバインドします。この例では、X軸に GivenName をY軸に Size を設定します。

1. チャートプロパティで、Series プロパティをクリックし、Series コレクション エディター を開きます。
2. Series プロパティでX軸、Y軸に設定するカラムを選択します：XValueMember および YValueMember プロパティにメニューからカラムを選びます。

チャートはこれでMicrosoft Exchange にデータバインドされました。チャートを実行して最新のデータを表示させましょう。

コード Walk-through

Microsoft Exchange へのデータバインドはほんの数行のコードのみが必要で、３つの簡単なステップで完了できます。

1. Microsoft Exchange に接続します。
2. ExchangeDataAdapter を作成して、クエリを作成し、結果を入れるデータセットを作成します。
3. 結果セットとチャートをデータバインドします。

下に完全なコードを示します:

ExchangeConnection conn = new ExchangeConnection("User='myUser@mydomain.onmicrosoft.com';Password='myPassword';Server='https://outlook.office365.com/EWS/Exchange.asmx';Platform='Exchange_Online';");
ExchangeCommand comm = new ExchangeCommand("SELECT GivenName, Size FROM Contacts", conn);
ExchangeDataAdapter da = new ExchangeDataAdapter(comm);
DataSet dataset = new DataSet();
da.Fill(dataset);

chart1.DataSource = dataset;
chart1.Series[0].XValueMember = "GivenName";
chart1.Series[0].YValueMembers = "Size";
// Insert code for additional chart formatting here.
chart1.DataBind();