IDTSOutput100.ExclusionGroup Propriété

Définition

Espace de noms:

Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2014

Assembly:

Microsoft.SqlServer.DTSPipelineWrap.dll

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

Valeur de propriété

Int32

ExclusionGroup de l’objet IDTSOutput100 .

Attributs

DispIdAttribute

Exemples

L’exemple de code suivant montre comment la propriété ExclusionGroup est utilisée lorsqu’un composant de flux de données a deux sorties dans le même groupe d’exclusions et la même entrée synchrone.

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  

Remarques

La propriété ExclusionGroup est définie lorsque deux sorties sont synchrones sur le même IDTSInput100 objet et que vous souhaitez diriger des lignes exclusivement vers une sortie ou vers l’autre. Les deux sorties doivent avoir la même valeur pour leurs SynchronousInputID propriétés et pour leurs propriétés ExclusionGroup. Vous devez définir cette propriété sur une valeur différente de zéro si vous souhaitez utiliser un groupe d’exclusions ; sinon, conservez la valeur par défaut de zéro.

Pendant l’exécution, les composants de flux de données qui ont plusieurs sorties avec la même entrée synchrone et les mêmes lignes directes du groupe d’exclusions différent de zéro de l’entrée PipelineBuffer vers l’une des sorties à l’aide de la méthode, ou, lorsque la propriété a la DirectRowIsErrorOutvaleur true, la DirectErrorRow méthode.