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、 Stop<= Start或 Interval< 1。

範例

下列範例會設定數十年從 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 式會在 lowervalue 和 uppervalue 之前插入前置空格，讓兩者具有與值字串表示相同的字元數， (Stop + 1) 。 這可確保如果您使用函式的 Partition 輸出搭配數個 值 Number，則產生的文字會在任何後續的排序作業期間正確處理。

下表顯示使用三組 Start、 Stop和 Interval計算的範圍範例字串。 [第一個範圍] 和 [最後一個範圍] 數據行會根據 和 Stop的值Start，顯示可能的最低和最高範圍。 “Before first range” 和 “After last range” 數據行分別顯示針對小於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: "

在上表中，第三行會在 和 Stop 定義一組無法平均除以 Interval的數字時Start顯示結果。 最後一個範圍會結束於 Stop，使其只有11個數位長，即使 Interval 是20。

如果 Interval 為 1，則不論 和 Stop 自變數為何Start，範圍都是 “Number：Number”。 例如，如果 Number 是 267，Stop則為 1000，而為 1，Partition則Interval傳回 “267： 267”。

Partition 建構資料庫查詢時可能很有用。 您可以建立 SELECT 查詢，以顯示各種值範圍內有多少訂單，例如發票值從 1 到 1000、1001 到 2000 等等。