Funzione Partition

Aggiornamento: novembre 2007

Restituisce una stringa che rappresenta l'intervallo calcolato contenente un numero.

Public Function Partition( _
   ByVal Number As Long, _ 
   ByVal Start As Long, _ 
   ByVal Stop As Long, _ 
   ByVal Interval As Long _
) As String

Parametri

• Number
  Obbligatorio. Long. Numero intero da individuare in uno degli intervalli calcolati.

• Start
  Obbligatorio. Long. Numero intero che indica l'inizio dell'insieme di intervalli calcolati. Start non può essere inferiore a 0.

• Stop
  Obbligatorio. Long. Numero intero che indica la fine dell'insieme di intervalli calcolati. Stop non può essere inferiore o uguale a Start.

• Interval
  Obbligatorio. Long. Numero intero che indica la dimensione di ogni intervallo calcolato tra Start e Stop. Interval non può essere inferiore a 1.

Eccezioni

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

La funzione Partition calcola un insieme di intervalli numerici, ognuno dei quali contiene il numero di valori specificato in Interval. Il primo intervallo inizia con il valore di Start e l'ultimo termina con il valore di Stop. La funzione Partition identifica quindi l'intervallo in cui si colloca Number e restituisce una stringa che descrive tale intervallo. L'intervallo è rappresentato nella stringa come "valoreminimo:valoremassimo", dove il valore minimo dell'intervallo (valoreminimo) è separato dal valore massimo (valoremassimo) con i due punti (:).

Se necessario, la funzione Partition inserisce spazi iniziali prima di valoreminimo e valoremassimo, in modo che abbiano il medesimo numero di caratteri della rappresentazione di stringa del valore (Stop + 1). In tal modo si ottiene che, quando l'output della funzione Partition viene utilizzato con più valori di Number, il testo risultante verrà gestito in modo appropriato in qualsiasi operazione di ordinamento successiva.

Nella tabella seguente vengono illustrate alcune stringhe di esempio degli intervalli calcolati utilizzando tre insiemi di argomenti Start, Stop e Interval. Nelle colonne "Primo intervallo" e "Ultimo intervallo" vengono indicati gli intervalli minimi e massimi possibili in base ai valori di Start e Stop. Nelle colonne "Prima del primo intervallo" e "Dopo l'ultimo intervallo" sono indicate le stringhe restituite per i valori di Number rispettivamente minori di Start e maggiori di Stop.

Nella terza riga della tabella viene indicato il risultato nel caso in cui i valori di Start e Stop definiscano un insieme di numeri non esattamente divisibile per il valore di Interval. L'ultimo intervallo, composto di soli 11 numeri, termina con il valore di Stop, anche se il valore di Interval è 20.

Se Interval è 1, l'intervallo sarà "Number:Number", indipendentemente dagli argomenti Start e Stop. Se, ad esempio, Number è 267, Stop è 1000 e Interval è 1, Partition restituirà "267: 267".

Partition può essere utile quando si creano query del database. È possibile creare una query SELECT per visualizzare gli ordini in intervalli diversi rispetto al numero d'ordine, ad esempio ordini da 1 a 1000, da 1001 a 2000 e così via.

Esempio

Nell'esempio riportato di seguito viene impostata una serie di intervalli per le decadi comprese tra il 1950 e il 2049. Il valore di year viene individuato all'interno dell'intervallo appropriato e viene restituito un valore String che indica l'intervallo. Se il valore di year è ad esempio 1984, Partition restituirà "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 & ".")

Requisiti

Spazio dei nomi:Microsoft.VisualBasic

**Modulo:**Interaction

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Vedere anche

Riferimenti

Membri delle librerie di runtime di Visual Basic

Modulo Interaction (Visual Basic)