Interaction.Partition(Int64, Int64, Int64, Int64) Methode

Definition

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Quelle:

Interaction.vb

Gibt eine Zeichenfolge zurück, die den berechneten Bereich darstellt, der eine Zahl enthält.

public:
 static System::String ^ Partition(long Number, long Start, long Stop, long Interval);

public static string Partition (long Number, long Start, long Stop, long Interval);

static member Partition : int64 * int64 * int64 * int64 -> string

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

Parameter

Number

Int64

Erforderlich. Long. Ganze Zahl, die Sie in einem der berechneten Bereiche suchen möchten.

Start

Int64

Erforderlich. Long. Ganze Zahl, die den Anfang der Reihe berechneter Bereiche angibt. Start darf nicht kleiner als 0 sein.

Stop

Int64

Erforderlich. Long. Ganze Zahl, die das Ende der Reihe berechneter Bereiche angibt. Stop darf nicht kleiner oder gleich Start sein.

Interval

Int64

Erforderlich. Long. Ganze Zahl, die die Größe jedes berechneten Bereichs zwischen Start und Stop angibt. Interval darf nicht kleiner als 1 sein.

Gibt zurück

String

Eine Zeichenfolge, die den berechneten Bereich darstellt, der eine Zahl enthält.

Ausnahmen

ArgumentException

Start< 0, Stop<= Startoder Interval< 1.

Beispiele

Im folgenden Beispiel wird eine Reihe von Bereichen für Jahrzehnte von 1950 bis 2049 eingerichtet. Er sucht den Wert von year innerhalb des entsprechenden Bereichs und gibt einen String Wert zurück, der den Bereich anzeigt. Wenn year beispielsweise der Wert 1984 aufweist, Partition wird "1980:1989" zurückgegeben.

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 & ".")

Hinweise

Die Partition Funktion berechnet eine Reihe von numerischen Bereichen, die jeweils die Anzahl von Werten enthalten, die durch angegeben werden Interval. Der erste Bereich beginnt bei Start, und der letzte Bereich endet bei Stop. Die Partition Funktion identifiziert dann, welcher Bereich enthält Number , und gibt eine Zeichenfolge zurück, die diesen Bereich beschreibt. Der Bereich wird in der Zeichenfolge als "lowervalue:uppervalue" dargestellt, wobei das untere Ende des Bereichs (unterwert) vom oberen Ende (Oberwert) durch einen Doppelpunkt (:)) getrennt wird.

Bei Bedarf fügt die Partition Funktion führende Leerzeichen vor unterwert und oberwert ein, sodass beide die gleiche Anzahl von Zeichen wie die Zeichenfolgendarstellung des Werts (Stop + 1) aufweisen. Dadurch wird sichergestellt, dass der resultierende Text während eines Partition nachfolgenden Sortiervorgangs ordnungsgemäß behandelt wird, wenn Sie die Ausgabe der Funktion mit mehreren Werten von Numberverwenden.

Die folgende Tabelle zeigt einige Beispielzeichenfolgen für Bereiche, die mit drei Sätzen von Start, Stopund Intervalberechnet werden. Die Spalten "Erster Bereich" und "Letzter Bereich" zeigen die niedrigsten und höchsten Bereiche an, die angesichts der Werte von Start und Stopmöglich sind. Die "vor dem ersten Bereich" und "nach den letzten Bereich" wird durch Spalten enthalten, die Zeichenfolgen, die für Werte der zurückgegebenen Number kleiner als Start und größer als Stopbzw.

Start	Stop	Interval	Vor dem ersten Bereich	Erster Bereich	Letzter Bereich	Nach dem letzten 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: "

In der vorherigen Tabelle zeigt die dritte Zeile das Ergebnis an, wenn Start und Stop eine Gruppe von Zahlen definiert wird, die nicht gleichmäßig durch Intervaldividiert werden können. Der letzte Bereich endet bei Stop, sodass er nur 11 Zahlen lang ist, obwohl Interval es 20 ist.

Wenn Interval 1 ist, ist der Bereich "Number:Number", unabhängig von den Start Argumenten und Stop . Wenn beispielsweise Number 267, Stop 1000 und Interval 1 ist, Partition gibt " 267: 267" zurück.

Partition kann beim Erstellen von Datenbankabfragen nützlich sein. Sie können eine SELECT-Abfrage erstellen, die angibt, wie viele Bestellungen in verschiedenen Wertbereichen auftreten, z. B. mit Rechnungswerten von 1 bis 1000, 1001 bis 2000 usw.