PipelineBuffer.DirectErrorRow Méthode

Définition

Espace de noms:

Microsoft.SqlServer.Dts.Pipeline

Assembly:

Microsoft.SqlServer.PipelineHost.dll

Envoie une ligne PipelineBuffer à un objet IDTSOutput100 dont la propriété IsErrorOut est true.

Surcharges

DirectErrorRow(Int32, Int32, Int32)	Envoie une PipelineBuffer ligne à une IDTSOutput100 propriété dont IsErrorOut la propriété est true.
DirectErrorRow(Int32, Int32, Int32, Int32)	Envoie une PipelineBuffer ligne à une IDTSOutput100 propriété dont IsErrorOut la propriété est true.

DirectErrorRow(Int32, Int32, Int32)

Envoie une PipelineBuffer ligne à une IDTSOutput100 propriété dont IsErrorOut la propriété est true.

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)

Paramètres

outputID

Int32

ID de l'erreur IDTSOutput100 auquel envoyer la ligne PipelineBuffer.

errorCode

Int32

Numéro de l'erreur qui s'est produite pendant le traitement de la ligne.

errorColumn

Int32

ID de la colonne PipelineBuffer qui a provoqué l'erreur.

Exemples

L’exemple de code suivant montre comment diriger une ligne dans une mémoire tampon vers une sortie d’erreur synchrone à l’aide de la DirectErrorRow méthode.

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  

Remarques

Cette méthode est utilisée par les composants de flux de données qui ont IDTSOutput100 des objets avec la IsErrorOut propriété définie sur true. Il est appelé par le composant lorsqu’il rencontre une erreur de traitement d’une ligne de mémoire tampon et lorsqu’il RD_RedirectRow est spécifié sur l’entrée, la sortie ou la colonne.

DirectErrorRow(Int32, Int32, Int32, Int32)

Envoie une PipelineBuffer ligne à une IDTSOutput100 propriété dont IsErrorOut la propriété est true.

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)

Paramètres

row

Int32

Index de la ligne à diriger vers la sortie d'erreur.

outputID

Int32

ID de l'erreur IDTSOutput100 auquel envoyer la ligne PipelineBuffer.

errorCode

Int32

Numéro de l'erreur qui s'est produite pendant le traitement de la ligne.

errorColumn

Int32

ID de la colonne PipelineBuffer qui a provoqué l'erreur.

Remarques

Un composant de flux de données appelle cette méthode si le composant de flux de données a IDTSOutput100 des objets dont les propriétés respectives IsErrorOut sont définies truesur . Le composant appelle cette méthode lorsque le composant rencontre une erreur de traitement d’une ligne de mémoire tampon et quand RD_RedirectRow il est spécifié sur l’entrée, la sortie ou la colonne.