PipelineBuffer.DirectErrorRow 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
发送一 PipelineBuffer 行给 IDTSOutput100 属性 IsErrorOut 为 true的 。
重载
| 名称 | 说明 |
|---|---|
| DirectErrorRow(Int32, Int32, Int32) |
发送一PipelineBuffer行给属性IsErrorOut为真的。IDTSOutput100 |
| DirectErrorRow(Int32, Int32, Int32, Int32) |
发送一PipelineBuffer行给属性IsErrorOut为真的。IDTSOutput100 |
DirectErrorRow(Int32, Int32, Int32)
发送一PipelineBuffer行给属性IsErrorOut为真的。IDTSOutput100
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)
参数
- outputID
- Int32
发送该行的错误 IDTSOutput100PipelineBuffer ID。
- errorCode
- Int32
处理该行时出现的错误编号。
- errorColumn
- Int32
导致错误的 PipelineBuffer 列的ID。
示例
以下代码示例演示了如何利用该 DirectErrorRow 方法将缓冲区中的行定向同步错误输出。
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
注解
该方法用于具有 IDTSOutput100 属性 IsErrorOut 为 的 true对象的数据流组件。 组件在处理缓冲区行时遇到错误,且 RD_RedirectRow 在输入、输出或列上指定时调用该缓存。
适用于
DirectErrorRow(Int32, Int32, Int32, Int32)
发送一PipelineBuffer行给属性IsErrorOut为真的。IDTSOutput100
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)
参数
- row
- Int32
将要指向错误输出的行索引。
- outputID
- Int32
发送该行的错误 IDTSOutput100PipelineBuffer ID。
- errorCode
- Int32
处理该行时出现的错误编号。
- errorColumn
- Int32
导致错误的 PipelineBuffer 列的ID。
注解
如果数据流组件的对象IsErrorOut属性被设置为 true,则该数据流组件调用IDTSOutput100该方法。 组件在处理缓冲区行时遇到错误,且 RD_RedirectRow 在输入、输出或列上指定时调用此方法。