Regex.Replace Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
In una stringa di input specificata, sostituisce le stringhe che corrispondono a un criterio di espressione regolare con una stringa di sostituzione specificata.
Overload
| Nome | Descrizione |
|---|---|
| Replace(String, String, String, RegexOptions) |
In una stringa di input specificata, sostituisce tutte le stringhe che corrispondono a un'espressione regolare specificata con una stringa di sostituzione specificata. Le opzioni specificate modificano l'operazione corrispondente. |
| Replace(String, String, String, RegexOptions, TimeSpan) |
In una stringa di input specificata, sostituisce tutte le stringhe che corrispondono a un'espressione regolare specificata con una stringa di sostituzione specificata. Parametri aggiuntivi specificano opzioni che modificano l'operazione di corrispondenza e un intervallo di timeout se non viene trovata alcuna corrispondenza. |
| Replace(String, MatchEvaluator, Int32, Int32) |
In una sottostringa di input specificata sostituisce un numero massimo specificato di stringhe che corrispondono a un criterio di espressione regolare con una stringa restituita da un MatchEvaluator delegato. |
| Replace(String, String, MatchEvaluator, RegexOptions) |
In una stringa di input specificata, sostituisce tutte le stringhe che corrispondono a un'espressione regolare specificata con una stringa restituita da un MatchEvaluator delegato. Le opzioni specificate modificano l'operazione corrispondente. |
| Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan) |
In una stringa di input specificata, sostituisce tutte le sottostringhe che corrispondono a un'espressione regolare specificata con una stringa restituita da un MatchEvaluator delegato. Parametri aggiuntivi specificano opzioni che modificano l'operazione di corrispondenza e un intervallo di timeout se non viene trovata alcuna corrispondenza. |
| Replace(String, String, Int32, Int32) |
In una sottostringa di input specificata sostituisce un numero massimo specificato di stringhe che corrispondono a un criterio di espressione regolare con una stringa di sostituzione specificata. |
| Replace(String, String, String) |
In una stringa di input specificata, sostituisce tutte le stringhe che corrispondono a un criterio di espressione regolare specificato con una stringa di sostituzione specificata. |
| Replace(String, String, MatchEvaluator) |
In una stringa di input specificata, sostituisce tutte le stringhe che corrispondono a un'espressione regolare specificata con una stringa restituita da un MatchEvaluator delegato. |
| Replace(String, String, Int32) |
In una stringa di input specificata sostituisce un numero massimo specificato di stringhe che corrispondono a un criterio di espressione regolare con una stringa di sostituzione specificata. |
| Replace(String, MatchEvaluator) |
In una stringa di input specificata, sostituisce tutte le stringhe che corrispondono a un'espressione regolare specificata con una stringa restituita da un MatchEvaluator delegato. |
| Replace(String, String) |
In una stringa di input specificata sostituisce tutte le stringhe che corrispondono a un criterio di espressione regolare con una stringa di sostituzione specificata. |
| Replace(String, MatchEvaluator, Int32) |
In una stringa di input specificata sostituisce un numero massimo specificato di stringhe che corrispondono a un criterio di espressione regolare con una stringa restituita da un MatchEvaluator delegato. |
Replace(String, String, String, RegexOptions)
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
In una stringa di input specificata, sostituisce tutte le stringhe che corrispondono a un'espressione regolare specificata con una stringa di sostituzione specificata. Le opzioni specificate modificano l'operazione corrispondente.
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
Parametri
- input
- String
Stringa in cui cercare una corrispondenza.
- pattern
- String
Modello di espressione regolare da trovare in corrispondenza.
- replacement
- String
Stringa sostitutiva.
- options
- RegexOptions
Combinazione bit per bit dei valori di enumerazione che forniscono opzioni per la corrispondenza.
Valori restituiti
Nuova stringa identica alla stringa di input, ad eccezione del fatto che la stringa di sostituzione ha il posto di ogni stringa corrispondente. Se pattern non corrisponde nell'istanza corrente, il metodo restituisce l'istanza corrente invariata.
Eccezioni
Si è verificato un errore di analisi delle espressioni regolari.
input, patterno replacement è null.
options non è una combinazione bit per bit valida di RegexOptions valori.
Si è verificato un timeout.
Commenti
I metodi statici sono equivalenti Replace(String, String, String, RegexOptions) alla costruzione di un Regex oggetto con il criterio di espressione regolare specificato e la chiamata al metodo Replace(String, String)di istanza .
Il replacement parametro specifica la stringa che sostituisce ogni corrispondenza in input.
replacement può essere costituito da qualsiasi combinazione di testo letterale e sostituzioni. Le sostituzioni sono gli unici elementi del linguaggio delle espressioni regolari riconosciuti in un modello di sostituzione.
Poiché il metodo restituisce input invariato se non esiste alcuna corrispondenza, è possibile utilizzare il ReferenceEquals(Object, Object) metodo per determinare se il metodo ha apportato sostituzioni.
Se si specifica RightToLeft per il options parametro , la ricerca delle corrispondenze inizia alla fine della stringa di input e si sposta a sinistra; in caso contrario, la ricerca inizia all'inizio della stringa di input e si sposta a destra.
Note per i chiamanti
Questo metodo si verifica il timeout dopo un intervallo uguale al valore di timeout predefinito del dominio applicazione in cui viene chiamato. Se per il dominio applicazione non è stato definito un valore di timeout, viene usato il valore InfiniteMatchTimeout, che impedisce il timeout del metodo. Il metodo statico consigliato per sostituire una corrispondenza dei criteri è Replace(String, String, String, RegexOptions, TimeSpan), che consente di impostare l'intervallo di timeout.
Vedi anche
- RegexOptions
- Sostituzioni nelle espressioni regolari
- Elementi del linguaggio delle espressioni regolari
Si applica a
Replace(String, String, String, RegexOptions, TimeSpan)
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
In una stringa di input specificata, sostituisce tutte le stringhe che corrispondono a un'espressione regolare specificata con una stringa di sostituzione specificata. Parametri aggiuntivi specificano opzioni che modificano l'operazione di corrispondenza e un intervallo di timeout se non viene trovata alcuna corrispondenza.
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
Parametri
- input
- String
Stringa in cui cercare una corrispondenza.
- pattern
- String
Modello di espressione regolare da trovare in corrispondenza.
- replacement
- String
Stringa sostitutiva.
- options
- RegexOptions
Combinazione bit per bit dei valori di enumerazione che forniscono opzioni per la corrispondenza.
- matchTimeout
- TimeSpan
Intervallo di timeout o InfiniteMatchTimeout per indicare che il metodo non deve scadere.
Valori restituiti
Nuova stringa identica alla stringa di input, ad eccezione del fatto che la stringa di sostituzione ha il posto di ogni stringa corrispondente. Se pattern non corrisponde nell'istanza corrente, il metodo restituisce l'istanza corrente invariata.
Eccezioni
Si è verificato un errore di analisi delle espressioni regolari.
input, patterno replacement è null.
options non è una combinazione bit per bit valida di RegexOptions valori.
-oppure- matchTimeout è negativo, zero o maggiore di circa 24 giorni.
Si è verificato un timeout.
Commenti
I metodi statici sono equivalenti Replace(String, String, String, RegexOptions, TimeSpan) alla costruzione di un Regex oggetto con il criterio di espressione regolare specificato e la chiamata al metodo Replace(String, String)di istanza .
Il replacement parametro specifica la stringa che sostituisce ogni corrispondenza in input.
replacement può essere costituito da qualsiasi combinazione di testo letterale e sostituzioni. Le sostituzioni sono gli unici elementi del linguaggio delle espressioni regolari riconosciuti in un modello di sostituzione.
Poiché il metodo restituisce input invariato se non esiste alcuna corrispondenza, è possibile utilizzare il ReferenceEquals(Object, Object) metodo per determinare se il metodo ha apportato sostituzioni.
Se si specifica RightToLeft per il options parametro , la ricerca delle corrispondenze inizia alla fine della stringa di input e si sposta a sinistra; in caso contrario, la ricerca inizia all'inizio della stringa di input e si sposta a destra.
Il matchTimeout parametro specifica per quanto tempo un metodo di ricerca dei criteri deve provare a trovare una corrispondenza prima del timeout. L'impostazione di un intervallo di timeout impedisce che le espressioni regolari che si basano su un backtracking eccessivo vengano visualizzate per interrompere la risposta quando elaborano l'input che contiene corrispondenze vicine.
matchTimeout esegue l'override di qualsiasi valore di timeout predefinito definito per il dominio applicazione in cui viene eseguito il metodo.
Note per i chiamanti
È consigliabile impostare il matchTimeout parametro su un valore appropriato, ad esempio due secondi. Se si disabilitano i timeout specificando InfiniteMatchTimeout, il motore delle espressioni regolari offre prestazioni leggermente migliori. Tuttavia, è consigliabile disabilitare i timeout solo nelle condizioni seguenti:
Quando l'input elaborato da un'espressione regolare è derivato da un'origine nota e attendibile o è costituito da testo statico. Questo esclude il testo che è stato immesso dinamicamente dagli utenti.
Quando il criterio di espressione regolare è stato testato accuratamente per garantire che gestisca in modo efficiente corrispondenze, non corrispondenze e corrispondenze vicine.
Quando il criterio di espressione regolare non contiene elementi del linguaggio noti per causare un backtracking eccessivo durante l'elaborazione di una corrispondenza vicina.
Vedi anche
- RegexOptions
- Sostituzioni nelle espressioni regolari
- Elementi del linguaggio delle espressioni regolari
- Backtracking nelle espressioni regolari
- Procedure consigliate per le espressioni regolari in .NET
Si applica a
Replace(String, MatchEvaluator, Int32, Int32)
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
In una sottostringa di input specificata sostituisce un numero massimo specificato di stringhe che corrispondono a un criterio di espressione regolare con una stringa restituita da un MatchEvaluator delegato.
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
Parametri
- input
- String
Stringa in cui cercare una corrispondenza.
- evaluator
- MatchEvaluator
Metodo personalizzato che esamina ogni corrispondenza e restituisce la stringa corrispondente originale o una stringa di sostituzione.
- count
- Int32
Numero massimo di volte in cui verrà eseguita la sostituzione.
- startat
- Int32
Posizione del carattere nella stringa di input in cui inizia la ricerca.
Valori restituiti
Nuova stringa identica alla stringa di input, ad eccezione del fatto che una stringa di sostituzione ha il posto di ogni stringa corrispondente. Se il criterio di espressione regolare non corrisponde nell'istanza corrente, il metodo restituisce l'istanza corrente invariata.
Eccezioni
input o evaluator è null.
startat è minore di zero o maggiore della lunghezza di input.
Si è verificato un timeout.
Commenti
Per altre informazioni su startat, vedere la sezione Osservazioni di Match(String, Int32).
Il metodo passa i primi countMatch oggetti al evaluator delegato.
Vedi anche
- MatchEvaluator
- Sostituzioni nelle espressioni regolari
- Linguaggio di espressioni regolari - Riferimento rapido
Si applica a
Replace(String, String, MatchEvaluator, RegexOptions)
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
In una stringa di input specificata, sostituisce tutte le stringhe che corrispondono a un'espressione regolare specificata con una stringa restituita da un MatchEvaluator delegato. Le opzioni specificate modificano l'operazione corrispondente.
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
Parametri
- input
- String
Stringa in cui cercare una corrispondenza.
- pattern
- String
Modello di espressione regolare da trovare in corrispondenza.
- evaluator
- MatchEvaluator
Metodo personalizzato che esamina ogni corrispondenza e restituisce la stringa corrispondente originale o una stringa di sostituzione.
- options
- RegexOptions
Combinazione bit per bit dei valori di enumerazione che forniscono opzioni per la corrispondenza.
Valori restituiti
Nuova stringa identica alla stringa di input, ad eccezione del fatto che una stringa di sostituzione ha il posto di ogni stringa corrispondente. Se pattern non corrisponde nell'istanza corrente, il metodo restituisce l'istanza corrente invariata.
Eccezioni
Si è verificato un errore di analisi delle espressioni regolari.
input, patterno evaluator è null.
options non è una combinazione bit per bit valida di RegexOptions valori.
Si è verificato un timeout.
Commenti
Questo metodo è utile per sostituire una corrispondenza di un'espressione regolare se una delle condizioni seguenti è vera: la stringa di sostituzione non può essere specificata facilmente da un criterio di sostituzione di un'espressione regolare, dalla stringa di sostituzione risultante dall'elaborazione della stringa corrispondente o dai risultati della stringa di sostituzione dall'elaborazione condizionale.
Il metodo equivale a chiamare il Matches(String, String) metodo e passare ogni Match oggetto nell'oggetto restituito MatchCollection al evaluator delegato.
Poiché il metodo restituisce input invariato se non esiste alcuna corrispondenza, è possibile utilizzare il ReferenceEquals(Object, Object) metodo per determinare se il metodo ha apportato sostituzioni.
Se si specifica RightToLeft per il options parametro , la ricerca delle corrispondenze inizia alla fine della stringa di input e si sposta a sinistra; in caso contrario, la ricerca inizia all'inizio della stringa di input e si sposta a destra.
Vedi anche
- MatchEvaluator
- RegexOptions
- Sostituzioni nelle espressioni regolari
- Elementi del linguaggio delle espressioni regolari
Si applica a
Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan)
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
In una stringa di input specificata, sostituisce tutte le sottostringhe che corrispondono a un'espressione regolare specificata con una stringa restituita da un MatchEvaluator delegato. Parametri aggiuntivi specificano opzioni che modificano l'operazione di corrispondenza e un intervallo di timeout se non viene trovata alcuna corrispondenza.
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
Parametri
- input
- String
Stringa in cui cercare una corrispondenza.
- pattern
- String
Modello di espressione regolare da trovare in corrispondenza.
- evaluator
- MatchEvaluator
Metodo personalizzato che esamina ogni corrispondenza e restituisce la stringa corrispondente originale o una stringa di sostituzione.
- options
- RegexOptions
Combinazione bit per bit dei valori di enumerazione che forniscono opzioni per la corrispondenza.
- matchTimeout
- TimeSpan
Intervallo di timeout o InfiniteMatchTimeout per indicare che il metodo non deve scadere.
Valori restituiti
Nuova stringa identica alla stringa di input, ad eccezione del fatto che una stringa di sostituzione ha il posto di ogni stringa corrispondente. Se pattern non corrisponde nell'istanza corrente, il metodo restituisce l'istanza corrente invariata.
Eccezioni
Si è verificato un errore di analisi delle espressioni regolari.
input, patterno evaluator è null.
options non è una combinazione bit per bit valida di RegexOptions valori.
-oppure- matchTimeout è negativo, zero o maggiore di circa 24 giorni.
Si è verificato un timeout.
Commenti
Questo metodo è utile per sostituire una corrispondenza di un'espressione regolare se una delle condizioni seguenti è vera: la stringa di sostituzione non può essere specificata facilmente da un criterio di sostituzione di un'espressione regolare, dalla stringa di sostituzione risultante dall'elaborazione della stringa corrispondente o dai risultati della stringa di sostituzione dall'elaborazione condizionale.
Il metodo equivale a chiamare il Matches(String, String) metodo e passare ogni Match oggetto nell'oggetto restituito MatchCollection al evaluator delegato.
Poiché il metodo restituisce input invariato se non esiste alcuna corrispondenza, è possibile utilizzare il ReferenceEquals(Object, Object) metodo per determinare se il metodo ha apportato sostituzioni.
Se si specifica RightToLeft per il options parametro , la ricerca delle corrispondenze inizia alla fine della stringa di input e si sposta a sinistra; in caso contrario, la ricerca inizia all'inizio della stringa di input e si sposta a destra.
Il matchTimeout parametro specifica per quanto tempo un metodo di corrispondenza dei criteri deve tentare di trovare una corrispondenza prima del timeout. matchTimeout Esegue l'override di qualsiasi valore di timeout predefinito definito per il dominio applicazione in cui viene eseguito il metodo.
Note per i chiamanti
È consigliabile impostare il matchTimeout parametro su un valore appropriato, ad esempio due secondi. Se si disabilitano i timeout specificando InfiniteMatchTimeout, il motore delle espressioni regolari offre prestazioni leggermente migliori. Tuttavia, è consigliabile disabilitare i timeout solo nelle condizioni seguenti:
Quando l'input elaborato da un'espressione regolare è derivato da un'origine nota e attendibile o è costituito da testo statico. Questo esclude il testo che è stato immesso dinamicamente dagli utenti.
Quando il criterio di espressione regolare è stato testato accuratamente per garantire che gestisca in modo efficiente corrispondenze, non corrispondenze e corrispondenze vicine.
Quando il criterio di espressione regolare non contiene elementi del linguaggio noti per causare un backtracking eccessivo durante l'elaborazione di una corrispondenza vicina.
Vedi anche
- RegexOptions
- Sostituzioni nelle espressioni regolari
- Elementi del linguaggio delle espressioni regolari
- Backtracking nelle espressioni regolari
- Procedure consigliate per le espressioni regolari in .NET
Si applica a
Replace(String, String, Int32, Int32)
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
In una sottostringa di input specificata sostituisce un numero massimo specificato di stringhe che corrispondono a un criterio di espressione regolare con una stringa di sostituzione specificata.
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
Parametri
- input
- String
Stringa in cui cercare una corrispondenza.
- replacement
- String
Stringa sostitutiva.
- count
- Int32
Numero massimo di volte in cui può verificarsi la sostituzione.
- startat
- Int32
Posizione del carattere nella stringa di input in cui inizia la ricerca.
Valori restituiti
Nuova stringa identica alla stringa di input, ad eccezione del fatto che la stringa di sostituzione ha il posto di ogni stringa corrispondente. Se il criterio di espressione regolare non corrisponde nell'istanza corrente, il metodo restituisce l'istanza corrente invariata.
Eccezioni
input o replacement è null.
startat è minore di zero o maggiore della lunghezza di input.
Si è verificato un timeout.
Commenti
Per altre informazioni su startat, vedere la sezione Osservazioni di Match(String, Int32).
Il replacement parametro specifica la stringa che sostituisce ogni corrispondenza e supporta le sostituzioni.
Se count è negativo, le sostituzioni continuano alla fine della stringa.
Vedi anche
Si applica a
Replace(String, String, String)
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
In una stringa di input specificata, sostituisce tutte le stringhe che corrispondono a un criterio di espressione regolare specificato con una stringa di sostituzione specificata.
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
Parametri
- input
- String
Stringa in cui cercare una corrispondenza.
- pattern
- String
Modello di espressione regolare da trovare in corrispondenza.
- replacement
- String
Stringa sostitutiva.
Valori restituiti
Nuova stringa identica alla stringa di input, ad eccezione del fatto che la stringa di sostituzione ha il posto di ogni stringa corrispondente. Se pattern non corrisponde nell'istanza corrente, il metodo restituisce l'istanza corrente invariata.
Eccezioni
Si è verificato un errore di analisi delle espressioni regolari.
input, patterno replacement è null.
Si è verificato un timeout.
Commenti
I metodi statici sono equivalenti Replace(String, String, String) alla costruzione di un Regex oggetto con il criterio di espressione regolare specificato e la chiamata al metodo Replace(String, String)di istanza .
Il replacement parametro specifica la stringa che sostituisce ogni corrispondenza in input.
replacement può essere costituito da qualsiasi combinazione di testo letterale e sostituzioni. Le sostituzioni sono gli unici elementi del linguaggio delle espressioni regolari riconosciuti in un modello di sostituzione.
Poiché il metodo restituisce input invariato se non esiste alcuna corrispondenza, è possibile utilizzare il ReferenceEquals(Object, Object) metodo per determinare se il metodo ha apportato sostituzioni.
Note per i chiamanti
Questo metodo si verifica il timeout dopo un intervallo uguale al valore di timeout predefinito del dominio applicazione in cui viene chiamato. Se per il dominio applicazione non è stato definito un valore di timeout, viene usato il valore InfiniteMatchTimeout, che impedisce il timeout del metodo. Il metodo statico consigliato per sostituire una corrispondenza dei criteri è Replace(String, String, String, RegexOptions, TimeSpan), che consente di impostare l'intervallo di timeout.
Vedi anche
Si applica a
Replace(String, String, MatchEvaluator)
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
In una stringa di input specificata, sostituisce tutte le stringhe che corrispondono a un'espressione regolare specificata con una stringa restituita da un MatchEvaluator delegato.
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
Parametri
- input
- String
Stringa in cui cercare una corrispondenza.
- pattern
- String
Modello di espressione regolare da trovare in corrispondenza.
- evaluator
- MatchEvaluator
Metodo personalizzato che esamina ogni corrispondenza e restituisce la stringa corrispondente originale o una stringa di sostituzione.
Valori restituiti
Nuova stringa identica alla stringa di input, ad eccezione del fatto che una stringa di sostituzione ha il posto di ogni stringa corrispondente. Se pattern non corrisponde nell'istanza corrente, il metodo restituisce l'istanza corrente invariata.
Eccezioni
Si è verificato un errore di analisi delle espressioni regolari.
input, patterno evaluator è null.
Si è verificato un timeout.
Commenti
Questo metodo è utile per sostituire una corrispondenza di un'espressione regolare se una delle condizioni seguenti è vera: la stringa di sostituzione non può essere specificata facilmente da un criterio di sostituzione di un'espressione regolare, dalla stringa di sostituzione risultante dall'elaborazione della stringa corrispondente o dai risultati della stringa di sostituzione dall'elaborazione condizionale.
Il metodo equivale a chiamare il Matches(String, String) metodo e passare ogni Match oggetto nell'oggetto restituito MatchCollection al evaluator delegato.
Poiché il metodo restituisce input invariato se non esiste alcuna corrispondenza, è possibile utilizzare il ReferenceEquals(Object, Object) metodo per determinare se il metodo ha apportato sostituzioni.
Note per i chiamanti
Questo metodo si verifica il timeout dopo un intervallo uguale al valore di timeout predefinito del dominio applicazione in cui viene chiamato. Se per il dominio applicazione non è stato definito un valore di timeout, viene usato il valore InfiniteMatchTimeout, che impedisce il timeout del metodo. Il metodo statico consigliato per la valutazione e la sostituzione di una corrispondenza dei criteri è Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan), che consente di impostare l'intervallo di timeout.
Vedi anche
- MatchEvaluator
- Sostituzioni nelle espressioni regolari
- Elementi del linguaggio delle espressioni regolari
Si applica a
Replace(String, String, Int32)
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
In una stringa di input specificata sostituisce un numero massimo specificato di stringhe che corrispondono a un criterio di espressione regolare con una stringa di sostituzione specificata.
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
Parametri
- input
- String
Stringa in cui cercare una corrispondenza.
- replacement
- String
Stringa sostitutiva.
- count
- Int32
Numero massimo di volte in cui può verificarsi la sostituzione.
Valori restituiti
Nuova stringa identica alla stringa di input, ad eccezione del fatto che la stringa di sostituzione ha il posto di ogni stringa corrispondente. Se il criterio di espressione regolare non corrisponde nell'istanza corrente, il metodo restituisce l'istanza corrente invariata.
Eccezioni
input o replacement è null.
Si è verificato un timeout.
Commenti
La ricerca inizia all'inizio della input stringa. Il replacement parametro specifica la stringa che sostituisce ogni corrispondenza e supporta le sostituzioni.
Se count è negativo, le sostituzioni continuano alla fine della stringa.
Poiché il metodo restituisce input invariato se non esiste alcuna corrispondenza, è possibile utilizzare il ReferenceEquals(Object, Object) metodo per determinare se il metodo ha apportato sostituzioni.
Vedi anche
Si applica a
Replace(String, MatchEvaluator)
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
In una stringa di input specificata, sostituisce tutte le stringhe che corrispondono a un'espressione regolare specificata con una stringa restituita da un MatchEvaluator delegato.
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
Parametri
- input
- String
Stringa in cui cercare una corrispondenza.
- evaluator
- MatchEvaluator
Metodo personalizzato che esamina ogni corrispondenza e restituisce la stringa corrispondente originale o una stringa di sostituzione.
Valori restituiti
Nuova stringa identica alla stringa di input, ad eccezione del fatto che una stringa di sostituzione ha il posto di ogni stringa corrispondente. Se il criterio di espressione regolare non corrisponde nell'istanza corrente, il metodo restituisce l'istanza corrente invariata.
Eccezioni
input o evaluator è null.
Si è verificato un timeout.
Commenti
Questo metodo è utile per sostituire una corrispondenza di un'espressione regolare se una delle condizioni seguenti è vera: la stringa di sostituzione non può essere specificata facilmente da un criterio di sostituzione di un'espressione regolare, dalla stringa di sostituzione risultante dall'elaborazione della stringa corrispondente o dai risultati della stringa di sostituzione dall'elaborazione condizionale.
Il metodo equivale a chiamare il Matches(String) metodo e passare ogni Match oggetto nell'oggetto restituito MatchCollection al evaluator delegato.
Poiché il metodo restituisce input invariato se non esiste alcuna corrispondenza, è possibile utilizzare il ReferenceEquals(Object, Object) metodo per determinare se il metodo ha apportato sostituzioni.
Vedi anche
- MatchEvaluator
- Sostituzioni nelle espressioni regolari
- Linguaggio di espressioni regolari - Riferimento rapido
Si applica a
Replace(String, String)
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
In una stringa di input specificata sostituisce tutte le stringhe che corrispondono a un criterio di espressione regolare con una stringa di sostituzione specificata.
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
Parametri
- input
- String
Stringa in cui cercare una corrispondenza.
- replacement
- String
Stringa sostitutiva.
Valori restituiti
Nuova stringa identica alla stringa di input, ad eccezione del fatto che la stringa di sostituzione ha il posto di ogni stringa corrispondente. Se il criterio di espressione regolare non corrisponde nell'istanza corrente, il metodo restituisce l'istanza corrente invariata.
Eccezioni
input o replacement è null.
Si è verificato un timeout.
Commenti
La ricerca del criterio inizia all'inizio della input stringa.
Il replacement parametro specifica la stringa che sostituisce ogni corrispondenza.
replacement può essere costituito da qualsiasi combinazione di testo letterale e sostituzioni. Le sostituzioni sono gli unici elementi del linguaggio delle espressioni regolari riconosciuti in un modello di sostituzione.
Poiché il metodo restituisce input invariato se non esiste alcuna corrispondenza, è possibile utilizzare il ReferenceEquals(Object, Object) metodo per determinare se il metodo ha apportato sostituzioni.
Vedi anche
Si applica a
Replace(String, MatchEvaluator, Int32)
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
- Origine:
- Regex.Replace.cs
In una stringa di input specificata sostituisce un numero massimo specificato di stringhe che corrispondono a un criterio di espressione regolare con una stringa restituita da un MatchEvaluator delegato.
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
Parametri
- input
- String
Stringa in cui cercare una corrispondenza.
- evaluator
- MatchEvaluator
Metodo personalizzato che esamina ogni corrispondenza e restituisce la stringa corrispondente originale o una stringa di sostituzione.
- count
- Int32
Numero massimo di volte in cui verrà eseguita la sostituzione.
Valori restituiti
Nuova stringa identica alla stringa di input, ad eccezione del fatto che una stringa di sostituzione ha il posto di ogni stringa corrispondente. Se il criterio di espressione regolare non corrisponde nell'istanza corrente, il metodo restituisce l'istanza corrente invariata.
Eccezioni
input o evaluator è null.
Si è verificato un timeout.
Commenti
Questo metodo è utile per sostituire una corrispondenza di un'espressione regolare se una delle condizioni seguenti è vera: la stringa di sostituzione non può essere specificata facilmente da un criterio di sostituzione di un'espressione regolare, dalla stringa di sostituzione risultante dall'elaborazione della stringa corrispondente o dai risultati della stringa di sostituzione dall'elaborazione condizionale.
Il metodo equivale a chiamare il Matches(String) metodo e passare i primi countMatch oggetti nell'oggetto restituito MatchCollection al evaluator delegato.
Se count è negativo, le sostituzioni continuano alla fine della stringa.
Poiché il metodo restituisce input invariato se non esiste alcuna corrispondenza, è possibile utilizzare il ReferenceEquals(Object, Object) metodo per determinare se il metodo ha apportato sostituzioni.
Vedi anche
- MatchEvaluator
- Sostituzioni nelle espressioni regolari
- Linguaggio di espressioni regolari - Riferimento rapido