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

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

パラメーター

返品

数値を含む計算範囲を表す文字列。

例外

例

次の例では、1950 年から 2049 年までの数十年間の範囲のシリーズを設定します。 適切な範囲内の year の値を検索し、その範囲を示す String 値を返します。 たとえば、 year の値が 1984 の場合、 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" として表され、範囲の下端 (下値) はコロン (:)) で上限 (上値) から区切られます。

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

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

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

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

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