IDTSOutput100.ExclusionGroup Eigenschaft

Definition

Namespace:

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

Eigenschaftswert

Int32

Die ExclusionGroup des IDTSOutput100 Objekts.

Attribute

DispIdAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ExclusionGroup-Eigenschaft verwendet wird, wenn eine Datenflusskomponente zwei Ausgaben in derselben Ausschlussgruppe und dieselbe synchrone Eingabe aufweist.

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  

Hinweise

Die ExclusionGroup-Eigenschaft wird festgelegt, wenn zwei Ausgaben synchron mit demselben IDTSInput100 Objekt sind und Sie Zeilen ausschließlich auf eine Ausgabe oder auf die andere weiterleiten möchten. Beide Ausgaben müssen denselben Wert für ihre SynchronousInputID Eigenschaften und für ihre ExclusionGroup-Eigenschaften aufweisen. Sie müssen diese Eigenschaft auf einen Nichtzerowert festlegen, wenn Sie eine Ausschlussgruppe verwenden möchten; lassen Sie andernfalls den Standardwert null.

Während der Ausführung werden Datenflusskomponenten, die mehrere Ausgaben mit derselben synchronen Eingabe und derselben nichtzero-Ausschlussgruppe haben, direkte Zeilen aus der Eingabe PipelineBuffer bis zu einer der Ausgaben mithilfe der DirectRow Methode oder, wenn die IsErrorOut Eigenschaft wahr ist, die DirectErrorRow Methode verwendet.