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

Definición

Espacio de nombres:

Microsoft.VisualBasic

Ensamblado:

Microsoft.VisualBasic.Core.dll

Source:

Interaction.vb

Devuelve una cadena que representa el intervalo calculado que contiene un 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

Obligatorio. Long. Número entero que se va a buscar en uno de los intervalos calculados.

Start

Int64

Obligatorio. Long. Número entero que indica el inicio del conjunto de intervalos calculados. Start no puede ser menor que 0.

Stop

Int64

Obligatorio. Long. Número entero que indica el final del conjunto de intervalos calculados. Stop no puede ser menor o igual que Start.

Interval

Int64

Obligatorio. Long. Número entero que indica el tamaño de cada intervalo calculado entre Start y Stop. Interval no puede ser menor que 1.

Devoluciones

String

Cadena que representa el intervalo calculado que contiene un número.

Excepciones

ArgumentException

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

Ejemplos

En el ejemplo siguiente se configura una serie de intervalos durante décadas de 1950 a 2049. Busca el valor de year dentro del intervalo adecuado y devuelve un String valor que muestra el intervalo. Si year tiene un valor de 1984, por ejemplo, Partition devuelve "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 & ".")

Comentarios

La Partition función calcula un conjunto de intervalos numéricos, cada uno que contiene el número de valores especificados por Interval. El primer intervalo comienza en Starty el último intervalo termina en Stop. A continuación, la Partition función identifica qué intervalo contiene Number y devuelve una cadena que describe ese intervalo. El intervalo se representa en la cadena como "lowervalue:uppervalue", donde el extremo inferior del intervalo (lowervalue) está separado del extremo alto (uppervalue) por dos puntos (:).

Si es necesario, la Partition función inserta espacios iniciales antes de lowervalue y uppervalue para que ambos tengan el mismo número de caracteres que la representación de cadena del valor (Stop + 1). Esto garantiza que si usa la salida de la Partition función con varios valores de Number, el texto resultante se controlará correctamente durante cualquier operación de ordenación posterior.

En la tabla siguiente se muestran algunas cadenas de ejemplo para los rangos calculados mediante tres conjuntos de Start, Stopy Interval. Las columnas "First range" y "Last range" muestran los intervalos más bajos y más altos posibles según los valores de Start y Stop. Las columnas "Before first range" y "After last range" muestran las cadenas devueltas para los valores de Number menor que Start y mayor que Stop, respectivamente.

Start	Stop	Interval	Antes del primer intervalo	Primer intervalo	Último intervalo	Después del ú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: "

En la tabla anterior, la tercera línea muestra el resultado cuando Start y Stop definen un conjunto de números que no se pueden dividir uniformemente por Interval. El último intervalo termina en Stop, lo que hace que solo tenga 11 números, aunque Interval sea 20.

Si Interval es 1, el intervalo es "Number:Number", independientemente de los Start argumentos y Stop . Por ejemplo, si Number es 267, Stop es 1000 y Interval es 1, Partition devuelve " 267: 267".

Partition puede ser útil al construir consultas de base de datos. Puede crear una consulta SELECT que muestre cuántos pedidos se producen dentro de varios intervalos de valores, por ejemplo, con valores de factura de 1 a 1000, 1001 a 2000, etc.