OdbcParameter.Size Egenskap

Definition

Hämtar eller anger den maximala storleken på data i kolumnen.

public:
 virtual property int Size { int get(); void set(int value); };
public:
 property int Size { int get(); void set(int value); };
public override int Size { get; set; }
public int Size { get; set; }
member this.Size : int with get, set
Public Overrides Property Size As Integer
Public Property Size As Integer

Egenskapsvärde

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

Implementeringar

Exempel

I följande exempel skapas en OdbcParameter och en del av dess egenskaper anges.

Public Sub CreateOdbcParameter()
    Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"
    Dim parameter As New OdbcParameter("Description", OdbcType.VarChar)
    parameter.Direction = ParameterDirection.Output
    parameter.Size = myValue.Length
    parameter.Value = myValue
End Sub
public void CreateOdbcParameter()
 {
    string myValue = "12 foot scarf - multiple colors, one previous owner";
    OdbcParameter parameter = new OdbcParameter("Description", OdbcType.VarChar);
    parameter.Direction = ParameterDirection.Output;
    parameter.Size = myValue.Length;
    parameter.Value = myValue;
 }

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 för från den faktiska storleken på den angivna parametern när en parameteriserad instruktion körs.

Egenskaperna DbType, OdbcTypeoch 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 OdbcParameter egenskapsinställningarna. Om till exempel storleken på parametern har härledts Size innehåller inte härledda värden efter instruktionskörningen.

Note

För en OdbcParameter med ett Direction av ParameterDirection.Output, ParameterDirection.InputOutput, eller ParameterDirection.ReturnValue, genereras ett undantag när kommandot körs om storleken på det värde som returneras av datakällan överskrider angivet Size för OdbcParameter.

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.

Gäller för

Se även