• Article

RowIndexOutOfRangeException Class

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

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

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

Inheritance Hierarchy

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

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.