Interaction.Partition(Int64, Int64, Int64, Int64) メソッド

定義

名前空間:

Microsoft.VisualBasic

アセンブリ:

Microsoft.VisualBasic.Core.dll

ソース:

Interaction.vb

ある数値が含まれる計算済み範囲を表す文字列を返します。

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

パラメーター

Number

Int64

必須です。 Long. 計算済み範囲のいずれかに存在する整数値です。

Start

Int64

必須です。 Long. 計算済み範囲のセットの最小値を示す整数です。 Start を 0 未満に設定することはできません。

Stop

Int64

必須です。 Long. 計算済み範囲のセットの最大値を示す整数です。 Stop には Start 以下の値を指定できません。

Interval

Int64

必須です。 Long. Start と Stop の間で計算される、各範囲のサイズを示す整数値です。 Interval を 1 未満に設定することはできません。

戻り値

String

ある数値が含まれる計算済み範囲を表す文字列。

例外

ArgumentException

Start<0、= Start、Stop<または Interval< 1。

例

次の例では、1950 年から 2049 年までの数十年間の範囲のシリーズを設定します。 適切な範囲内の の year 値を検索し、その範囲を String 示す値を返します。 値が 1984 の場合 year 、たとえば、 Partition "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 & ".")

注釈

関数は Partition 、 で Interval指定された値の数を含む一連の数値範囲を計算します。 最初の範囲は から Start始まり、最後の範囲は で Stop終わります。 次に、 関数は Partition 、どの範囲が含まれている Number かを識別し、その範囲を記述する文字列を返します。 範囲は文字列内で "lowervalue:uppervalue" として表され、範囲の下端 (lowervalue) はコロン (:)) で上限 (uppervalue) から区切られます。

必要に応じて、関数はPartition、値の文字列表現 (Stop + 1) と同じ文字数になるように、lowervalue と uppervalue の前に先頭のスペースを挿入します。 これにより、 関数の出力を複数の Partition 値で使用すると、その後の Number並べ替え操作中に結果のテキストが適切に処理されます。

次の表は、および Intervalの 3 つのセットを使用して計算された範囲のStartStopサンプル文字列を示しています。 "First range" 列と "Last range" 列には、 と の値を指定すると、可能な限り最も低い範囲とStop最高のStart範囲が表示されます。 "最初の範囲の前" 列と "最後の範囲の後" 列には、 より小さいStart値と よりStop大きい値Numberに対して返される文字列がそれぞれ表示されます。

Start	Stop	Interval	最初の範囲の前	最初の範囲	最後の範囲	最後の範囲の後
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: "

上の表の 3 行目は、 で均等に除算Intervalできない数値のセットを定義した場合StartStopの結果を示しています。 最後の範囲は で Stop終わり、 Interval 20 であっても 11 個の長さになります。

が 1 の場合Interval、引数と Stop 引数に関係なく、範囲は Start "Number:Number" になります。 たとえば、 が 267 で、 Stop が 1000 で、 Interval が 1 の場合Number、 Partition は " 267: 267" を返します。

Partition は、データベース クエリを作成するときに役立ちます。 さまざまな値の範囲内で発生する注文の数を示す SELECT クエリを作成できます。たとえば、請求書の値が 1 から 1000、1001 から 2000 などです。