DbParameter.Size Egenskap

public:
 abstract property int Size { int get(); void set(int value); };

public abstract int Size { get; set; }

member this.Size : int with get, set

Public MustOverride Property Size As Integer

Egenskapsvärde

Den maximala storleken, i byte, på data i kolumnen. Standardvärdet härleds från parametervärdet.

Implementeringar

Kommentarer

Egenskapen Size används för binär- och strängtyper.

För icke-strängdatatyper och ANSI-strängdata Size refererar egenskapen till antalet byte. För Unicode-strängdata Size refererar till antalet tecken. Antalet för strängar inkluderar inte avslutande tecken.

För datatyper med Size variabel längd beskriver den maximala mängden data som ska överföras till servern. För ett Unicode-strängvärde Size kan till exempel användas för att begränsa mängden data som skickas till servern till de första hundra tecknen.

För dubbelriktade parametrar och utdataparametrar och returvärden måste du ange värdet Sizeför . Detta krävs inte för indataparametrar, och om det inte uttryckligen anges härleds värdet från den faktiska storleken på den angivna parametern när en parameteriserad instruktion körs.

Egenskaperna DbType och Size för en parameter kan härledas genom att ange Value. Därför behöver du inte ange dem. De exponeras dock inte i DbParameter egenskapsinställningarna. Om till exempel storleken på parametern har härledts Size innehåller inte härledda värden efter instruktionskörningen.

För datatyper med fast längd ignoreras värdet Size för. Den kan hämtas i informationssyfte och returnerar den maximala mängden byte som providern använder när värdet för parametern överförs till servern.

Om storleken på det angivna värdet för en DbParameter överskrider det angivna SizeValue , kommer värdet DbParameter att innehålla det angivna värdet, trunkerat till storleken på DbParameter.

För parametrar av typen DbType.String, är värdet Size för längden i Unicode-tecken. För parametrar av typen DbType.Xml, Size ignoreras.

Se även

• översikt över ADO.NET