RowIndexOutOfRangeException Class

Article
12/03/2008

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

[SerializableAttribute] 
public class RowIndexOutOfRangeException : ApplicationException

[SerializableAttribute] 
public ref class RowIndexOutOfRangeException : public ApplicationException

/** @attribute SerializableAttribute() */ 
public class RowIndexOutOfRangeException extends ApplicationException

SerializableAttribute 
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.

Inheritance Hierarchy

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

Example

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 Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms