Interaction.Partition(Int64, Int64, Int64, Int64) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
, Stop
et 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 Start
Stop
à , 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.