Interaction.Partition(Int64, Int64, Int64, Int64) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ある数値が含まれる計算済み範囲を表す文字列を返します。
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 未満に設定することはできません。
戻り値
ある数値が含まれる計算済み範囲を表す文字列。
例外
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 つのセットを使用して計算された範囲のStart
Stop
サンプル文字列を示しています。 "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
できない数値のセットを定義した場合Start
Stop
の結果を示しています。 最後の範囲は で 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 などです。
適用対象
.NET