Interaction.Partition(Int64, Int64, Int64, Int64) Metoda

Definice

Obor názvů:

Microsoft.VisualBasic

Sestavení:

Microsoft.VisualBasic.Core.dll

Zdroj:

Interaction.vb

Vrátí řetězec představující počítanou oblast, která obsahuje číslo.

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

Parametry

Number

Int64

Required. Long. Celé číslo, které chcete vyhledat v jedné z počítaných oblastí.

Start

Int64

Required. Long. Celé číslo, které označuje začátek sady počítaných oblastí. Start nesmí být menší než 0.

Stop

Int64

Required. Long. Celé číslo, které označuje konec sady počítaných oblastí. Stop nemůže být menší než nebo rovno Start.

Interval

Int64

Required. Long. Celé číslo, které označuje velikost každého rozsahu vypočítaného mezi Start a Stop. Interval nesmí být menší než 1.

Návraty

String

Řetězec představující počítanou oblast, která obsahuje číslo.

Výjimky

ArgumentException

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

Příklady

Následující příklad nastaví řadu rozsahů po desetiletí od roku 1950 do roku 2049. Vyhledá hodnotu year v příslušné oblasti a vrátí String hodnotu zobrazující oblast. Pokud year má například hodnotu 1984, Partition vrátí "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 & ".")

Poznámky

Funkce Partition vypočítá sadu číselných oblastí, z nichž každá obsahuje počet hodnot určených parametrem Interval. První oblast začíná na Starta poslední rozsah končí na Stop. Funkce Partition pak identifikuje, která oblast obsahuje Number , a vrátí řetězec popisující danou oblast. Oblast je v řetězci reprezentována jako "lowervalue:uppervalue", kde dolní konec rozsahu (nižší hodnota) je oddělen od horního konce (horní hodnota) dvojtečka (:)).

V případě potřeby Partition vloží funkce počáteční mezery před nižší hodnotu a horní hodnotu , aby obě měly stejný počet znaků jako řetězcová reprezentace hodnoty (Stop + 1). Tím zajistíte, že pokud použijete výstup Partition funkce s několika hodnotami Number, výsledný text se zpracuje správně během jakékoli následné operace řazení.

Následující tabulka uvádí některé ukázkové řetězce pro oblasti vypočítané pomocí tří množin , StartStopa Interval. Sloupce "První oblast" a "Poslední oblast" zobrazují nejnižší a nejvyšší možné rozsahy vzhledem k hodnotám Start a Stop. Sloupce "Před prvním rozsahem" a "Po posledním rozsahu" zobrazují řetězce vrácené pro hodnoty Number menší než Start a větší než Stop.

Start	Stop	Interval	Před prvním rozsahem	První oblast	Poslední rozsah	Po posledním rozsahu
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: "

Třetí řádek v předchozí tabulce zobrazuje výsledek, když Start a Stop definuje sadu čísel, která nelze rovnoměrně dělit Interval. Poslední rozsah končí Stopna , takže je pouze 11 čísel dlouhý, i když Interval je 20.

Pokud Interval je 1, oblast je "Number:Number", bez ohledu na argumenty Start a Stop argumenty. Pokud je například Number 267, Stop je 1000 a Interval je 1, Partition vrátí hodnotu 267: 267.

Partition může být užitečné při vytváření databázových dotazů. Můžete vytvořit dotaz SELECT, který ukazuje, kolik objednávek probíhá v různých rozsahech hodnot, například s fakturami od 1 do 1000, 1001 do 2000 atd.