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

Devoluções

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

Exceções

Exemplos

O exemplo seguinte estabelece uma série de campos de tiro ao longo de décadas, de 1950 a 2049. Localiza o valor de year dentro do intervalo apropriado e devolve um String valor que mostra o intervalo. Se year tem um valor de 1984, por exemplo, Partition devolve "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 & ".")

Observações

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 Start, e o último intervalo termina em Stop. A Partition função identifica então qual o intervalo que contém Number e devolve uma cadeia que descreve esse intervalo. O intervalo é representado na cadeia como "valor inferior:valor superior", onde o extremo inferior do intervalo (valor inferior) é separado do extremo superior (valor superior) por dois pontos (:)).

Se necessário, a Partition função insere espaços à esquerda antes do valor inferior e do valor superior , de modo que ambos tenham o mesmo número de caracteres que a representação da cadeia do valor (Stop + 1). Isto garante que, se 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 ordenação subsequente.

A tabela seguinte mostra algumas cadeias de exemplo para intervalos calculados usando três conjuntos de Start, Stop, e Interval. As colunas "Primeiro intervalo" e "Último intervalo" mostram os intervalos mais baixos e mais altos possíveis dados os valores de Start e Stop. As colunas "Antes do primeiro intervalo" e "Depois do último intervalo" mostram as cadeias devolvidas para valores menores Number e Start maiores que Stop, respetivamente.

Na tabela anterior, a terceira linha mostra o resultado quando Start e Stop definem um conjunto de números que não pode ser dividido igualmente por Interval. O último intervalo termina em Stop, ficando apenas com 11 números, embora Interval seja 20.

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

Partition pode ser útil na construção de consultas a bases de dados. Pode criar uma consulta SELECT que mostre quantas encomendas ocorrem dentro de vários intervalos de valor, por exemplo, com valores de faturas de 1 a 1000, 1001 a 2000, e assim sucessivamente.