Skip to content

Latest commit

 

History

History
43 lines (35 loc) · 2.9 KB

File metadata and controls

43 lines (35 loc) · 2.9 KB
title Size Property (ADO Parameter) | Microsoft Docs
ms.prod sql
ms.prod_service connectivity
ms.technology connectivity
ms.custom
ms.date 01/19/2017
ms.reviewer
ms.topic conceptual
apitype COM
f1_keywords
_Parameter::Size
helpviewer_keywords
Size property [ADO Parameter]
ms.assetid e6bad449-ebdb-4dd3-886a-9e6f1e7ee5d2
author MightyPen
ms.author genemi

Size Property (ADO Parameter)

Indicates the maximum size, in bytes or characters, of a Parameter object.

Settings and Return Values

Sets or returns a Long value that indicates the maximum size in bytes or characters of a value in a Parameter object.

Remarks

Use the Size property to determine the maximum size for values written to or read from the Value property of a Parameter object.

If you specify a variable-length data type for a Parameter object (for example, any String type, such as adVarChar), you must set the object's Size property before appending it to the Parameters collection; otherwise, an error occurs.

If you have already appended the Parameter object to the Parameters collection of a Command object and you change its type to a variable-length data type, you must set the Parameter object's Size property before executing the Command object; otherwise, an error occurs.

If you use the Refresh method to obtain parameter information from the provider and it returns one or more variable-length data type Parameter objects, ADO may allocate memory for the parameters based on their maximum potential size, which could cause an error during execution. To prevent an error, you should explicitly set the Size property for these parameters before executing the command.

The Size property is read/write.

Applies To

Parameter Object

See Also

ActiveConnection, CommandText, CommandTimeout, CommandType, Size, and Direction Properties Example (VB)
ActiveConnection, CommandText, CommandTimeout, CommandType, Size, and Direction Properties Example (VC++)
ActiveConnection, CommandText, CommandTimeout, CommandType, Size, and Direction Properties Example (JScript)
Size Property (ADO Stream)