IDTSOutput100.ExclusionGroup Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
O ExclusionGroup do objeto IDTSOutput100.
- Atributos
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.