Regex.Replace Metoda

Definice

Obor názvů:

System.Text.RegularExpressions

Sestavení:

netstandard.dll, System.Text.RegularExpressions.dll

V zadaném vstupním řetězci nahradí řetězce, které odpovídají vzoru regulárního výrazu, zadaným náhradním řetězcem.

Přetížení

Name	Description
Replace(String, String, String, RegexOptions)	V zadaném vstupním řetězci nahradí všechny řetězce, které odpovídají zadanému regulárnímu výrazu, zadaným náhradním řetězcem. Zadané možnosti upravují odpovídající operaci.
Replace(String, String, String, RegexOptions, TimeSpan)	V zadaném vstupním řetězci nahradí všechny řetězce, které odpovídají zadanému regulárnímu výrazu, zadaným náhradním řetězcem. Další parametry určují možnosti, které upravují odpovídající operaci a interval časového limitu, pokud se nenajde žádná shoda.
Replace(String, MatchEvaluator, Int32, Int32)	V zadaném vstupním podřetězci nahradí zadaný maximální počet řetězců, které odpovídají vzoru regulárního výrazu s řetězcem vráceným delegátem MatchEvaluator .
Replace(String, String, MatchEvaluator, RegexOptions)	V zadaném vstupním řetězci nahradí všechny řetězce, které odpovídají zadanému regulárnímu výrazu, řetězcem vráceným delegátem MatchEvaluator . Zadané možnosti upravují odpovídající operaci.
Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan)	V zadaném vstupním řetězci nahradí všechny podřetězce, které odpovídají zadanému regulárnímu výrazu, řetězcem vráceným delegátem MatchEvaluator . Další parametry určují možnosti, které upravují odpovídající operaci a interval časového limitu, pokud se nenajde žádná shoda.
Replace(String, String, Int32, Int32)	V zadaném vstupním podřetězci nahradí zadaný maximální počet řetězců, které odpovídají vzoru regulárního výrazu se zadaným náhradním řetězcem.
Replace(String, String, String)	V zadaném vstupním řetězci nahradí všechny řetězce, které odpovídají zadanému vzoru regulárního výrazu, zadaným náhradním řetězcem.
Replace(String, String, MatchEvaluator)	V zadaném vstupním řetězci nahradí všechny řetězce, které odpovídají zadanému regulárnímu výrazu, řetězcem vráceným delegátem MatchEvaluator .
Replace(String, String, Int32)	V zadaném vstupním řetězci nahradí zadaný maximální počet řetězců, které odpovídají vzoru regulárního výrazu, zadaným náhradním řetězcem.
Replace(String, MatchEvaluator)	V zadaném vstupním řetězci nahradí všechny řetězce, které odpovídají zadanému regulárnímu výrazu, řetězcem vráceným delegátem MatchEvaluator .
Replace(String, String)	V zadaném vstupním řetězci nahradí všechny řetězce, které odpovídají vzoru regulárního výrazu, zadaným náhradním řetězcem.
Replace(String, MatchEvaluator, Int32)	V zadaném vstupním řetězci nahradí zadaný maximální počet řetězců, které odpovídají vzoru regulárního výrazu, řetězcem vráceným delegátem MatchEvaluator .

Replace(String, String, String, RegexOptions)

Zdroj:

Regex.Replace.cs

V zadaném vstupním řetězci nahradí všechny řetězce, které odpovídají zadanému regulárnímu výrazu, zadaným náhradním řetězcem. Zadané možnosti upravují odpovídající operaci.

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::String ^ replacement, System::Text::RegularExpressions::RegexOptions options);

public static string Replace(string input, string pattern, string replacement, System.Text.RegularExpressions.RegexOptions options);

static member Replace : string * string * string * System.Text.RegularExpressions.RegexOptions -> string

Public Shared Function Replace (input As String, pattern As String, replacement As String, options As RegexOptions) As String

Parametry

input

String

Řetězec, který chcete vyhledat shodu.

pattern

String

Vzor regulárního výrazu, který se má shodovat.

replacement

String

Náhradní řetězec.

options

RegexOptions

Bitové kombinace hodnot výčtu, které poskytují možnosti pro porovnávání.

Návraty

String

Nový řetězec, který je shodný se vstupním řetězcem, s výjimkou toho, že náhradní řetězec se umístí na místo každého odpovídajícího řetězce. Pokud pattern se v aktuální instanci neshoduje, vrátí metoda aktuální instanci beze změny.

Výjimky

ArgumentException

Došlo k chybě analýzy regulárních výrazů.

ArgumentNullException

input, patternnebo replacement je null.

ArgumentOutOfRangeException

options není platná bitové kombinace RegexOptions hodnot.

RegexMatchTimeoutException

Došlo k vypršení časového limitu.

Poznámky

Statické Replace(String, String, String, RegexOptions) metody jsou ekvivalentní k vytvoření objektu Regex se zadaným vzorem regulárního výrazu a volání metody Replace(String, String)instance .

Parametr replacement určuje řetězec, který nahradí každou shodu v input. replacement může se skládat z jakékoli kombinace literálového textu a nahrazení. Náhrady jsou jediné prvky jazyka regulárních výrazů, které jsou rozpoznány v náhradním vzoru.

Vzhledem k tomu, že metoda vrací input beze změny, pokud neexistuje shoda, můžete použít metodu ReferenceEquals(Object, Object) k určení, zda metoda udělala nějaké nahrazení.

Pokud zadáte RightToLeft parametr options , hledání shody začíná na konci vstupního řetězce a přesune se doleva. V opačném případě hledání začíná na začátku vstupního řetězce a přesune se doprava.

Poznámky pro volající

Tato metoda vyprší po intervalu, který se rovná výchozí hodnotě časového limitu domény aplikace, ve které je volána. Pokud nebyla pro doménu aplikace definována hodnota časového limitu, použije se hodnota InfiniteMatchTimeout, která brání vypršení časového limitu metody. Doporučená statická metoda nahrazení shody vzorů je Replace(String, String, String, RegexOptions, TimeSpan), která umožňuje nastavit interval časového limitu.

Viz také

• RegexOptions
• Nahrazení v regulárních výrazech
• Elementy jazyka regulárních výrazů

Replace(String, String, String, RegexOptions, TimeSpan)

Zdroj:

Regex.Replace.cs

V zadaném vstupním řetězci nahradí všechny řetězce, které odpovídají zadanému regulárnímu výrazu, zadaným náhradním řetězcem. Další parametry určují možnosti, které upravují odpovídající operaci a interval časového limitu, pokud se nenajde žádná shoda.

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::String ^ replacement, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);

public static string Replace(string input, string pattern, string replacement, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);

static member Replace : string * string * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> string

Public Shared Function Replace (input As String, pattern As String, replacement As String, options As RegexOptions, matchTimeout As TimeSpan) As String

Parametry

input

String

Řetězec, který chcete vyhledat shodu.

pattern

String

Vzor regulárního výrazu, který se má shodovat.

replacement

String

Náhradní řetězec.

options

RegexOptions

Bitové kombinace hodnot výčtu, které poskytují možnosti pro porovnávání.

matchTimeout

TimeSpan

Interval časového limitu nebo InfiniteMatchTimeout označení, že metoda by neměla časového limitu časového limitu.

Návraty

String

Nový řetězec, který je shodný se vstupním řetězcem, s výjimkou toho, že náhradní řetězec se umístí na místo každého odpovídajícího řetězce. Pokud pattern se v aktuální instanci neshoduje, vrátí metoda aktuální instanci beze změny.

Výjimky

ArgumentException

Došlo k chybě analýzy regulárních výrazů.

ArgumentNullException

input, patternnebo replacement je null.

ArgumentOutOfRangeException

options není platná bitové kombinace RegexOptions hodnot. -nebo- matchTimeout je záporná, nula nebo větší než přibližně 24 dní.

RegexMatchTimeoutException

Došlo k vypršení časového limitu.

Poznámky

Statické Replace(String, String, String, RegexOptions, TimeSpan) metody jsou ekvivalentní k vytvoření objektu Regex se zadaným vzorem regulárního výrazu a volání metody Replace(String, String)instance .

Parametr replacement určuje řetězec, který nahradí každou shodu v input. replacement může se skládat z jakékoli kombinace literálového textu a nahrazení. Náhrady jsou jediné prvky jazyka regulárních výrazů, které jsou rozpoznány v náhradním vzoru.

Vzhledem k tomu, že metoda vrací input beze změny, pokud neexistuje shoda, můžete použít metodu ReferenceEquals(Object, Object) k určení, zda metoda udělala nějaké nahrazení.

Pokud zadáte RightToLeft parametr options , hledání shody začíná na konci vstupního řetězce a přesune se doleva. V opačném případě hledání začíná na začátku vstupního řetězce a přesune se doprava.

Parametr matchTimeout určuje, jak dlouho se má metoda porovnávání vzorů pokusit najít shodu, než vyprší časový limit. Nastavení intervalu časového limitu brání regulárním výrazům, které spoléhají na nadměrné navracení, aby přestaly reagovat při zpracování vstupu, který obsahuje téměř shody. matchTimeout přepíše výchozí hodnotu časového limitu definovanou pro doménu aplikace, ve které se metoda spouští.

Poznámky pro volající

Doporučujeme nastavit matchTimeout parametr na odpovídající hodnotu, například dvě sekundy. Pokud zakážete vypršení časového limitu zadáním InfiniteMatchTimeout, modul regulárních výrazů nabízí mírně lepší výkon. Časové limity byste ale měli zakázat pouze za následujících podmínek:

• Pokud je vstup zpracovaný regulárním výrazem odvozen ze známého a důvěryhodného zdroje nebo se skládá ze statického textu. Tím se vyloučí text, který uživatelé dynamicky zadali.

• Když byl vzor regulárního výrazu důkladně otestován, aby se zajistilo, že efektivně zpracovává shody, neshody a blízké shody.

• Pokud vzor regulárního výrazu neobsahuje žádné prvky jazyka, o kterých je známo, že při zpracování blízké shody způsobují nadměrné navracení.

Viz také

• RegexOptions
• Nahrazení v regulárních výrazech
• Elementy jazyka regulárních výrazů
• Navracení v regulárních výrazech
• Osvědčené postupy pro regulární výrazy v .NET

Replace(String, MatchEvaluator, Int32, Int32)

Zdroj:

Regex.Replace.cs

V zadaném vstupním podřetězci nahradí zadaný maximální počet řetězců, které odpovídají vzoru regulárního výrazu s řetězcem vráceným delegátem MatchEvaluator .

public:
 System::String ^ Replace(System::String ^ input, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, int count, int startat);

public string Replace(string input, System.Text.RegularExpressions.MatchEvaluator evaluator, int count, int startat);

member this.Replace : string * System.Text.RegularExpressions.MatchEvaluator * int * int -> string

Public Function Replace (input As String, evaluator As MatchEvaluator, count As Integer, startat As Integer) As String

Parametry

input

String

Řetězec, který chcete vyhledat shodu.

evaluator

MatchEvaluator

Vlastní metoda, která zkoumá každou shodu a vrací buď původní odpovídající řetězec, nebo náhradní řetězec.

count

Int32

Maximální počet výskytů nahrazení.

startat

Int32

Pozice znaku ve vstupním řetězci, kde začíná hledání.

Návraty

String

Nový řetězec, který je shodný se vstupním řetězcem, s tím rozdílem, že náhradní řetězec přebírá místo každého odpovídajícího řetězce. Pokud vzor regulárního výrazu neodpovídá v aktuální instanci, vrátí metoda aktuální instanci beze změny.

Výjimky

ArgumentNullException

input nebo evaluator je null.

ArgumentOutOfRangeException

startat je menší než nula nebo větší než délka input.

RegexMatchTimeoutException

Došlo k vypršení časového limitu.

Poznámky

Další podrobnosti o startat, viz poznámky oddílu Match(String, Int32).

Metoda předá první countMatch objekty delegátu evaluator .

Viz také

• MatchEvaluator
• Nahrazení v regulárních výrazech
• Jazyk regulárních výrazů – stručná referenční dokumentace

Replace(String, String, MatchEvaluator, RegexOptions)

Zdroj:

Regex.Replace.cs

V zadaném vstupním řetězci nahradí všechny řetězce, které odpovídají zadanému regulárnímu výrazu, řetězcem vráceným delegátem MatchEvaluator . Zadané možnosti upravují odpovídající operaci.

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, System::Text::RegularExpressions::RegexOptions options);

public static string Replace(string input, string pattern, System.Text.RegularExpressions.MatchEvaluator evaluator, System.Text.RegularExpressions.RegexOptions options);

static member Replace : string * string * System.Text.RegularExpressions.MatchEvaluator * System.Text.RegularExpressions.RegexOptions -> string

Public Shared Function Replace (input As String, pattern As String, evaluator As MatchEvaluator, options As RegexOptions) As String

Parametry

input

String

Řetězec, který chcete vyhledat shodu.

pattern

String

Vzor regulárního výrazu, který se má shodovat.

evaluator

MatchEvaluator

Vlastní metoda, která zkoumá každou shodu a vrací buď původní odpovídající řetězec, nebo náhradní řetězec.

options

RegexOptions

Bitové kombinace hodnot výčtu, které poskytují možnosti pro porovnávání.

Návraty

String

Nový řetězec, který je shodný se vstupním řetězcem, s tím rozdílem, že náhradní řetězec přebírá místo každého odpovídajícího řetězce. Pokud pattern se v aktuální instanci neshoduje, vrátí metoda aktuální instanci beze změny.

Výjimky

ArgumentException

Došlo k chybě analýzy regulárních výrazů.

ArgumentNullException

input, patternnebo evaluator je null.

ArgumentOutOfRangeException

options není platná bitové kombinace RegexOptions hodnot.

RegexMatchTimeoutException

Došlo k vypršení časového limitu.

Poznámky

Tato metoda je užitečná pro nahrazení shody regulárního výrazu, pokud je splněna některá z následujících podmínek: náhradní řetězec nelze snadno určit vzorem nahrazení regulárního výrazu, výsledky náhradního řetězce ze zpracování odpovídajícího řetězce nebo výsledky náhradního řetězce z podmíněného zpracování.

Metoda je ekvivalentní volání Matches(String, String) metody a předání každého Match objektu vráceného MatchCollection delegátu evaluator .

Vzhledem k tomu, že metoda vrací input beze změny, pokud neexistuje shoda, můžete použít metodu ReferenceEquals(Object, Object) k určení, zda metoda udělala nějaké nahrazení.

Pokud zadáte RightToLeft parametr options , hledání shody začíná na konci vstupního řetězce a přesune se doleva. V opačném případě hledání začíná na začátku vstupního řetězce a přesune se doprava.

Viz také

• MatchEvaluator
• RegexOptions
• Nahrazení v regulárních výrazech
• Elementy jazyka regulárních výrazů

Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan)

Zdroj:

Regex.Replace.cs

V zadaném vstupním řetězci nahradí všechny podřetězce, které odpovídají zadanému regulárnímu výrazu, řetězcem vráceným delegátem MatchEvaluator . Další parametry určují možnosti, které upravují odpovídající operaci a interval časového limitu, pokud se nenajde žádná shoda.

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);

public static string Replace(string input, string pattern, System.Text.RegularExpressions.MatchEvaluator evaluator, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);

static member Replace : string * string * System.Text.RegularExpressions.MatchEvaluator * System.Text.RegularExpressions.RegexOptions * TimeSpan -> string

Public Shared Function Replace (input As String, pattern As String, evaluator As MatchEvaluator, options As RegexOptions, matchTimeout As TimeSpan) As String

Parametry

input

String

Řetězec, který chcete vyhledat shodu.

pattern

String

Vzor regulárního výrazu, který se má shodovat.

evaluator

MatchEvaluator

Vlastní metoda, která zkoumá každou shodu a vrací buď původní odpovídající řetězec, nebo náhradní řetězec.

options

RegexOptions

Bitové kombinace hodnot výčtu, které poskytují možnosti pro porovnávání.

matchTimeout

TimeSpan

Interval časového limitu nebo InfiniteMatchTimeout označení, že metoda by neměla časového limitu časového limitu.

Návraty

String

Nový řetězec, který je shodný se vstupním řetězcem, s tím rozdílem, že náhradní řetězec přebírá místo každého odpovídajícího řetězce. Pokud pattern se v aktuální instanci neshoduje, vrátí metoda aktuální instanci beze změny.

Výjimky

ArgumentException

Došlo k chybě analýzy regulárních výrazů.

ArgumentNullException

input, patternnebo evaluator je null.

ArgumentOutOfRangeException

options není platná bitové kombinace RegexOptions hodnot. -nebo- matchTimeout je záporná, nula nebo větší než přibližně 24 dní.

RegexMatchTimeoutException

Došlo k vypršení časového limitu.

Poznámky

Tato metoda je užitečná pro nahrazení shody regulárního výrazu, pokud je splněna některá z následujících podmínek: náhradní řetězec nelze snadno určit vzorem nahrazení regulárního výrazu, výsledky náhradního řetězce ze zpracování odpovídajícího řetězce nebo výsledky náhradního řetězce z podmíněného zpracování.

Metoda je ekvivalentní volání Matches(String, String) metody a předání každého Match objektu vráceného MatchCollection delegátu evaluator .

Vzhledem k tomu, že metoda vrací input beze změny, pokud neexistuje shoda, můžete použít metodu ReferenceEquals(Object, Object) k určení, zda metoda udělala nějaké nahrazení.

Pokud zadáte RightToLeft parametr options , hledání shody začíná na konci vstupního řetězce a přesune se doleva. V opačném případě hledání začíná na začátku vstupního řetězce a přesune se doprava.

Parametr matchTimeout určuje, jak dlouho se má metoda porovnávání vzorů pokusit najít shodu před vypršením časového limitu. matchTimeout Přepíše výchozí hodnotu časového limitu definovanou pro doménu aplikace, ve které se metoda spustí.

Poznámky pro volající

Doporučujeme nastavit matchTimeout parametr na odpovídající hodnotu, například dvě sekundy. Pokud zakážete vypršení časového limitu zadáním InfiniteMatchTimeout, modul regulárních výrazů nabízí mírně lepší výkon. Časové limity byste ale měli zakázat pouze za následujících podmínek:

• Pokud je vstup zpracovaný regulárním výrazem odvozen ze známého a důvěryhodného zdroje nebo se skládá ze statického textu. Tím se vyloučí text, který uživatelé dynamicky zadali.

• Když byl vzor regulárního výrazu důkladně otestován, aby se zajistilo, že efektivně zpracovává shody, neshody a blízké shody.

• Pokud vzor regulárního výrazu neobsahuje žádné prvky jazyka, o kterých je známo, že při zpracování blízké shody způsobují nadměrné navracení.

Viz také

• RegexOptions
• Nahrazení v regulárních výrazech
• Elementy jazyka regulárních výrazů
• Navracení v regulárních výrazech
• Osvědčené postupy pro regulární výrazy v .NET

Replace(String, String, Int32, Int32)

Zdroj:

Regex.Replace.cs

V zadaném vstupním podřetězci nahradí zadaný maximální počet řetězců, které odpovídají vzoru regulárního výrazu se zadaným náhradním řetězcem.

public:
 System::String ^ Replace(System::String ^ input, System::String ^ replacement, int count, int startat);

public string Replace(string input, string replacement, int count, int startat);

member this.Replace : string * string * int * int -> string

Public Function Replace (input As String, replacement As String, count As Integer, startat As Integer) As String

Parametry

input

String

Řetězec, který chcete vyhledat shodu.

replacement

String

Náhradní řetězec.

count

Int32

Maximální počet výskytů nahrazení.

startat

Int32

Pozice znaku ve vstupním řetězci, kde začíná hledání.

Návraty

String

Nový řetězec, který je shodný se vstupním řetězcem, s výjimkou toho, že náhradní řetězec se umístí na místo každého odpovídajícího řetězce. Pokud vzor regulárního výrazu neodpovídá v aktuální instanci, vrátí metoda aktuální instanci beze změny.

Výjimky

ArgumentNullException

input nebo replacement je null.

ArgumentOutOfRangeException

startat je menší než nula nebo větší než délka input.

RegexMatchTimeoutException

Došlo k vypršení časového limitu.

Poznámky

Další podrobnosti o startat, viz poznámky oddílu Match(String, Int32).

Parametr replacement určuje řetězec, který nahradí každou shodu a podporuje nahrazení.

Pokud count je záporné, nahrazení pokračuje na konec řetězce.

Viz také

• Nahrazení v regulárních výrazech
• Jazyk regulárních výrazů – stručná referenční dokumentace

Replace(String, String, String)

Zdroj:

Regex.Replace.cs

V zadaném vstupním řetězci nahradí všechny řetězce, které odpovídají zadanému vzoru regulárního výrazu, zadaným náhradním řetězcem.

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::String ^ replacement);

public static string Replace(string input, string pattern, string replacement);

static member Replace : string * string * string -> string

Public Shared Function Replace (input As String, pattern As String, replacement As String) As String

Parametry

input

String

Řetězec, který chcete vyhledat shodu.

pattern

String

Vzor regulárního výrazu, který se má shodovat.

replacement

String

Náhradní řetězec.

Návraty

String

Nový řetězec, který je shodný se vstupním řetězcem, s výjimkou toho, že náhradní řetězec se umístí na místo každého odpovídajícího řetězce. Pokud pattern se v aktuální instanci neshoduje, vrátí metoda aktuální instanci beze změny.

Výjimky

ArgumentException

Došlo k chybě analýzy regulárních výrazů.

ArgumentNullException

input, patternnebo replacement je null.

RegexMatchTimeoutException

Došlo k vypršení časového limitu.

Poznámky

Statické Replace(String, String, String) metody jsou ekvivalentní k vytvoření objektu Regex se zadaným vzorem regulárního výrazu a volání metody Replace(String, String)instance .

Parametr replacement určuje řetězec, který nahradí každou shodu v input. replacement může se skládat z jakékoli kombinace literálového textu a nahrazení. Náhrady jsou jediné prvky jazyka regulárních výrazů, které jsou rozpoznány v náhradním vzoru.

Vzhledem k tomu, že metoda vrací input beze změny, pokud neexistuje shoda, můžete použít metodu ReferenceEquals(Object, Object) k určení, zda metoda udělala nějaké nahrazení.

Poznámky pro volající

Tato metoda vyprší po intervalu, který se rovná výchozí hodnotě časového limitu domény aplikace, ve které je volána. Pokud nebyla pro doménu aplikace definována hodnota časového limitu, použije se hodnota InfiniteMatchTimeout, která brání vypršení časového limitu metody. Doporučená statická metoda nahrazení shody vzorů je Replace(String, String, String, RegexOptions, TimeSpan), která umožňuje nastavit interval časového limitu.

Viz také

• Nahrazení v regulárních výrazech
• Elementy jazyka regulárních výrazů

Replace(String, String, MatchEvaluator)

Zdroj:

Regex.Replace.cs

V zadaném vstupním řetězci nahradí všechny řetězce, které odpovídají zadanému regulárnímu výrazu, řetězcem vráceným delegátem MatchEvaluator .

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::MatchEvaluator ^ evaluator);

public static string Replace(string input, string pattern, System.Text.RegularExpressions.MatchEvaluator evaluator);

static member Replace : string * string * System.Text.RegularExpressions.MatchEvaluator -> string

Public Shared Function Replace (input As String, pattern As String, evaluator As MatchEvaluator) As String

Parametry

input

String

Řetězec, který chcete vyhledat shodu.

pattern

String

Vzor regulárního výrazu, který se má shodovat.

evaluator

MatchEvaluator

Vlastní metoda, která zkoumá každou shodu a vrací buď původní odpovídající řetězec, nebo náhradní řetězec.

Návraty

String

Nový řetězec, který je shodný se vstupním řetězcem, s tím rozdílem, že náhradní řetězec přebírá místo každého odpovídajícího řetězce. Pokud pattern se v aktuální instanci neshoduje, vrátí metoda aktuální instanci beze změny.

Výjimky

ArgumentException

Došlo k chybě analýzy regulárních výrazů.

ArgumentNullException

input, patternnebo evaluator je null.

RegexMatchTimeoutException

Došlo k vypršení časového limitu.

Poznámky

Tato metoda je užitečná pro nahrazení shody regulárního výrazu, pokud je splněna některá z následujících podmínek: náhradní řetězec nelze snadno určit vzorem nahrazení regulárního výrazu, výsledky náhradního řetězce ze zpracování odpovídajícího řetězce nebo výsledky náhradního řetězce z podmíněného zpracování.

Metoda je ekvivalentní volání Matches(String, String) metody a předání každého Match objektu vráceného MatchCollection delegátu evaluator .

Vzhledem k tomu, že metoda vrací input beze změny, pokud neexistuje shoda, můžete použít metodu ReferenceEquals(Object, Object) k určení, zda metoda udělala nějaké nahrazení.

Poznámky pro volající

Tato metoda vyprší po intervalu, který se rovná výchozí hodnotě časového limitu domény aplikace, ve které je volána. Pokud nebyla pro doménu aplikace definována hodnota časového limitu, použije se hodnota InfiniteMatchTimeout, která brání vypršení časového limitu metody. Doporučená statická metoda pro vyhodnocení a nahrazení shody vzorů je Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan), která umožňuje nastavit interval časového limitu.

Viz také

• MatchEvaluator
• Nahrazení v regulárních výrazech
• Elementy jazyka regulárních výrazů

Replace(String, String, Int32)

Zdroj:

Regex.Replace.cs

V zadaném vstupním řetězci nahradí zadaný maximální počet řetězců, které odpovídají vzoru regulárního výrazu, zadaným náhradním řetězcem.

public:
 System::String ^ Replace(System::String ^ input, System::String ^ replacement, int count);

public string Replace(string input, string replacement, int count);

member this.Replace : string * string * int -> string

Public Function Replace (input As String, replacement As String, count As Integer) As String

Parametry

input

String

Řetězec, který chcete vyhledat shodu.

replacement

String

Náhradní řetězec.

count

Int32

Maximální počet výskytů nahrazení.

Návraty

String

Nový řetězec, který je shodný se vstupním řetězcem, s výjimkou toho, že náhradní řetězec se umístí na místo každého odpovídajícího řetězce. Pokud vzor regulárního výrazu neodpovídá v aktuální instanci, vrátí metoda aktuální instanci beze změny.

Výjimky

ArgumentNullException

input nebo replacement je null.

RegexMatchTimeoutException

Došlo k vypršení časového limitu.

Poznámky

Hledání začíná na začátku input řetězce. Parametr replacement určuje řetězec, který nahradí každou shodu a podporuje nahrazení.

Pokud count je záporné, nahrazení pokračuje na konec řetězce.

Vzhledem k tomu, že metoda vrací input beze změny, pokud neexistuje shoda, můžete použít metodu ReferenceEquals(Object, Object) k určení, zda metoda udělala nějaké nahrazení.

Viz také

• Jazyk regulárních výrazů – stručná referenční dokumentace
• Nahrazení v regulárních výrazech

Replace(String, MatchEvaluator)

Zdroj:

Regex.Replace.cs

V zadaném vstupním řetězci nahradí všechny řetězce, které odpovídají zadanému regulárnímu výrazu, řetězcem vráceným delegátem MatchEvaluator .

public:
 System::String ^ Replace(System::String ^ input, System::Text::RegularExpressions::MatchEvaluator ^ evaluator);

public string Replace(string input, System.Text.RegularExpressions.MatchEvaluator evaluator);

member this.Replace : string * System.Text.RegularExpressions.MatchEvaluator -> string

Public Function Replace (input As String, evaluator As MatchEvaluator) As String

Parametry

input

String

Řetězec, který chcete vyhledat shodu.

evaluator

MatchEvaluator

Vlastní metoda, která zkoumá každou shodu a vrací buď původní odpovídající řetězec, nebo náhradní řetězec.

Návraty

String

Nový řetězec, který je shodný se vstupním řetězcem, s tím rozdílem, že náhradní řetězec přebírá místo každého odpovídajícího řetězce. Pokud vzor regulárního výrazu neodpovídá v aktuální instanci, vrátí metoda aktuální instanci beze změny.

Výjimky

ArgumentNullException

input nebo evaluator je null.

RegexMatchTimeoutException

Došlo k vypršení časového limitu.

Poznámky

Tato metoda je užitečná pro nahrazení shody regulárního výrazu, pokud je splněna některá z následujících podmínek: náhradní řetězec nelze snadno určit vzorem nahrazení regulárního výrazu, výsledky náhradního řetězce ze zpracování odpovídajícího řetězce nebo výsledky náhradního řetězce z podmíněného zpracování.

Metoda je ekvivalentní volání Matches(String) metody a předání každého Match objektu vráceného MatchCollection delegátu evaluator .

Vzhledem k tomu, že metoda vrací input beze změny, pokud neexistuje shoda, můžete použít metodu ReferenceEquals(Object, Object) k určení, zda metoda udělala nějaké nahrazení.

Viz také

• MatchEvaluator
• Nahrazení v regulárních výrazech
• Jazyk regulárních výrazů – stručná referenční dokumentace

Replace(String, String)

Zdroj:

Regex.Replace.cs

V zadaném vstupním řetězci nahradí všechny řetězce, které odpovídají vzoru regulárního výrazu, zadaným náhradním řetězcem.

public:
 System::String ^ Replace(System::String ^ input, System::String ^ replacement);

public string Replace(string input, string replacement);

member this.Replace : string * string -> string

Public Function Replace (input As String, replacement As String) As String

Parametry

input

String

Řetězec, který chcete vyhledat shodu.

replacement

String

Náhradní řetězec.

Návraty

String

Nový řetězec, který je shodný se vstupním řetězcem, s výjimkou toho, že náhradní řetězec se umístí na místo každého odpovídajícího řetězce. Pokud vzor regulárního výrazu neodpovídá v aktuální instanci, vrátí metoda aktuální instanci beze změny.

Výjimky

ArgumentNullException

input nebo replacement je null.

RegexMatchTimeoutException

Došlo k vypršení časového limitu.

Poznámky

Hledání vzoru začíná na začátku input řetězce.

Parametr replacement určuje řetězec, který nahradí každou shodu. replacement může se skládat z jakékoli kombinace literálového textu a nahrazení. Náhrady jsou jediné prvky jazyka regulárních výrazů, které jsou rozpoznány v náhradním vzoru.

Vzhledem k tomu, že metoda vrací input beze změny, pokud neexistuje shoda, můžete použít metodu ReferenceEquals(Object, Object) k určení, zda metoda udělala nějaké nahrazení.

Viz také

• Jazyk regulárních výrazů – stručná referenční dokumentace
• Nahrazení v regulárních výrazech

Replace(String, MatchEvaluator, Int32)

Zdroj:

Regex.Replace.cs

V zadaném vstupním řetězci nahradí zadaný maximální počet řetězců, které odpovídají vzoru regulárního výrazu, řetězcem vráceným delegátem MatchEvaluator .

public:
 System::String ^ Replace(System::String ^ input, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, int count);

public string Replace(string input, System.Text.RegularExpressions.MatchEvaluator evaluator, int count);

member this.Replace : string * System.Text.RegularExpressions.MatchEvaluator * int -> string

Public Function Replace (input As String, evaluator As MatchEvaluator, count As Integer) As String

Parametry

input

String

Řetězec, který chcete vyhledat shodu.

evaluator

MatchEvaluator

Vlastní metoda, která zkoumá každou shodu a vrací buď původní odpovídající řetězec, nebo náhradní řetězec.

count

Int32

Maximální počet výskytů nahrazení.

Návraty

String

Nový řetězec, který je shodný se vstupním řetězcem, s tím rozdílem, že náhradní řetězec přebírá místo každého odpovídajícího řetězce. Pokud vzor regulárního výrazu neodpovídá v aktuální instanci, vrátí metoda aktuální instanci beze změny.

Výjimky

ArgumentNullException

input nebo evaluator je null.

RegexMatchTimeoutException

Došlo k vypršení časového limitu.

Poznámky

Tato metoda je užitečná pro nahrazení shody regulárního výrazu, pokud je splněna některá z následujících podmínek: náhradní řetězec nelze snadno určit vzorem nahrazení regulárního výrazu, výsledky náhradního řetězce ze zpracování odpovídajícího řetězce nebo výsledky náhradního řetězce z podmíněného zpracování.

Metoda je ekvivalentní volání Matches(String) metody a předání prvních countMatch objektů ve vrácených MatchCollection delegátu evaluator .

Pokud count je záporné, nahrazení pokračuje na konec řetězce.

Vzhledem k tomu, že metoda vrací input beze změny, pokud neexistuje shoda, můžete použít metodu ReferenceEquals(Object, Object) k určení, zda metoda udělala nějaké nahrazení.

Viz také

• MatchEvaluator
• Nahrazení v regulárních výrazech
• Jazyk regulárních výrazů – stručná referenční dokumentace