Interaction.Partition, méthode
Retourne une chaîne représentant la plage calculée qui contient un nombre.
Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)
Syntaxe
'Déclaration
Public Shared Function Partition ( _
Number As Long, _
Start As Long, _
Stop As Long, _
Interval As Long _
) As String
'Utilisation
Dim Number As Long
Dim Start As Long
Dim Stop As Long
Dim Interval As Long
Dim returnValue As String
returnValue = Interaction.Partition(Number, Start, Stop, Interval)
public static string Partition (
long Number,
long Start,
long Stop,
long Interval
)
public:
static String^ Partition (
long long Number,
long long Start,
long long Stop,
long long Interval
)
public static String Partition (
long Number,
long Start,
long Stop,
long Interval
)
public static function Partition (
Number : long,
Start : long,
Stop : long,
Interval : long
) : String
Paramètres
- Number
Obligatoire. Long. Nombre entier que vous souhaitez localiser dans l'une des plages calculées.
- Start
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
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
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.
Valeur de retour
Retourne une chaîne représentant la plage calculée qui contient un nombre.
Notes
Pour plus d'informations, consultez la rubrique Visual Basic Partition, fonction.
La fonction Partition 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 fonction Partition identifie ensuite quelle plage contient Number et retourne une chaîne qui décrit cette plage. La plage est représentée dans la chaîne par "lowervalue:uppervalue", où la valeur la plus basse (lowervalue) de la plage est séparée de la valeur la plus élevée (uppervalue) par un signe deux-points (:).
Au besoin, la fonction Partition insère des espaces à gauche avant lowervalue et uppervalue de sorte que les deux arguments possèdent le même nombre de caractères que la représentation de chaîne de la valeur (Stop + 1). Ainsi, si vous utilisez la sortie de la fonction Partition avec d'autres valeurs de Number, le texte obtenu pourra être correctement géré au cours d'un tri ultérieur éventuel.
Le tableau ci-dessous illustre certains exemples de chaînes pour des plages calculées à partir de trois jeux d'arguments Start, Stop et Interval. Les colonnes "Première plage" et "Dernière plage" illustrent les plus petites et les plus grandes plages possibles attribuées aux valeurs de Start et Stop. Les colonnes "Avant première plage" et "Après dernière plage" indiquent les chaînes retournées pour les valeurs Number avant Start et après Stop, respectivement.
Start |
Stop |
Interval |
Avant première plage |
Première plage |
Dernière plage |
Après 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 ce tableau, la troisième ligne illustre le résultat obtenu lorsque Start et Stop définissent un ensemble de nombres qui ne peuvent pas être divisé de façon égale par Interval. La dernière plage se termine à Stop (11 nombres) même si Interval est égal à 20.
Si Interval est 1, la plage est "Number:Number", indépendamment des arguments Start et Stop. Par exemple, si Number est égal à 267, Stop à 1000 et Interval à 1, Partition retourne "267: 267".
Partition peut être utile lors de la création de requêtes de base de données. Vous pouvez créer une requête de sélection qui indique le nombre de commandes appartenant à diverses plages (par exemple, les commandes dont la valeur de facturation est comprise entre 1 et 1 000, entre 1 001 et 2 000, etc.).
Exemple
L'exemple suivant configure une série de plages pour les décennies de 1950 à 2049. Il localise la valeur de year
dans la plage appropriée et retourne une valeur String qui affiche 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 & ".")
Plates-formes
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
Informations de version
.NET Framework
Prise en charge dans : 2.0, 1.1, 1.0
.NET Compact Framework
Prise en charge dans : 2.0, 1.0
Voir aussi
Référence
Interaction, classe
Membres Interaction
Microsoft.VisualBasic, espace de noms
Structured Query Language (SQL)