PipelineComponent.BufferManager プロパティ

定義

重要

この API は CLS 準拠ではありません。

パイプラインコンポーネントの IDTSBufferManager100 を手に入れます。

public:
 property Microsoft::SqlServer::Dts::Pipeline::Wrapper::IDTSBufferManager100 ^ BufferManager { Microsoft::SqlServer::Dts::Pipeline::Wrapper::IDTSBufferManager100 ^ get(); };
[System.CLSCompliant(false)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.IDTSBufferManager100 BufferManager { get; }
[<System.CLSCompliant(false)>]
member this.BufferManager : Microsoft.SqlServer.Dts.Pipeline.Wrapper.IDTSBufferManager100
Public ReadOnly Property BufferManager As IDTSBufferManager100

プロパティ値

IDTSBufferManager100 オブジェクトです。

属性

以下のコード例は、 BufferManager プロパティを使って PipelineBuffer 行内の列を位置づける方法を示しています。

using System;  
using Microsoft.SqlServer.Dts.Pipeline;  
using Microsoft.SqlServer.Dts.Pipeline.Wrapper;  
using Microsoft.SqlServer.Dts.Runtime.Wrapper;  

namespace Microsoft.Samples.SqlServer.Dts  
{  
    public class SampleComponent : PipelineComponent  
    {  
        public override void ProcessInput( int InputID, PipelineBuffer buffer )  
        {  
            IDTSInput100 i = ComponentMetaData.InputCollection.GetObjectByID( InputID );  
            foreach( IDTSInputColumn100 col in i.InputColumnCollection)  
            {  
                int colIndex = BufferManager.FindColumnByLineageID(i.Buffer, col.LineageID);  
                BufferColumn bc =buffer.GetColumnInfo(colIndex);  
            }  
        }  
    }  
}  
Imports System   
Imports Microsoft.SqlServer.Dts.Pipeline   
Imports Microsoft.SqlServer.Dts.Pipeline.Wrapper   
Imports Microsoft.SqlServer.Dts.Runtime.Wrapper   
Namespace Microsoft.Samples.SqlServer.Dts   

 Public Class SampleComponent   
 Inherits PipelineComponent   

   Public Overrides Sub ProcessInput(ByVal InputID As Integer, ByVal buffer As PipelineBuffer)   
     Dim i As IDTSInput100 = ComponentMetaData.InputCollection.GetObjectByID(InputID)   
     For Each col As IDTSInputColumn100 In i.InputColumnCollection   
       Dim colIndex As Integer = BufferManager.FindColumnByLineageID(i.Buffer, col.LineageID)   
       Dim bc As BufferColumn = buffer.GetColumnInfo(colIndex)   
     Next   
   End Sub   
 End Class   
End Namespace  

注釈

BufferManagerは読み取り専用の実行時間プロパティで、PreExecuteメソッドのコンポーネントに最初に利用可能となります。

FindColumnByLineageID法は、コンポーネントの列をPipelineBufferのコンポーネントのIDTSInputColumnCollection100またはIDTSOutputColumnCollection100に位置づけるために用いられます。 これは、 PipelineBuffer に含まれる列数がコンポーネントが期待する列数を超える可能性があるためです。

また、BufferManagerIDTSBuffer100CreateBufferCreateFlatBufferの各メソッドを使って新しいCreateVirtualBufferオブジェクトを作成するためにも利用されます。 しかし、これらの手法はマネージドコードからはサポートされておらず、ネイティブのC++コンポーネントを書く場合にのみ使用すべきです。

適用対象