PipelineBuffer.DirectErrorRow Método
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.
Envia uma linha PipelineBuffer a um IDTSOutput100 cuja propriedade IsErrorOut é true
.
Sobrecargas
DirectErrorRow(Int32, Int32, Int32) |
Envia uma PipelineBuffer linha para uma IDTSOutput100 propriedade cuja IsErrorOut propriedade é verdadeira. |
DirectErrorRow(Int32, Int32, Int32, Int32) |
Envia uma PipelineBuffer linha para uma IDTSOutput100 propriedade cuja IsErrorOut propriedade é verdadeira. |
DirectErrorRow(Int32, Int32, Int32)
Envia uma PipelineBuffer linha para uma IDTSOutput100 propriedade cuja IsErrorOut propriedade é verdadeira.
public:
void DirectErrorRow(int outputID, int errorCode, int errorColumn);
public void DirectErrorRow (int outputID, int errorCode, int errorColumn);
member this.DirectErrorRow : int * int * int -> unit
Public Sub DirectErrorRow (outputID As Integer, errorCode As Integer, errorColumn As Integer)
Parâmetros
- outputID
- Int32
A ID do erro IDTSOutput100 para enviar a linha PipelineBuffer.
- errorCode
- Int32
O número do erro que ocorreu durante o processamento da linha.
- errorColumn
- Int32
A ID da coluna PipelineBuffer que causou o erro.
Exemplos
O exemplo de código a seguir demonstra como direcionar uma linha em um buffer para uma saída de erro síncrona usando o DirectErrorRow método.
public override void ProcessInput(int inputID, PipelineBuffer buffer)
{
IDTSInput100 input = ComponentMetaData.InputCollection.GetObjectByID(inputID);
/// This code sample assumes the component has 2 outputs, one the default,
/// the other the error output. If the errorOutputIndex returned from GetErrorOutputInfo
/// is 0, then the default output is the second output in the collection.
int defaultOutputID = -1;
int errorOutputID = -1;
int errorOutputIndex = -1;
GetErrorOutputInfo(ref errorOutputID,ref errorOutputIndex);
if (errorOutputIndex == 0)
defaultOutputID = ComponentMetaData.OutputCollection[1].ID;
else
defaultOutputID = ComponentMetaData.OutputCollection[0].ID;
while (buffer.NextRow())
{
try
{
/// TODO: Implement code to process the columns in the buffer row.
/// Ideally, your code should detect potential exceptions prior to them occurring, rather
/// than having a generic try/catch block such as this.
/// However, since the error or truncation implementation is specific to each component
/// this sample focuses on actually directing the row, and not a single error or truncation.
/// Unless an exception occurs, direct the row to the default
buffer.DirectRow(defaultOutputID);
}
catch
{
/// Yes. Has the user specified to redirect the row?
if (input.ErrorRowDisposition == DTSRowDisposition.RD_RedirectRow)
{
/// Yes, direct the row to the error output.
/// TODO: Add code to include the errorColumnID
buffer.DirectErrorRow(errorOutputID, 0, errorColumnID);
}
else if (input.ErrorRowDisposition == DTSRowDisposition.RD_FailComponent || input.ErrorRowDisposition == DTSRowDisposition.RD_NotUsed)
{
/// No, the user specified to fail the component, or the error row disposition was not set.
throw new Exception("An error occurred, and the DTSRowDisposition is either not set, or is set to fail component.");
}
else
{
/// No, the user specified to ignore the failure so
/// direct the row to the default output.
buffer.DirectRow(defaultOutputID);
}
}
}
}
Public Overrides Sub ProcessInput(ByVal inputID As Integer, ByVal buffer As PipelineBuffer)
Dim input As IDTSInput100 = ComponentMetaData.InputCollection.GetObjectByID(inputID)
Dim defaultOutputID As Integer = -1
Dim errorOutputID As Integer = -1
Dim errorOutputIndex As Integer = -1
GetErrorOutputInfo(errorOutputID, errorOutputIndex)
If errorOutputIndex = 0 Then
defaultOutputID = ComponentMetaData.OutputCollection(1).ID
Else
defaultOutputID = ComponentMetaData.OutputCollection(0).ID
End If
While buffer.NextRow
Try
buffer.DirectRow(defaultOutputID)
Catch
If input.ErrorRowDisposition = DTSRowDisposition.RD_RedirectRow Then
buffer.DirectErrorRow(errorOutputID, 0, errorColumnID)
Else
If input.ErrorRowDisposition = DTSRowDisposition.RD_FailComponent OrElse input.ErrorRowDisposition = DTSRowDisposition.RD_NotUsed Then
Throw New Exception("An error occurred, and the DTSRowDisposition is either not set, or is set to fail component.")
Else
buffer.DirectRow(defaultOutputID)
End If
End If
End Try
End While
End Sub
Comentários
Esse método é usado por componentes de fluxo de dados que têm IDTSOutput100 objetos com a IsErrorOut propriedade definida como true
. Ele é chamado pelo componente quando encontra um erro ao processar uma linha de buffer e quando RD_RedirectRow é especificado na entrada, saída ou coluna.
Aplica-se a
DirectErrorRow(Int32, Int32, Int32, Int32)
Envia uma PipelineBuffer linha para uma IDTSOutput100 propriedade cuja IsErrorOut propriedade é verdadeira.
public:
void DirectErrorRow(int row, int outputID, int errorCode, int errorColumn);
public void DirectErrorRow (int row, int outputID, int errorCode, int errorColumn);
member this.DirectErrorRow : int * int * int * int -> unit
Public Sub DirectErrorRow (row As Integer, outputID As Integer, errorCode As Integer, errorColumn As Integer)
Parâmetros
- row
- Int32
O índice da linha a ser direcionada à saída de erro.
- outputID
- Int32
A ID do erro IDTSOutput100 para enviar a linha PipelineBuffer.
- errorCode
- Int32
O número do erro que ocorreu durante o processamento da linha.
- errorColumn
- Int32
A ID da coluna PipelineBuffer que causou o erro.
Comentários
Um componente de fluxo de dados chama esse método se o componente de fluxo de dados tiver IDTSOutput100 objetos cujas respectivas IsErrorOut propriedades estão definidas como true
. O componente chama esse método quando o componente encontra um erro ao processar uma linha de buffer e quando RD_RedirectRow é especificado na entrada, saída ou coluna.