Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo StringBuilder.Append (String, Int32, Int32)

 

Data di pubblicazione: ottobre 2016

Accoda una copia della sottostringa specificata a questa istanza.

Spazio dei nomi:   System.Text
Assembly:  mscorlib (in mscorlib.dll)

public StringBuilder Append(
	string value,
	int startIndex,
	int count
)

Parametri

value
Type: System.String

Stringa che contiene la sottostringa da accodare.

startIndex
Type: System.Int32

Posizione iniziale della sottostringa all'interno di value.

count
Type: System.Int32

Numero di caratteri in value da accodare.

Valore restituito

Type: System.Text.StringBuilder

Riferimento a questa istanza dopo il completamento dell'operazione di accodamento.

Exception Condition
ArgumentNullException

value è null e startIndex e count sono diversi da zero.

ArgumentOutOfRangeException

count è minore di zero.

-oppure-

startIndex è minore di zero.

-oppure-

La somma di startIndex e count è maggiore della lunghezza di value.

-oppure-

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Questo metodo aggiunge l'intervallo specificato di caratteri in value all'istanza corrente. Se value è null e startIndex e count sono entrambi pari a zero, non vengono apportate modifiche.

Il Append(String, Int32, Int32) modificato dal metodo di istanza esistente di questa classe, non restituisce una nuova istanza della classe. Per questo motivo, è possibile chiamare un metodo o una proprietà sul riferimento esistente e non è necessario assegnare il valore restituito per un StringBuilder dell'oggetto, come illustrato nell'esempio seguente.

string str = "First;George Washington;1789;1797";
int index = 0;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
int length = str.IndexOf(';', index);      
sb.Append(str, index, length).Append(" President of the United States: ");
index += length + 1;
length = str.IndexOf(';', index) - index;
sb.Append(str, index, length).Append(", from ");
index += length + 1;
length = str.IndexOf(';', index) - index;
sb.Append(str, index, length).Append(" to ");
index += length + 1;
sb.Append(str, index, str.Length - index);
Console.WriteLine(sb);
// The example displays the following output:
//    First President of the United States: George Washington, from 1789 to 1797      

La capacità di questa istanza viene regolata in base alle esigenze.

Note per i chiamanti:

Nel.NET Framework 4 e .NET Framework 4.5, quando si crea un'istanza di StringBuilder oggetto chiamando il StringBuilder(Int32, Int32) costruttore, sia la lunghezza e la capacità del StringBuilder istanza può crescere oltre il valore di relativo MaxCapacity proprietà. Questa situazione può verificarsi in particolare quando si chiama il Append e AppendFormat metodi per aggiungere stringhe di piccole dimensioni.

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 1.1
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: