Regex.Split Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Delar upp en indatasträng i en matris med delsträngar vid de positioner som definieras av en reguljär uttrycksmatchning.
Överlagringar
| Name | Description |
|---|---|
| Split(String, String, RegexOptions, TimeSpan) |
Delar upp en indatasträng i en matris med delsträngar på de positioner som definieras av ett angivet mönster för reguljära uttryck. Ytterligare parametrar anger alternativ som ändrar matchningsåtgärden och ett tidsgränsintervall om ingen matchning hittas. |
| Split(String, String, RegexOptions) |
Delar upp en indatasträng i en matris med delsträngar på de positioner som definieras av ett angivet mönster för reguljära uttryck. Angivna alternativ ändrar matchningsåtgärden. |
| Split(String, Int32, Int32) |
Delar upp en indatasträng ett angivet maximalt antal gånger i en matris med delsträngar, vid de positioner som definieras av ett reguljärt uttryck som anges i Regex konstruktorn. Sökningen efter mönster för reguljära uttryck börjar vid en angiven teckenposition i indatasträngen. |
| Split(String, String) |
Delar upp en indatasträng i en matris med delsträngar på de positioner som definieras av ett mönster för reguljära uttryck. |
| Split(String) |
Delar upp en indatasträng i en matris med delsträngar på de positioner som definieras av ett mönster för reguljära uttryck som anges i Regex konstruktorn. |
| Split(String, Int32) |
Delar upp en indatasträng ett angivet maximalt antal gånger i en matris med delsträngar, vid de positioner som definieras av ett reguljärt uttryck som anges i Regex konstruktorn. |
Split(String, String, RegexOptions, TimeSpan)
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
Delar upp en indatasträng i en matris med delsträngar på de positioner som definieras av ett angivet mönster för reguljära uttryck. Ytterligare parametrar anger alternativ som ändrar matchningsåtgärden och ett tidsgränsintervall om ingen matchning hittas.
public:
static cli::array <System::String ^> ^ Split(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);public static string[] Split(string input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);static member Split : string * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> string[]Public Shared Function Split (input As String, pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As String()Parametrar
- input
- String
Strängen som ska delas.
- pattern
- String
Det reguljära uttrycksmönster som ska matchas.
- options
- RegexOptions
En bitvis kombination av uppräkningsvärdena som ger alternativ för matchning.
- matchTimeout
- TimeSpan
Ett tidsgränsintervall, eller InfiniteMatchTimeout för att indikera att metoden inte bör överskrida tidsgränsen.
Returer
En matris med strängar.
Undantag
Ett fel uppstod vid parsning av reguljära uttryck.
input eller pattern är null.
options är inte en giltig bitvis kombination av RegexOptions värden.
-or- matchTimeout är negativ, noll eller större än cirka 24 dagar.
En timeout inträffade.
Kommentarer
De statiska Split(String, String, RegexOptions, TimeSpan) metoderna motsvarar konstruera ett Regex objekt med det angivna reguljära uttrycksmönstret och anropa instansmetoden Split(String).
Regex.Split-metoderna liknar Split(Char[]) metoden, förutom att Regex.Split delar upp strängen vid en avgränsare som bestäms av ett reguljärt uttryck i stället för en uppsättning tecken. Om mönstret för reguljära uttryck innehåller samlande parenteser inkluderas den insamlade texten i den resulterande strängmatrisen. Om mönstret innehåller samlande parenteser inkluderas all insamlad text i den resulterande strängmatrisen, men räknas inte när du avgör om gränsen för antal har uppnåtts.
Om två intilliggande matchningar hittas placeras en tom sträng i matrisen.
Om du anger RightToLeft parametern options börjar sökningen efter matchningar i slutet av indatasträngen och flyttas åt vänster.
Parametern matchTimeout anger hur länge en mönstermatchningsmetod ska försöka hitta en matchning innan tidsgränsen överskrids. matchTimeout Åsidosätter alla standardvärden för tidsgränser som definierats för programdomänen där metoden körs.
Anteckningar till anropare
Vi rekommenderar att du anger parametern matchTimeout till ett lämpligt värde, till exempel två sekunder. Om du inaktiverar tidsgränser genom att ange ger motorn för reguljära InfiniteMatchTimeoututtryck något bättre prestanda. Du bör dock inaktivera tidsgränser endast under följande villkor:
När indata som bearbetas av ett reguljärt uttryck härleds från en känd och betrodd källa eller består av statisk text. Detta exkluderar text som har matats in dynamiskt av användare.
När mönstret för reguljära uttryck har testats noggrant för att säkerställa att det effektivt hanterar matchningar, icke-matchningar och nära matchningar.
När det reguljära uttrycksmönstret inte innehåller några språkelement som är kända för att orsaka överdriven bakåtspårning vid bearbetning av en nära matchning.
Se även
Gäller för
Split(String, String, RegexOptions)
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
Delar upp en indatasträng i en matris med delsträngar på de positioner som definieras av ett angivet mönster för reguljära uttryck. Angivna alternativ ändrar matchningsåtgärden.
public:
static cli::array <System::String ^> ^ Split(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);public static string[] Split(string input, string pattern, System.Text.RegularExpressions.RegexOptions options);static member Split : string * string * System.Text.RegularExpressions.RegexOptions -> string[]Public Shared Function Split (input As String, pattern As String, options As RegexOptions) As String()Parametrar
- input
- String
Strängen som ska delas.
- pattern
- String
Det reguljära uttrycksmönster som ska matchas.
- options
- RegexOptions
En bitvis kombination av uppräkningsvärdena som ger alternativ för matchning.
Returer
En matris med strängar.
Undantag
Ett fel uppstod vid parsning av reguljära uttryck.
input eller pattern är null.
options är inte en giltig bitvis kombination av RegexOptions värden.
En timeout inträffade.
Kommentarer
De statiska Split(String, String, RegexOptions) metoderna motsvarar konstruera ett Regex objekt med det angivna reguljära uttrycksmönstret och anropa instansmetoden Split(String).
Regex.Split-metoderna liknar Split(Char[]) metoden, förutom att Regex.Split delar upp strängen vid en avgränsare som bestäms av ett reguljärt uttryck i stället för en uppsättning tecken. Om mönstret för reguljära uttryck innehåller samlande parenteser inkluderas den insamlade texten i den resulterande strängmatrisen. Om mönstret innehåller samlande parenteser inkluderas all insamlad text i den resulterande strängmatrisen, men räknas inte när du avgör om gränsen för antal har uppnåtts.
Om två intilliggande matchningar hittas placeras en tom sträng i matrisen.
Om du anger RightToLeft parametern options börjar sökningen efter matchningar i slutet av indatasträngen och flyttas åt vänster.
Anteckningar till anropare
Den här metoden överskrider tidsgränsen efter ett intervall som är lika med standardvärdet för tidsgränsen för programdomänen där metoden anropas. Om ett timeout-värde inte har definierats för programdomänen används värdet InfiniteMatchTimeout, som förhindrar att metoden överskrider tidsgränsen. Den rekommenderade statiska metoden för att dela upp text på en mönstermatchning är Split(String, String, RegexOptions, TimeSpan), vilket gör att du kan ange tidsgränsintervallet.
Se även
Gäller för
Split(String, Int32, Int32)
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
Delar upp en indatasträng ett angivet maximalt antal gånger i en matris med delsträngar, vid de positioner som definieras av ett reguljärt uttryck som anges i Regex konstruktorn. Sökningen efter mönster för reguljära uttryck börjar vid en angiven teckenposition i indatasträngen.
public:
cli::array <System::String ^> ^ Split(System::String ^ input, int count, int startat);public string[] Split(string input, int count, int startat);member this.Split : string * int * int -> string[]Public Function Split (input As String, count As Integer, startat As Integer) As String()Parametrar
- input
- String
Strängen som ska delas.
- count
- Int32
Det maximala antalet gånger som delningen kan ske.
- startat
- Int32
Teckenpositionen i indatasträngen där sökningen börjar.
Returer
En matris med strängar.
Undantag
input är null.
startat är mindre än noll eller större än längden på input.
En timeout inträffade.
Kommentarer
Mer information om startatfinns i avsnittet Kommentarer i Match(String, Int32).
Om samlande parenteser används i uttrycket inkluderas all insamlad text i den resulterande strängmatrisen count men räknas inte mot gränsen.
Tomma strängar som härrör från intilliggande matchningar räknas när du avgör om antalet matchningar har nått count.
Se även
Gäller för
Split(String, String)
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
Delar upp en indatasträng i en matris med delsträngar på de positioner som definieras av ett mönster för reguljära uttryck.
public:
static cli::array <System::String ^> ^ Split(System::String ^ input, System::String ^ pattern);public static string[] Split(string input, string pattern);static member Split : string * string -> string[]Public Shared Function Split (input As String, pattern As String) As String()Parametrar
- input
- String
Strängen som ska delas.
- pattern
- String
Det reguljära uttrycksmönster som ska matchas.
Returer
En matris med strängar.
Undantag
Ett fel uppstod vid parsning av reguljära uttryck.
input eller pattern är null.
En timeout inträffade.
Kommentarer
De statiska Split(String, String) metoderna motsvarar konstruera ett Regex objekt med det angivna reguljära uttrycksmönstret och anropa instansmetoden Split(String).
Regex.Split-metoderna liknar Split(Char[]) metoden, förutom att Regex.Split delar upp strängen vid en avgränsare som bestäms av ett reguljärt uttryck i stället för en uppsättning tecken. Om mönstret för reguljära uttryck innehåller samlande parenteser inkluderas den insamlade texten i den resulterande strängmatrisen. Om mönstret innehåller samlande parenteser inkluderas all insamlad text i den resulterande strängmatrisen, men räknas inte när du avgör om gränsen för antal har uppnåtts.
Om två intilliggande matchningar hittas placeras en tom sträng i matrisen.
Anteckningar till anropare
Den här metoden överskrider tidsgränsen efter ett intervall som är lika med standardvärdet för tidsgränsen för programdomänen där metoden anropas. Om ett timeout-värde inte har definierats för programdomänen används värdet InfiniteMatchTimeout, som förhindrar att metoden överskrider tidsgränsen. Den rekommenderade statiska metoden för att dela upp text på en mönstermatchning är Split(String, String, RegexOptions, TimeSpan), vilket gör att du kan ange tidsgränsintervallet.
Se även
Gäller för
Split(String)
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
Delar upp en indatasträng i en matris med delsträngar på de positioner som definieras av ett mönster för reguljära uttryck som anges i Regex konstruktorn.
public:
cli::array <System::String ^> ^ Split(System::String ^ input);public string[] Split(string input);member this.Split : string -> string[]Public Function Split (input As String) As String()Parametrar
- input
- String
Strängen som ska delas.
Returer
En matris med strängar.
Undantag
input är null.
En timeout inträffade.
Kommentarer
Regex.Split-metoderna liknar Split(Char[]) metoden, förutom att Regex.Split delar upp strängen vid en avgränsare som bestäms av ett reguljärt uttryck i stället för en uppsättning tecken. Strängen delas så många gånger som möjligt. Om ingen matchning hittas innehåller returvärdet ett element vars värde är den ursprungliga indatasträngen.
Om det reguljära uttrycket kan matcha den tomma strängen Split(String) , delas strängen upp i en matris med strängar med en tecken eftersom den tomma strängen avgränsare kan hittas på varje plats.
Om samlande parenteser används i uttrycket inkluderas all insamlad text i den resulterande strängmatrisen.
Om två intilliggande matchningar hittas placeras en tom sträng i matrisen.
Se även
Gäller för
Split(String, Int32)
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
- Källa:
- Regex.Split.cs
Delar upp en indatasträng ett angivet maximalt antal gånger i en matris med delsträngar, vid de positioner som definieras av ett reguljärt uttryck som anges i Regex konstruktorn.
public:
cli::array <System::String ^> ^ Split(System::String ^ input, int count);public string[] Split(string input, int count);member this.Split : string * int -> string[]Public Function Split (input As String, count As Integer) As String()Parametrar
- input
- String
Strängen som ska delas.
- count
- Int32
Det maximala antalet gånger som delningen kan ske.
Returer
En matris med strängar.
Undantag
input är null.
En timeout inträffade.
Kommentarer
Regex.Split-metoderna liknar Split(Char[]). Parametern count anger det maximala antalet delsträngar som indatasträngen kan delas upp i. Den sista strängen innehåller den obelysta resten av strängen. Värdet count noll ger standardbeteendet att dela upp så många gånger som möjligt.
Om samlande parenteser används i uttrycket inkluderas all insamlad text i den resulterande strängmatrisen count men räknas inte mot gränsen.
Tomma strängar som härrör från intilliggande matchningar räknas när du avgör om antalet matchningar har nått count.
