OleDbParameter.Size Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die maximale Größe der Daten in der Spalte in Byte ab oder legt diese fest.
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; }[System.Data.DataSysDescription("DbDataParameter_Size")]
public int Size { get; set; }member this.Size : int with get, set[<System.Data.DataSysDescription("DbDataParameter_Size")>]
member this.Size : int with get, setPublic Overrides Property Size As IntegerPublic Property Size As IntegerEigenschaftswert
Die maximale Größe in Byte der Daten in der Spalte. Der Standardwert wird aus dem Parameterwert hergeleitet.
Implementiert
- Attribute
Beispiele
Im folgenden Beispiel wird ein OleDbParameter erstellt und einige seiner Eigenschaften festgelegt.
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
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;
}
Hinweise
Die Size -Eigenschaft wird für Binär- und Zeichenfolgentypen verwendet.
Bei Nichtzeichenfolgendatentypen und ANSI-Zeichenfolgendaten bezieht sich die Size -Eigenschaft auf die Anzahl von Bytes. Bei Unicode-Zeichenfolgendaten Size bezieht sich auf die Anzahl von Zeichen. Die Anzahl für Zeichenfolgen enthält nicht das beendende Zeichen.
Beschreibt für Datentypen mit variabler Länge die maximale Datenmenge, Size die an den Server übertragen werden soll. Beispielsweise kann für einen Unicode-Zeichenfolgenwert verwendet werden, Size um die Menge der an den Server gesendeten Daten auf die ersten 100 Zeichen zu beschränken.
Für bidirektionale Parameter und Ausgabeparameter sowie Rückgabewerte müssen Sie den Wert von Sizefestlegen. Dies ist für Eingabeparameter nicht erforderlich, und wenn nicht explizit festgelegt, wird der Wert von bei der Ausführung einer parametrisierten Anweisung aus der tatsächlichen Größe des angegebenen Parameters abgeleitet.
Die DbTypeEigenschaften , OleDbTypeund Size eines Parameters können durch Festlegen Valuevon abgeleitet werden. Daher müssen Sie sie nicht angeben. Sie werden jedoch nicht in OleDbParameter Eigenschafteneinstellungen verfügbar gemacht. Wenn beispielsweise die Größe des Parameters abgeleitet wurde, Size enthält nicht den abgeleiteten Wert nach der Anweisungsausführung.
Bei Datentypen mit fester Länge wird der Wert von Size ignoriert. Sie kann zu Informationszwecken abgerufen werden und gibt die maximale Bytemenge zurück, die der Anbieter bei der Übertragung des Werts des Parameters an den Server verwendet.
Wenn die Größe des für OleDbParameter einen angegebenen Werts den angegebenen Sizeüberschreitet, enthält die Value des OleDbParameter den angegebenen Wert, der auf die Größe des abgeschnitten wird OleDbParameter.
