This documentation is archived and is not being maintained.

OleDbParameter.Direction Property

Gets or sets a value indicating whether the parameter is input-only, output-only, bidirectional, or a stored procedure return value parameter.

[Visual Basic]
Public Overridable Property Direction As ParameterDirection  _
   Implements IDataParameter.Direction
[C#]
public virtual ParameterDirection Direction {get; set;}
[C++]
public: __property virtual ParameterDirection get_Direction();
public: __property virtual void set_Direction(ParameterDirection);
[JScript]
public function get Direction() : ParameterDirection;
public function set Direction(ParameterDirection);

Property Value

One of the ParameterDirection values. The default is Input.

Implements

IDataParameter.Direction

Exceptions

Exception Type Condition
ArgumentException The property was not set to one of the valid ParameterDirection values.

Remarks

If the ParameterDirection is output, and execution of the associated OleDbCommand does not return a value, the OleDbParameter contains a null value.

Output, InputOut, and ReturnValue parameters returned by calling ExecuteReader cannot be accessed until you call Close or Dispose on the OleDbDataReader.

Example

[Visual Basic, C#, C++] The following example creates an OleDbParameter and sets some of its properties.

[Visual Basic] 
Public Sub CreateOleDbParameter()
    Dim myParameter As New OleDbParameter("Description", OleDbType.VarChar, 88)
    myParameter.Direction = ParameterDirection.Output
End Sub 'CreateOleDbParameter

[C#] 
public void CreateOleDbParameter() 
 {
    OleDbParameter myParameter = new OleDbParameter("Description", OleDbType.VarChar, 88);
    myParameter.Direction = ParameterDirection.Output;
 }

[C++] 
public:
void CreateOleDbParameter() 
 {
    OleDbParameter* myParameter = new OleDbParameter(S"Description", OleDbType::VarChar, 88);
    myParameter->Direction = ParameterDirection::Output;
 }

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

OleDbParameter Class | OleDbParameter Members | System.Data.OleDb Namespace

Show: