RowIndexOutOfRangeException Class

Article
04/26/2013

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
	RowIndexOutOfRangeException	Initializes a new instance of the RowIndexOutOfRangeException class.

Top

Properties

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

Top

Methods

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

Top

Events

	Name	Description
	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.

Share via