Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

OleDbParameter.Size Property

Gets or sets the maximum size, in bytes, of the data within the column.

Namespace:  System.Data.OleDb
Assembly:  System.Data (in System.Data.dll)
public override int Size { get; set; }

Property Value

Type: System.Int32
The maximum size, in bytes, of the data within the column. The default value is inferred from the parameter value.

Implements

IDbDataParameter.Size

The Size property is used for binary and string types.

For nonstring data types and ANSI string data, the Size property refers to the number of bytes. For Unicode string data, Size refers to the number of characters. The count for strings does not include the terminating character.

For variable-length data types, Size describes the maximum amount of data to transmit to the server. For example, for a Unicode string value, Size could be used to limit the amount of data sent to the server to the first 100 characters.

For bidirectional and output parameters, and return values, you must set the value of Size. This is not required for input parameters, and if not explicitly set, the value of is inferred from the actual size of the specified parameter when a parameterized statement is executed.

The DbType, OleDbType, and Size properties of a parameter can be inferred by setting Value. Therefore, you are not required to specify them. However, they are not exposed in OleDbParameter property settings. For example, if the size of the parameter has been inferred, Size does not contain the inferred value after statement execution.

For fixed-length data types, the value of Size is ignored. It can be retrieved for informational purposes, and returns the maximum amount of bytes the provider uses when transmitting the value of the parameter to the server.

If the size of the value supplied for an OleDbParameter exceeds the specified Size, the Value of the OleDbParameter contains the specified value, truncated to the size of the OleDbParameter.

The following example creates an OleDbParameter and sets some of its properties.

[Visual Basic]

Public Sub CreateOleDbParameter()
    Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"
    Dim parameter As New OleDbParameter("Description", OleDbType.VarChar)
    parameter.Direction = ParameterDirection.Output
    parameter.Size = myValue.Length
    parameter.Value = myValue
End Sub 'CreateOleDbParameter

[C#]

public void CreateOleDbParameter() 
 {
    string myValue = "12 foot scarf - multiple colors, one previous owner";
    OleDbParameter parameter = new OleDbParameter("Description", OleDbType.VarChar);
    parameter.Direction = ParameterDirection.Output;
    parameter.Size = myValue.Length;
    parameter.Value = myValue;
 }

.NET Framework

Supported in: 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.