IDTSOutput100.ExclusionGroup Propriété

Définition

Espace de noms:

Microsoft.SqlServer.Dts.Pipeline.Wrapper

Assembly:

Microsoft.SqlServer.DTSPipelineWrap.dll

Obtient ou définit la propriété ExclusionGroup d'un objet 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

Valeur de propriété

Int32

Objet ExclusionGroup de l'objet IDTSOutput100.

Attributs

DispIdAttribute

Exemples

L’exemple de code suivant montre comment la ExclusionGroup propriété est utilisée lorsqu’un composant de flux de données contient 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 ExclusionGroup propriété 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 l’autre. Les deux sorties doivent avoir la même valeur pour leurs SynchronousInputID propriétés et pour leurs ExclusionGroup propriétés. Vous devez définir cette propriété sur une valeur non nulle si vous souhaitez utiliser un groupe d’exclusions ; sinon, laissez la valeur par défaut de zéro.

Lors de 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 de groupe d’exclusion non zéro de l’entrée PipelineBuffer vers l’une des sorties à l’aide de la DirectRow méthode, ou, lorsque la propriété est true, la IsErrorOutDirectErrorRow méthode.