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

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

Retornos

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

Exceções

Exemplos

O exemplo a seguir configura uma série de intervalos por décadas de 1950 a 2049. Ele localiza o valor de dentro do year 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 especificado por Interval. O primeiro intervalo começa em Start, e 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 (valor inferior) é separada da extremidade alta (valor superior) por dois-pontos (:).

Se necessário, a Partition função insere espaços à esquerda antes do valor inferior e do valor superior 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, Numbero 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 caracteres retornadas para valores Number menores Start e maiores que Stop, respectivamente.

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, embora seja Interval 20.

Se Interval for 1, o intervalo será "Number:Number", independentemente dos Start argumentos e Stop dos argumentos. 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.