OracleParameter.Size-Eigenschaft

Ruft die maximale Größe der Daten innerhalb der Spalte in Bytes ab oder legt diese fest.

Namespace: System.Data.OracleClient
Assembly: System.Data.OracleClient (in system.data.oracleclient.dll)

Syntax

'Declaration
Public Overrides Property Size As Integer
'Usage
Dim instance As OracleParameter
Dim value As Integer

value = instance.Size

instance.Size = value

public override int Size { get; set; }

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

/** @property */
public int get_Size ()

/** @property */
public void set_Size (int value)

public override function get Size () : int

public override function set Size (value : int)

Eigenschaftenwert

Die maximale Größe der Daten in der Spalte in Bytes. Der Standardwert ist 0. Er wird verwendet, wenn Sie keine maximale Größe für den Wert angeben möchten.

Hinweise

Das Festlegen von Size hat nur Auswirkungen auf den Eingabewert eines Parameters. Auf Rückgabewerte und Ausgabeparameter hat diese Eigenschaft keine Auswirkungen.

Die Size-Eigenschaft wird für Binär- und Zeichenfolgentypen verwendet.

Bei Datentypen, die keine Zeichenfolgen sind, sowie bei ANSI-Zeichenfolgendaten bezieht sich die Size-Eigenschaft auf die Anzahl der Bytes. Bei Unicode-Zeichenfolgendaten bezieht sich Size auf die Anzahl der Zeichen. Bei der Anzahl der Zeichenfolgen wird das abschließende Zeichen nicht berücksichtigt.

Bei Datentypen mit variabler Länge beschreibt Size die maximale Datenmenge, die an den Server übermittelt wird. Für einen Unicode-Zeichenfolgenwert kann z. B. die Menge der an den Server gesendeten Daten mit Size auf die ersten hundert Zeichen beschränkt werden.

Für bidirektionale Parameter, Ausgabeparameter und Rückgabewerte müssen Sie den Wert von Size festlegen. Dies ist bei Eingabeparametern nicht erforderlich. Wenn dort der Wert nicht explizit festgelegt wird, wird er beim Ausführen einer parametrisierten Anweisung aus der tatsächlichen Größe des angegebenen Parameters hergeleitet.

Die Eigenschaften DbType, OracleType und Size eines Parameters können durch Festlegen von Value per Rückschluss abgeleitet werden. Daher müssen Sie diese nicht angeben. Sie werden allerdings nicht in den OracleParameter-Eigenschafteneinstellungen verfügbar gemacht. Wenn z. B. die Größe des Parameters per Rückschluss abgeleitet wurde, enthält Size nach dem Ausführen der Anweisung keinen abgeleiteten Wert.

Bei Datentypen mit fester Länge wird der Wert von Size ignoriert. Er kann zu Informationszwecken abgerufen werden und gibt die maximale Menge von Bytes zurück, die der Provider beim Übermitteln des Parameterwerts an den Server verwendet.

Beispiel

Im folgenden Beispiel wird ein OracleParameter erstellt, und einige seiner Eigenschaften werden festgelegt.

Public Sub CreateOracleParameter()
   Dim parameter As New OracleParameter("pDescription", OracleType.VarChar)
   parameter.IsNullable = True
   parameter.Direction = ParameterDirection.Output
   parameter.Size = 88
End Sub

public void CreateOracleParameter() 
{
   OracleParameter parameter = new OracleParameter("pDescription", OracleType.VarChar);
   parameter.IsNullable = true;
   parameter.Direction = ParameterDirection.Output;
   parameter.Size = 88;
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1

Siehe auch

Referenz

OracleParameter-Klasse
OracleParameter-Member
System.Data.OracleClient-Namespace