String.ReplaceLineEndings Método

Definição

Sobrecargas

ReplaceLineEndings()

Substitui todas as sequências de nova linha na cadeia de caracteres atual por NewLine.

ReplaceLineEndings(String)

Substitui todas as sequências de nova linha na cadeia de caracteres atual por replacementText.

ReplaceLineEndings()

Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs

Substitui todas as sequências de nova linha na cadeia de caracteres atual por NewLine.

public string ReplaceLineEndings ();

Retornos

Uma cadeia de caracteres cujo conteúdo corresponde à cadeia de caracteres atual, mas com todas as sequências de nova linha substituídas por NewLine.

Comentários

Esse método pesquisa todas as sequências de nova linha dentro da cadeia de caracteres e as canoniza para corresponder à sequência de nova linha para o ambiente atual. Por exemplo, ao executar no Windows, todas as ocorrências de sequências de nova linha não Windows serão substituídas pelo CRLF de sequência. Ao executar no Unix, todas as ocorrências de sequências de nova linha não Unix serão substituídas por um único caractere LF.

Não é recomendável que os analisadores de protocolo utilizem essa API. As especificações de protocolo geralmente exigem sequências de nova linha específicas. Por exemplo, HTTP/1.1 (RFC 8615) exige que as linhas de solicitação, status linha e cabeçalhos terminem com CRLF. Como essa API opera em uma ampla variedade de sequências de nova linha, um analisador de protocolo que utiliza essa API pode exibir comportamentos não pretendidos pelos autores do protocolo.

Essa sobrecarga é equivalente a chamar ReplaceLineEndings(String), passando NewLine como o parâmetro replacementText .

Esse método tem a complexidade garantida de O(n), em que n é o comprimento da cadeia de caracteres de entrada.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET 6, 7, 8, 9

ReplaceLineEndings(String)

Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs

Substitui todas as sequências de nova linha na cadeia de caracteres atual por replacementText.

public string ReplaceLineEndings (string replacementText);

Parâmetros

replacementText
String

O texto a ser usado como substituição.

Retornos

Uma cadeia de caracteres cujo conteúdo corresponde à cadeia de caracteres atual, mas com todas as sequências de nova linha substituídas por replacementText.

Comentários

Esse método pesquisa todas as sequências de nova linha dentro da cadeia de caracteres e as canoniza para a sequência de nova linha fornecida por replacementText. Se replacementText for Empty, todas as sequências de nova linha dentro da cadeia de caracteres serão removidas.

Não é recomendável que os analisadores de protocolo utilizem essa API. As especificações de protocolo geralmente exigem sequências de nova linha específicas. Por exemplo, HTTP/1.1 (RFC 8615) exige que as linhas de solicitação, status linha e cabeçalhos terminem com CRLF. Como essa API opera em uma ampla variedade de sequências de nova linha, um analisador de protocolo que utiliza essa API pode exibir comportamentos não pretendidos pelos autores do protocolo.

A lista de sequências novas reconhecidas é CR (U+000D), LF (U+000A), CRLF (U+000D U+000A), NEL (U+0085), LS (U+2028), FF (U+000C) e PS (U+2029). Essa lista é fornecida pelo Unicode Standard, Sec. 5.8, Recommendation R4 e Table 5-2.

Esse método tem a complexidade garantida de O(n * r), em que n é o comprimento da cadeia de caracteres de entrada e em que r é o comprimento de replacementText.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET 6, 7, 8, 9