Interaction.Partition(Int64, Int64, Int64, Int64) Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

Interaction.vb

Retorna uma cadeia de caracteres que representa o intervalo calculado que contém um número.

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

Parâmetros

Number

Int64

Obrigatórios. Long. Número inteiro que você deseja localizar em um dos intervalos calculados.

Start

Int64

Obrigatórios. Long. Número inteiro que indica o início do conjunto de intervalos calculados. Start não pode ser menor que 0.

Stop

Int64

Obrigatórios. Long. Número inteiro que indica o fim do conjunto de intervalos calculados. Stop não pode ser menor ou igual a Start.

Interval

Int64

Obrigatórios. Long. Número inteiro que indica o tamanho de cada intervalo calculado entre Start e Stop. Interval não pode ser menor que 1.

Retornos

String

Uma cadeia de caracteres que representa o intervalo calculado que contém um número.

Exceções

ArgumentException

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

Exemplos

O exemplo a seguir configura uma série de intervalos por décadas de 1950 a 2049. Ele localiza o valor de year dentro do intervalo apropriado e retorna um String valor mostrando o intervalo. Se year tiver um valor de 1984, por exemplo, Partition retornará "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 & ".")

Comentários

A Partition função calcula um conjunto de intervalos numéricos, cada um contendo o número de valores especificados por Interval. O primeiro intervalo começa em Starte o último intervalo termina em Stop. Em Partition seguida, a função identifica qual intervalo contém Number e retorna uma cadeia de caracteres que descreve esse intervalo. O intervalo é representado na cadeia de caracteres como "lowervalue:uppervalue", em que a extremidade baixa do intervalo (lowervalue) é separada da extremidade alta (uppervalue) por dois-pontos (:).

Se necessário, a Partition função insere espaços à esquerda antes de lowervalue e uppervalue para que ambos tenham o mesmo número de caracteres que a representação de cadeia de caracteres do valor (Stop + 1). Isso garante que, se você usar a saída da Partition função com vários valores de Number, o texto resultante será tratado corretamente durante qualquer operação de classificação subsequente.

A tabela a seguir mostra algumas cadeias de caracteres de exemplo para intervalos calculados usando três conjuntos de Start, Stope Interval. As colunas "Primeiro intervalo" e "Último intervalo" mostram os intervalos mais baixos e mais altos possíveis, considerando os valores de Start e Stop. As colunas "Antes do primeiro intervalo" e "Após o último intervalo" mostram as cadeias de Number caracteres retornadas para valores menores que Start e maiores que Stop, respectivamente.

Start	Stop	Interval	Antes do primeiro intervalo	Primeiro intervalo	Último intervalo	Após o último intervalo
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: "

Na tabela anterior, a terceira linha mostra o resultado quando Start e Stop define um conjunto de números que não podem ser divididos uniformemente por Interval. O último intervalo termina em Stop, tornando-o apenas 11 números longos, mesmo que Interval seja 20.

Se Interval for 1, o intervalo será "Number:Number", independentemente dos Start argumentos e Stop . Por exemplo, se Number for 267, Stop for 1000 e Interval 1, Partition retornará " 267: 267".

Partition pode ser útil ao construir consultas de banco de dados. Você pode criar uma consulta SELECT que mostra quantos pedidos ocorrem em vários intervalos de valores, por exemplo, com valores de fatura de 1 a 1000, 1001 a 2000 e assim por diante.