DbConnections の作成
DbProviderFactory およびDbConnection オブジェクトを使用して、汎用コードでGraphQL に接続できます。このセクションでは、 プロジェクトから接続する方法について説明します。
コンフィギュレーションコンテキストへのプロバイダー情報の追加
厳密に型指定されたDbProviderFactory を作成するには、まずコンフィギュレーションコンテキスト(machine.config、app.config、またはweb.config)にCData ADO.NET Provider for GraphQL を登録する必要があります。本製品 インストーラは、machine.config に本製品 を登録することに注意してください。
インストーラーを使用しない場合、例えば、代わりにNuGet パッケージを使用している場合などは、本製品 を手動で登録する必要があります。 コンフィギュレーションコンテキストのSystem.Data セクションにエントリを追加することで登録が可能です。machine.config またはapp.config のSystem.Data セクションを変更できます(app config のSystem.Data は、実行時にmachine.config とマージされます)。以下はコンフィギュレーションエントリの構文とフォーマットです。
<system.data>
<DbProviderFactories>
<add name="CData ADO.NET Provider for GraphQL" invariant="System.Data.CData.GraphQL" description="CData ADO.NET Provider for GraphQL" type="System.Data.CData.GraphQL.GraphQLProviderFactory, System.Data.CData.GraphQL, Version=23.0.0.40, Culture=neutral, PublicKeyToken=f57f3fbecba6b076" />
</DbProviderFactories>
</system.data>
次のコンフィギュレーションファイルの断片は、コンテキスト内の一般的なGraphQL 接続文字列を定義します。
<configuration>
<connectionStrings>
<add name="GraphQL"
providerName="System.Data.CData.GraphQL"
connectionString="AuthScheme=OAuth;OAuthVersion=2.0;CallbackURL=http://localhost:33333;OauthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;OAuthAccessTokenURL=https://mysite.com/login/oauth/access_token;"
/>
</connectionStrings>
</configuration>
DbProviderFactory の作成
DbProviderFactories.GetFactory を呼び出して、DbProviderFactory を作成します。
DbProviderFactory factory = DbProviderFactories.GetFactory("System.Data.CData.GraphQL");
DbProviderFactories はコンフィギュレーションコンテキスト内の不変の名前を参照して、アセンブリとGraphQLProviderFactory クラスを見つけます。
DbProviderFactory およびDbConnection の作成
次のコードは、厳密に型指定されたDbProviderFactory オブジェクトを作成し、それを使ってDbConnection オブジェクトをインスタンス化してGraphQL に接続する方法を示します。
DbProviderFactory factory = DbProviderFactories.GetFactory("System.Data.CData.GraphQL");
using(DbConnection connection = factory.CreateConnection()) {
connection.ConnectionString = "AuthScheme=OAuth;OAuthVersion=2.0;CallbackURL=http://localhost:33333;OauthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;OAuthAccessTokenURL=https://mysite.com/login/oauth/access_token;";
connection.Open();
}
また、アプリケーションのコンフィギュレーションファイルから、接続文字列を読み取ることもできます。ConnectionStringSettingsCollection クラスには、 System.Configuration.dll への参照が必要なことに注意してください。
次のコードは、アプリケーションのコンフィギュレーションファイルで定義された最初のGraphQL 接続文字列を取得します。
ConnectionStringSettingsCollection settings = ConfigurationManager.ConnectionStrings;
if (settings != null) {
foreach (ConnectionStringSettings cs in settings) {
if (cs.ProviderName == "System.Data.CData.GraphQL")
connection = cs.ConnectionString;
break;
}
}