IDTSOutput100.ExclusionGroup Propriedade

Definição

Namespace:

Microsoft.SqlServer.Dts.Pipeline.Wrapper

Assembly:

Microsoft.SqlServer.DTSPipelineWrap.dll

Obtém ou define a propriedade ExclusionGroup de um objeto IDTSOutput100.

public:
 property int ExclusionGroup { int get(); void set(int value); };

[System.Runtime.InteropServices.DispId(101)]
public int ExclusionGroup { [System.Runtime.InteropServices.DispId(101)] get; [System.Runtime.InteropServices.DispId(101)] set; }

[<System.Runtime.InteropServices.DispId(101)>]
[<get: System.Runtime.InteropServices.DispId(101)>]
[<set: System.Runtime.InteropServices.DispId(101)>]
member this.ExclusionGroup : int with get, set

Public Property ExclusionGroup As Integer

Valor da propriedade

Int32

O ExclusionGroup do objeto IDTSOutput100.

Atributos

DispIdAttribute

Exemplos

O exemplo de código a seguir demonstra como a ExclusionGroup propriedade é usada quando um componente de fluxo de dados tem duas saídas no mesmo grupo de exclusão e a mesma entrada síncrona.

public override void ProvideComponentProperties()  
{  
    IDTSInput100 input = ComponentMetaData.InputCollection.New();  
    Input.Name = "DTSSampleInput";  

    IDTSOutput output = ComponentMetaData.OutputCollection.New();  
    output.ExclusionGroup = 1;  
    output.Name = "Output1";  
    output.SynchronousInputID = input.ID;  

    IDTSOutput output = ComponentMetaData.OutputCollection.New();  
    output.ExclusionGroup = 1;  
    output.Name = "Output2";  
    output.SynchronousInputID = input.ID;  
}  
public override void ProcessInput(int inputID, PipelineBuffer buffer)  
{  
    IDTSInput100 input = ComponentMetaData.InputCollection.GetObjectByID(inputID);  

    IDTSOutput100 output1 = ComponentMetaData.OutputCollection[0];  
    IDTSOutput100 output2 = ComponentMetaData.OutputCollection[1];  

    while( buffer.NextRow())  
    {  
        // If criteria is met, direct the buffer row to output1.  
        buffer.DirectRow(output1.ID);  
        // Otherwise, direct the row to output2.  
        buffer.DirectRow(output2.ID);  
    }  
}  

Public  Overrides Sub ProvideComponentProperties()   
 Dim input As IDTSInput100 = ComponentMetaData.InputCollection.New   
 Input.Name = "DTSSampleInput"   
 Dim output As IDTSOutput = ComponentMetaData.OutputCollection.New   
 output.ExclusionGroup = 1   
 output.Name = "Output1"   
 output.SynchronousInputID = input.ID   
 Dim output As IDTSOutput = ComponentMetaData.OutputCollection.New   
 output.ExclusionGroup = 1   
 output.Name = "Output2"   
 output.SynchronousInputID = input.ID   
End Sub   

Public  Overrides Sub ProcessInput(ByVal inputID As Integer, ByVal buffer As PipelineBuffer)   
 Dim input As IDTSInput100 = ComponentMetaData.InputCollection.GetObjectByID(inputID)   
 Dim output1 As IDTSOutput100 = ComponentMetaData.OutputCollection(0)   
 Dim output2 As IDTSOutput100 = ComponentMetaData.OutputCollection(1)   
 While buffer.NextRow   
   buffer.DirectRow(output1.ID)   
   buffer.DirectRow(output2.ID)   
 End While   
End Sub  

Comentários

A ExclusionGroup propriedade é definida quando duas saídas são síncronas para o mesmo IDTSInput100 objeto e você deseja direcionar linhas exclusivamente para uma saída ou para outra. Ambas as saídas devem ter o mesmo valor para suas SynchronousInputID propriedades e para suas ExclusionGroup propriedades. Você deve definir essa propriedade como um valor diferente de zero se quiser usar um grupo de exclusão; caso contrário, deixe o valor padrão de zero.

Durante a execução, os componentes de fluxo de dados que têm várias saídas com a mesma entrada síncrona e as mesmas linhas diretas do grupo de exclusão não zero da entrada PipelineBuffer para uma das saídas usando o DirectRow método ou, quando a IsErrorOut propriedade é true, o DirectErrorRow método.