DtsPipelineComponentAttribute.SupportsBackPressure プロパティ

定義

名前空間:

Microsoft.SqlServer.Dts.Pipeline

アセンブリ:

Microsoft.SqlServer.PipelineHost.dll

コンポーネントが複数の入力をサポートし、複数の入力によってデータが不均一なレートで生成される場合に過度なメモリ消費を処理するためのオプションのメソッドを実装するかどうかを示します。

public:
 property bool SupportsBackPressure { bool get(); void set(bool value); };

public bool SupportsBackPressure { get; set; }

member this.SupportsBackPressure : bool with get, set

Public Property SupportsBackPressure As Boolean

プロパティ値

Boolean

コンポーネントが複数の入力をサポートし、入力が不均等なレートでデータを生成する場合に過剰なメモリ使用量を処理するためのオプションのメソッドを実装する場合は true。それ以外の場合は false。

例

次のコード例では、DtsPipelineComponentAttribute クラスを実装して、SupportsBackPressure プロパティの値を true に設定します。

[DtsPipelineComponent(ComponentType = ComponentType.Transform,  
        DisplayName = "Shuffler",  
        Description = "Shuffle the rows from input.",  
        SupportsBackPressure = true,  
        LocalizationType = typeof(Localized),  
        IconResource = "Microsoft.Samples.SqlServer.Dts.MIBPComponent.ico")  
]  
public class Shuffler : Microsoft.SqlServer.Dts.Pipeline.PipelineComponent  
        {  
          ...  
        }  

注釈

複数の入力をサポートするカスタム データ フロー コンポーネントでより効率的なメモリ管理を実装するための最初の手順は、T:Microsoft.SqlServer.Dts.Pipeline.DtsPipelineComponentAttribute で SupportsBackPressure プロパティの値を true に設定することです。 SupportsBackPressure の値が true の場合、データ フロー エンジンは Microsoft.SqlServer.Dts.Pipeline.PipelineComponent.IsInputReady メソッドを呼び出し、3 つ以上の入力がある場合は、実行時に Microsoft.SqlServer.Dts.Pipeline.PipelineComponent.GetDependentInputs メソッドも呼び出します。

カスタム データ フロー コンポーネントの入力が不均等なレートでデータを生成する場合の過剰なメモリ使用量の処理の詳細については、「複数の入力を含むData Flow コンポーネントの開発」を参照してください。