Partager via


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

Définition

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

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

Start
Int64

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

Stop
Int64

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

Interval
Int64

Obligatoire. Long. Nombre entier qui indique la taille de chacune des plages calculées entre Start et Stop. Interval ne peut pas être inférieur à 1.

Retours

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

Exceptions

Start< 0, Stop<= Start, ou 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 dans la plage appropriée et retourne une String valeur montrant la plage. Si year a la valeur 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ù l’extrémité inférieure de la plage (lowervalue) est séparée de l’extrémité supérieure (uppervalue) par un signe deux-points (:)).

Si nécessaire, la Partition fonction insère des espaces de début avant lowervalue et uppervalue afin qu’elles aient 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 de Number, le texte résultant sera géré correctement lors de 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 ensembles de Start, Stopet Interval. Les colonnes « Première plage » et « Dernière plage » affichent les plages les plus basses et les plus élevées possibles en fonction des valeurs de Start et Stop. 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 lorsque 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 en fait seulement 11 nombres, même si Interval est 20.

Si Interval est 1, la plage est «Number :Number », quels que soient les Start arguments et Stop . Par exemple, si Number 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 effectuées dans différentes plages de valeurs, par exemple avec des valeurs de facture comprises entre 1 et 1000, 1001 et 2000, etc.

S’applique à