<unmanagedCodeEntityReference>Partition</unmanagedCodeEntityReference>-Funktion

Artikel
09/02/2008

Aktualisiert: November 2007

Gibt eine Zeichenfolge zurück, die den Bereich angibt, in dem eine gesuchte Zahl enthalten ist.

Public Function Partition( _
   ByVal Number As Long, _ 
   ByVal Start As Long, _ 
   ByVal Stop As Long, _ 
   ByVal Interval As Long _
) As String

Parameter

Number
Erforderlich. Long-Datentyp. Eine ganze Zahl, nach der in einer Folge von berechneten Bereichen gesucht werden soll.
Start
Erforderlich. Long-Datentyp. Ganze Zahl, die den Anfang der Reihe berechneter Bereiche angibt. Start kann nicht kleiner sein als 0 (null).
Stop
Erforderlich. Long-Datentyp. Ganze Zahl, die das Ende der Reihe berechneter Bereiche angibt. Stop kann nicht kleiner oder gleich Start sein.
Interval
Erforderlich. Long-Datentyp. Ganze Zahl, welche die Größe aller berechneten Bereiche zwischen Start und Stop angibt. Interval kann nicht kleiner sein als 1.

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentException	5	Start < 0, Stop < = Start oder Interval < 1.

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

Mit der Partition-Funktion wird eine Folge von numerischen Bereichen berechnet, die jeweils so viele Werte enthalten wie mit Interval angegeben. Der erste Bereich beginnt bei Start, und der letzte Bereich endet bei Stop. Die Partition-Funktion ermittelt den Bereich, in dem Number enthalten ist, und gibt eine Zeichenfolge zurück, die diesen Bereich angibt. Der Bereich wird in der Zeichenfolge mit "lowervalue:uppervalue" angegeben, wobei der niedrigste Wert des Bereichs (lowervalue) vom höchsten Wert des Bereichs (uppervalue) durch einen Doppelpunkt (:) getrennt ist.

Falls erforderlich, fügt die Partition-Funktion führende Leerzeichen vor lowervalue und uppervalue ein, damit beide genauso viele Zeichen aufweisen wie die Zeichenfolgendarstellung des Werts (Stop + 1). Auf diese Weise wird sichergestellt, dass bei Verwendung der Ausgabe der Partition-Funktion mit verschiedenen Werten von Number der entsprechende Text bei späteren Sortiervorgängen richtig eingeordnet wird.

Die folgende Tabelle enthält einige Beispielzeichenfolgen für Bereiche, die jeweils drei Mal mit Start, Stop und Interval berechnet wurden. In den Spalten "Erster Bereich" und "Letzter Bereich" sehen Sie den niedrigsten und höchsten möglichen Bereich für die angegebenen Werte von Start und Stop. Die Spalten "Unter erstem Bereich" und "Über letztem Bereich" enthalten die Zeichenfolgen, die für Number-Werte zurückgegeben werden, die unter Start bzw. über Stop liegen.

Start	Stop	Interval	Unter erstem Bereich	Erster Bereich	Letzter Bereich	Über letztem Bereich
0	99	5	" : -1"	" 0: 4"	" 95: 99"	"100: "
20	199	10	" : 19"	" 20: 29"	"190:199"	"200: "
100	1010	20	" : 99"	" 100: 119"	"1000:1010"	"1011: "

Die dritte Zeile der obigen Tabelle zeigt das Ergebnis, wenn Start und Stop Zahlen definieren, die beim Dividieren durch Interval keine ganze Zahl ergeben. Der letzte Bereich endet bei Stop und ist nur 11 Ziffern lang, obwohl Interval 20 vorgibt.

Wenn Interval den Wert 1 hat, wird unabhängig von den Argumenten Start und Stop als Bereich "Number:Number" berechnet. Beispiel: Number hat den Wert 267, Stop den Wert 1000 und Interval den Wert 1. In diesem Fall gibt Partition " 267: 267" zurück.

Partition kann beim Erstellen von Datenbankabfragen hilfreich sein. Sie können eine SELECT-Abfrage erstellen und damit ermitteln, wie viele Bestellungen innerhalb verschiedener Wertebereiche liegen (z. B. Rechnungswerte von 1 bis 1000, 1001 bis 2000 usw.).

Beispiel

Im folgenden Beispiel wird eine Folge von Bereichen für die Dekaden von 1950 bis 2049 berechnet. Der Wert von year wird innerhalb des entsprechenden Bereichs ermittelt, und es wird ein String-Wert zurückgegeben, der den Bereich angibt. Wenn year z. B . den Wert 1984 hat, gibt Partition "1980:1989" zurück.

Dim year As Long = 1984
' Assume the value of year is provided by data or by user input.
Dim decade As String
decade = Partition(year, 1950, 2049, 10)
MsgBox("Year " & CStr(year) & " is in decade " & decade & ".")