Interaction.Partition(Int64, Int64, Int64, Int64) Méthode

Définition

Espace de noms:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.dll

Retourne une chaîne représentant la plage calculée qui contient un nombre.

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

Paramètres

Number

Int64

Required. Long. Nombre entier que vous souhaitez localiser dans l’une des plages calculées.

Start

Int64

Required. Long. Nombre entier qui indique le début de l’ensemble de plages calculées. Start ne peut pas être inférieur à 0.

Stop

Int64

Required. Long. Nombre entier qui indique la fin de l’ensemble de plages calculées. Stop ne peut pas être inférieur ou égal à Start.

Interval

Int64

Required. Long. Nombre entier qui indique la taille de chaque plage calculée entre Start et Stop. Interval ne peut pas être inférieur à 1.

Retours

String

Chaîne représentant la plage calculée qui contient un nombre.

Exceptions

ArgumentException

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

Exemples

L’exemple suivant configure une série de plages pendant des décennies de 1950 à 2049. Il localise la valeur de year la plage appropriée et retourne une String valeur montrant la plage. Si year la valeur est 1984, par exemple, Partition retourne « 1980:1989 ».

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

Remarques

La Partition fonction calcule un ensemble de plages numériques, chacune contenant le nombre de valeurs spécifiées par Interval. La première plage commence à Start, et la dernière plage se termine à Stop. La Partition fonction identifie ensuite la plage qui contient Number et retourne une chaîne décrivant cette plage. La plage est représentée dans la chaîne sous la forme « lowervalue :uppervalue », où le bas de la plage (valeur inférieure) est séparé de la valeur supérieure (valeur supérieure) par un signe deux-points (:)).

Si nécessaire, la Partition fonction insère des espaces de début avant la valeur inférieure et la valeur supérieure afin qu’elles aient tous les deux le même nombre de caractères que la représentation sous forme de chaîne de la valeur (Stop + 1). Cela garantit que si vous utilisez la sortie de la Partition fonction avec plusieurs valeurs, Numberle texte résultant sera géré correctement pendant toute opération de tri suivante.

Le tableau suivant présente des exemples de chaînes pour les plages calculées à l’aide de trois jeux de Start, Stopet Interval. Les colonnes « Première plage » et « Dernière plage » indiquent les plages les plus basses et les plus élevées possibles en fonction des valeurs et StartStop. Les colonnes « Avant la première plage » et « Après la dernière plage » affichent les chaînes retournées pour les valeurs inférieures Number et supérieures StartStopà , respectivement.

Start	Stop	Interval	Avant la première plage	Première plage	Dernière plage	Après la dernière plage
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: "

Dans le tableau précédent, la troisième ligne affiche le résultat quand Start et Stop définissez un ensemble de nombres qui ne peuvent pas être divisés uniformément par Interval. La dernière plage se termine à Stop, ce qui ne fait que 11 nombres longs, même si Interval c’est 20.

Si Interval la valeur est 1, la plage est «Number :Number », quels que soient les arguments et Stop les Start arguments. Par exemple, si Number la valeur est 267, Stop est 1000 et Interval est 1, Partition retourne « 267 : 267 ».

Partition peut être utile lors de la construction de requêtes de base de données. Vous pouvez créer une requête SELECT qui indique le nombre de commandes qui se produisent dans différentes plages de valeurs, par exemple avec des valeurs de facture comprises entre 1 et 1 000, 1001 et 2000, et ainsi de suite.