Share via


RowIndexOutOfRangeException Class

The exception that is thrown when an invalid index is supplied when accessing a row in a PipelineBuffer.

Inheritance Hierarchy

System.Object
  System.Exception
    System.ApplicationException
      Microsoft.SqlServer.Dts.Pipeline.RowIndexOutOfRangeException

Namespace:  Microsoft.SqlServer.Dts.Pipeline
Assembly:  Microsoft.SqlServer.PipelineHost (in Microsoft.SqlServer.PipelineHost.dll)

Syntax

'Declaration
<SerializableAttribute> _
Public Class RowIndexOutOfRangeException _
    Inherits ApplicationException
'Usage
Dim instance As RowIndexOutOfRangeException
[SerializableAttribute]
public class RowIndexOutOfRangeException : ApplicationException
[SerializableAttribute]
public ref class RowIndexOutOfRangeException : public ApplicationException
[<SerializableAttribute>]
type RowIndexOutOfRangeException =  
    class 
        inherit ApplicationException 
    end
public class RowIndexOutOfRangeException extends ApplicationException

The RowIndexOutOfRangeException type exposes the following members.

Constructors

  Name Description
Public method RowIndexOutOfRangeException Initializes a new instance of the RowIndexOutOfRangeException class.

Top

Properties

  Name Description
Public property Data (Inherited from Exception.)
Public property HelpLink (Inherited from Exception.)
Public property HResult (Inherited from Exception.)
Public property InnerException (Inherited from Exception.)
Public property Message (Inherited from Exception.)
Public property Source (Inherited from Exception.)
Public property StackTrace (Inherited from Exception.)
Public property TargetSite (Inherited from Exception.)

Top

Methods

  Name Description
Public method Equals (Inherited from Object.)
Protected method Finalize (Inherited from Object.)
Public method GetBaseException (Inherited from Exception.)
Public method GetHashCode (Inherited from Object.)
Public method GetObjectData Security Critical. (Inherited from Exception.)
Public method GetType (Inherited from Exception.)
Protected method MemberwiseClone (Inherited from Object.)
Public method ToString (Inherited from Exception.)

Top

Events

  Name Description
Protected event SerializeObjectState (Inherited from Exception.)

Top

Remarks

This exception is thrown when attempting to access a row in a PipelineBuffer by index and the supplied index is either greater than the number of rows in the buffer or is less than zero.

Accessing the CurrentRow property of the PipelineBuffer object without first calling NextRow will also throw this exception because the CurrentRow property has not been advanced to the first row in the collection.

Examples

The following code example throws a RowIndexOutOfRangeException because NextRow has not been called first.

public override void ProcessInput(int inputID, PipelineBuffer buffer)
{
try
{
//while (buffer.NextRow())
//{
BufferColumn bc = buffer.GetColumnInfo(0);
//}
}
catch (RowIndexOutOfRangeException e )
{
}
}
Public Overloads Overrides Sub ProcessInput(ByVal inputID As Integer, ByVal buffer As PipelineBuffer) 
 Try 
   Dim bc As BufferColumn = buffer.GetColumnInfo(0) 
 Catch e As RowIndexOutOfRangeException 
 End Try 
End Sub

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

Microsoft.SqlServer.Dts.Pipeline Namespace