SqlConnectionStringBuilder.PoolBlockingPeriod プロパティ

定義

名前空間:

Microsoft.Data.SqlClient

アセンブリ:

Microsoft.Data.SqlClient.dll

パッケージ:

Microsoft.Data.SqlClient v5.2.0

接続プールのブロック期間の動作。

public:
 property Microsoft::Data::SqlClient::PoolBlockingPeriod PoolBlockingPeriod { Microsoft::Data::SqlClient::PoolBlockingPeriod get(); void set(Microsoft::Data::SqlClient::PoolBlockingPeriod value); };

public Microsoft.Data.SqlClient.PoolBlockingPeriod PoolBlockingPeriod { get; set; }

member this.PoolBlockingPeriod : Microsoft.Data.SqlClient.PoolBlockingPeriod with get, set

Public Property PoolBlockingPeriod As PoolBlockingPeriod

プロパティ値

PoolBlockingPeriod

使用可能なブロック期間の設定。

注釈

このプロパティは、接続文字列内の "プール ブロック期間" キーに対応します。

接続プールが有効になっており、タイムアウト エラーまたはその他のログイン エラーが発生すると、例外がスローされ、後続の接続試行は次の 5 秒間 、"ブロック期間" に失敗します。 ブロック期間内にアプリケーションが接続を試みると、最初の例外が再度スローされます。 ブロック期間が終了した後の後続の障害により、前のブロック期間の 2 倍の長さ (最大 1 分) の新しいブロック期間が発生します。

Azure SQL データベースに接続しようとすると、一時的なエラーで失敗する可能性があります。通常は数秒以内に復旧されます。 ただし、接続プールのブロック期間の動作では、データベースが使用可能であっても、長期間データベースに到達できない場合があります。 これは、高速にレンダリングする必要があるアプリでは特に問題です。 PoolBlockingPeriod を使用すると、アプリに最適なブロック期間を選択できます。 使用可能な設定については、 PoolBlockingPeriod 列挙を参照してください。