Strings.Split(String, String, Int32, CompareMethod) Metodo

Definizione

Restituisce una matrice unidimensionale con indice in base zero che contiene il numero di sottostringhe specificato.Returns a zero-based, one-dimensional array containing a specified number of substrings.

public static string[] Split (string Expression, string Delimiter = " ", int Limit = -1, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
static member Split : string * string * int * Microsoft.VisualBasic.CompareMethod -> string[]
Public Function Split (Expression As String, Optional Delimiter As String = " ", Optional Limit As Integer = -1, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As String()

Parametri

Expression
String

Obbligatorio.Required. Espressione String contenente sottostringhe e delimitatori.String expression containing substrings and delimiters.

Delimiter
String

Opzionale.Optional. Qualsiasi carattere singolo utilizzato per identificare i limiti delle sottostringhe.Any single character used to identify substring limits. Se Delimiter viene omesso, come delimitatore viene utilizzato il carattere spazio (" ").If Delimiter is omitted, the space character (" ") is assumed to be the delimiter.

Limit
Int32

facoltativo.Optional. Numero massimo di sottostringhe in cui suddividere la stringa di input.Maximum number of substrings into which the input string should be split. Il valore predefinito, -1, indica che la stringa di input deve essere suddivisa a ogni occorrenza della stringa Delimiter.The default, -1, indicates that the input string should be split at every occurrence of the Delimiter string.

Compare
CompareMethod

Opzionale.Optional. Valore numerico che indica il tipo di confronto da utilizzare per la valutazione delle sottostringhe.Numeric value indicating the comparison to use when evaluating substrings. Per un elenco dei valori possibili, vedere "Impostazioni".See "Settings" for values.

Restituisce

String[]

MatriceString .String array. Se Expression è una stringa di lunghezza zero (""), Split restituisce una matrice costituita da un solo elemento contenente una stringa di lunghezza zero.If Expression is a zero-length string (""), Split returns a single-element array containing a zero-length string. Se Delimiter è una stringa di lunghezza zero, oppure se non compare mai nella stringa Expression, Split restituisce una matrice con un solo elemento contenente l'intera stringa Expression.If Delimiter is a zero-length string, or if it does not appear anywhere in Expression, Split returns a single-element array containing the entire Expression string.

Esempi

Nell'esempio seguente viene illustrato come suddividere una stringa negli spazi.The following example demonstrates how to split a string at its spaces.

Dim testString As String = "Look at these!"
' Returns an array containing "Look", "at", and "these!".
Dim testArray() As String = Split(testString)

Nell'esempio seguente viene illustrato come suddividere le stringhe con più delimitatori in una riga e filtrare le stringhe vuote.The following example demonstrates how to split strings with multiple delimiters in a row and filter out the empty strings.

Dim testString As String = "apple    pear banana  "
Dim testArray() As String = Split(testString)
' testArray holds {"apple", "", "", "", "pear", "banana", "", ""}
Dim lastNonEmpty As Integer = -1
For i As Integer = 0 To testArray.Length - 1
    If testArray(i) <> "" Then
        lastNonEmpty += 1
        testArray(lastNonEmpty) = testArray(i)
    End If
Next
ReDim Preserve testArray(lastNonEmpty)
' testArray now holds {"apple", "pear", "banana"}

Commenti

Per impostazione predefinita, o quando Limit è uguale a-1, la funzione Split suddivide la stringa di input a ogni occorrenza della stringa del delimitatore e restituisce le sottostringhe in una matrice.By default, or when Limit equals -1, the Split function splits the input string at every occurrence of the delimiter string, and returns the substrings in an array. Quando il parametro Limit è maggiore di zero, la funzione Split suddivide la stringa in corrispondenza della prima occorrenza Limit-1 del delimitatore e restituisce una matrice con le sottostringhe risultanti.When the Limit parameter is greater than zero, the Split function splits the string at the first Limit-1 occurrences of the delimiter, and returns an array with the resulting substrings. Ad esempio, Split("a:b:c", ":") restituisce la matrice {"a", "b", "c"}, mentre Split("a:b:c", ":", 2) restituisce la matrice {"a", "b:c"}.For example, Split("a:b:c", ":") returns the array {"a", "b", "c"}, while Split("a:b:c", ":", 2) returns the array {"a", "b:c"}.

Quando la funzione Split rileva due delimitatori in una riga o un delimitatore all'inizio o alla fine della stringa, li interpreta come circostanti una stringa vuota ("").When the Split function encounters two delimiters in a row, or a delimiter at the beginning or end of the string, it interprets them as surrounding an empty string (""). Ad esempio, Split("xx", "x") restituisce la matrice contenente tre stringhe vuote: una tra l'inizio della stringa e la prima "x", una tra le due stringhe "x" e una tra l'ultima "x" e la fine della stringa.For example, Split("xx", "x") returns the array containing three empty strings: one from between the beginning of the string and the first "x", one from between the two "x" strings, and one from between the last "x" and the end of the string.

Questa tabella illustra in che modo i parametri facoltativi Delimiter, Limit e Compare possono modificare il comportamento della funzione Split.This table demonstrates how the optional Delimiter, Limit, and Compare parameters can change the behavior of the Split function.

Split-chiamataSplit Call Valore restituitoReturn Value
Split("42, 12, 19") {"42," , "12," , "19"}{"42," , "12," , "19"}
Split("42, 12, 19", ", ") {"42", "12", "19"}{"42", "12", "19"}
Split("42, 12, 19", ", ", 2) {"42", "12, 19"}{"42", "12, 19"}
Split("192.168.0.1", ".") {"192", "168", "0", "1"}{"192", "168", "0", "1"}
Split("Alice and Bob", " AND ") {"Alice e Bob"}{"Alice and Bob"}
Split("Alice and Bob", " AND ", ,CompareMethod.Text) {"Alice", "Bob"}{"Alice", "Bob"}
Split("someone@example.com", "@",1) {"someone@example.com"}{"someone@example.com"}
Split("someone@example.com", "@",2) {"someone", "example.com"}{"someone", "example.com"}

L'argomento Compare può includere i valori seguenti.The Compare argument can have the following values.

CostanteConstant DescriptionDescription ValueValue
CompareMethod.Binary Esegue un confronto binarioPerforms a binary comparison 00
CompareMethod.Text Esegue un confronto testualePerforms a textual comparison 11

Si applica a

Vedi anche