StringBuilder Klasse

Definition

Namespace:: Java.Lang

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Eine veränderbare Abfolge von Zeichen.

[Android.Runtime.Register("java/lang/StringBuilder", DoNotGenerateAcw=true)]
public sealed class StringBuilder : Java.Lang.AbstractStringBuilder, IDisposable, Java.IO.ISerializable, Java.Lang.IComparable, System.Collections.Generic.IEnumerable<char>

[<Android.Runtime.Register("java/lang/StringBuilder", DoNotGenerateAcw=true)>]
type StringBuilder = class
    inherit AbstractStringBuilder
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IAppendable
    interface ICharSequence
    interface seq<char>
    interface IEnumerable
    interface IComparable

Vererbung: Object

JavaObject

Object

AbstractStringBuilder
StringBuilder

Attribute: RegisterAttribute

Implementiert: IJavaObject IJavaPeerable ISerializable IAppendable ICharSequence IComparable IEnumerable<Char> IEnumerable IDisposable

Hinweise

Eine veränderbare Abfolge von Zeichen. Diese Klasse stellt eine API bereit, die mit StringBufferder API kompatibel ist, aber ohne Garantie für die Synchronisierung. Diese Klasse ist für die Verwendung als Drop-In-Ersatz für Orte vorgesehen, an StringBuffer denen der Zeichenfolgenpuffer von einem einzelnen Thread verwendet wurde (wie im Allgemeinen der Fall). Wenn möglich, wird empfohlen, dass diese Klasse bevorzugt StringBuffer verwendet wird, da sie bei den meisten Implementierungen schneller ist.

Die Prinzipalvorgänge auf a StringBuilder sind die append und insert Methoden, die überladen sind, um Daten eines beliebigen Typs zu akzeptieren. Jedes effektiv konvertiert ein bestimmtes Datum in eine Zeichenfolge und fügt dann die Zeichen dieser Zeichenfolge an den Zeichenfolgen-Generator an oder fügt sie ein. Die Methode fügt diese Zeichen immer am Ende des Generators hinzu. Die appendinsert Methode fügt die Zeichen an einem angegebenen Punkt hinzu.

Wenn beispielsweise z auf ein Zeichenfolgen-Generator-Objekt verwiesen wird, dessen aktueller Inhalt "start" lautet, würde der Methodenaufruf z.append("le") dazu führen, dass der Zeichenfolgen-Generator "startle" enthält, während z.insert(4, "le") der Zeichenfolgen-Generator so geändert würde, dass er "starlet" enthält.

Wenn sb im Allgemeinen auf eine Instanz einer StringBuilder, dann hat die sb.append(x) gleiche Wirkung wie sb.insert(sb.length(), x).

Jeder Zeichenfolgen-Generator verfügt über eine Kapazität. Solange die Länge der im Zeichenfolgen-Generator enthaltenen Zeichensequenz die Kapazität nicht überschreitet, ist es nicht erforderlich, einen neuen internen Puffer zuzuweisen. Wenn der interne Puffer überläuft, wird er automatisch größer.

Instanzen von StringBuilder sind nicht sicher für die Verwendung durch mehrere Threads. Wenn eine solche Synchronisierung erforderlich ist, empfiehlt es sich, diese java.lang.StringBuffer zu verwenden.

Sofern nicht anders angegeben, wird das Übergeben eines null Arguments an einen Konstruktor oder eine Methode in dieser Klasse dazu führen, dass ein NullPointerException Fehler ausgelöst wird.

Hinzugefügt in 1.5.

Java Dokumentation für java.lang.StringBuilder.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

Name	Beschreibung
StringBuilder()	Erstellt einen Zeichenfolgen-Generator ohne Zeichen darin und eine Anfangskapazität von 16 Zeichen.
StringBuilder(ICharSequence)	Erstellt einen Zeichenfolgen-Generator, der dieselben Zeichen wie die angegebene `CharSequence`enthält.
StringBuilder(Int32)	Erstellt einen Zeichenfolgen-Generator ohne Zeichen darin und eine vom Argument angegebene `capacity` Anfangskapazität.
StringBuilder(String)	Erstellt einen Zeichenfolgen-Generator, der auf den Inhalt der angegebenen Zeichenfolge initialisiert wurde.

Eigenschaften

Name	Beschreibung
Class	Gibt die Laufzeitklasse dieses Werts `Object`zurück. (Geerbt von Object)
Handle	Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object)
JniIdentityHashCode	Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object)
JniManagedPeerState	Eine veränderbare Abfolge von Zeichen. (Geerbt von JavaObject)
JniPeerMembers	Ruft die JNI-Metadaten ab, die zum Aufrufen von Mitgliedern dieses Java Peers verwendet werden.
PeerReference	Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object)
ThresholdClass	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von AbstractStringBuilder)
ThresholdType	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von AbstractStringBuilder)

Methoden

Name	Beschreibung
Append(Boolean)	Fügt die Zeichenfolgendarstellung des angegebenen `boolean` Werts an.
Append(Char)	Fügt die Zeichenfolgendarstellung des angegebenen `char` Werts an.
Append(Char[], Int32, Int32)	Fügt die Zeichenfolgendarstellung der angegebenen Teilmenge der `char[]`.
Append(Char[])	Fügt die Zeichenfolgendarstellung des angegebenen `char[]`.
Append(Double)	Fügt die Zeichenfolgendarstellung des angegebenen `double` Werts an.
Append(ICharSequence, Int32, Int32)	Fügt die Zeichenfolgendarstellung der angegebenen Untermenge der .`CharSequence`
Append(ICharSequence)	Fügt die Zeichenfolgendarstellung des angegebenen `CharSequence`.
Append(Int32)	Fügt die Zeichenfolgendarstellung des angegebenen `int` Werts an.
Append(Int64)	Fügt die Zeichenfolgendarstellung des angegebenen `long` Werts an.
Append(Object)	Fügt die Zeichenfolgendarstellung des angegebenen `Object`.
Append(Single)	Fügt die Zeichenfolgendarstellung des angegebenen `float` Werts an.
Append(String, Int32, Int32)	Fügt den angegebenen Wert an diese Zeichensequenz an.
Append(String)	Fügt den Inhalt der angegebenen Zeichenfolge an.
Append(StringBuffer)	Fügt die angegebene `StringBuffer` Sequenz an.
AppendCodePoint(Int32)	Hinzugefügt in 1.
Capacity()	Gibt die Anzahl der Zeichen zurück, die ohne Zuwachs gehalten werden können.
CharAt(Int32)	Gibt das Zeichen bei `index`.
Clone()	Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
CodePointAt(Int32)	Ruft den Unicode-Codepunktwert an der `index`.
CodePointBefore(Int32)	Ruft den Unicode-Codepunktwert ab, der vor dem `index`.
CodePointCount(Int32, Int32)	Berechnet die Anzahl der Unicode-Codepunkte zwischen `start` und `end`.
CompareTo(StringBuilder)	Vergleicht zwei `StringBuilder` Instanzen lexikalisch.
Construct(JniObjectReference, JniObjectReferenceOptions)	Eine veränderbare Abfolge von Zeichen. (Geerbt von JavaObject)
Delete(Int32, Int32)	Löscht eine Abfolge von Zeichen, die durch `start` und `end`.
DeleteCharAt(Int32)	Löscht das Zeichen am angegebenen Index. Verschiebt alle verbleibenden Zeichen nach links.
Dispose()	Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object)
Dispose(Boolean)	Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object)
DisposeUnlessReferenced()	Eine veränderbare Abfolge von Zeichen. (Geerbt von JavaObject)
EnsureCapacity(Int32)	Stellt sicher, dass dieses Objekt über eine Mindestkapazität verfügt, bevor der interne Puffer vergrößert werden muss.
Equals(Object)	Eine veränderbare Abfolge von Zeichen. (Geerbt von JavaObject)
Equals(Object)	Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object)
GetChars(Int32, Int32, Char[], Int32)	Kopiert die angeforderte Abfolge von Zeichen, beginnend `dst` bei `dst`.
GetEnumerator()	Gibt einen Enumerator zurück, der die Zeichen in dieser Sequenz durchläuft.
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
IndexOf(String, Int32)	Sucht nach dem Index des angegebenen Zeichens.
IndexOf(String)	Sucht nach dem ersten Index des angegebenen Zeichens.
Insert(Int32, Boolean)	Fügt die Zeichenfolgendarstellung des angegebenen `boolean` Werts an der angegebenen Einfügemarke `offset`ein.
Insert(Int32, Char)	Fügt die Zeichenfolgendarstellung des angegebenen `char` Werts an der angegebenen Einfügemarke `offset`ein.
Insert(Int32, Char[], Int32, Int32)	Fügt die Zeichenfolgendarstellung der angegebenen Untermenge der angegebenen `char[]`Einfügemarke ein`offset`.
Insert(Int32, Char[])	Fügt die Zeichenfolgendarstellung der angegebenen `char[]` An der angegebenen Einfügemarke `offset`ein.
Insert(Int32, Double)	Fügt die Zeichenfolgendarstellung des angegebenen `double` Werts an der angegebenen Einfügemarke `offset`ein.
Insert(Int32, ICharSequence, Int32, Int32)	Fügt die Zeichenfolgendarstellung der angegebenen Untermenge der angegebenen `CharSequence`Einfügemarke ein`offset`.
Insert(Int32, ICharSequence)	Fügt die Zeichenfolgendarstellung der angegebenen `CharSequence` An der angegebenen Einfügemarke `offset`ein.
Insert(Int32, Int32)	Fügt die Zeichenfolgendarstellung des angegebenen `int` Werts an der angegebenen Einfügemarke `offset`ein.
Insert(Int32, Int64)	Fügt die Zeichenfolgendarstellung des angegebenen `long` Werts an der angegebenen Einfügemarke `offset`ein.
Insert(Int32, Object)	Fügt die Zeichenfolgendarstellung der angegebenen `Object` An der angegebenen Einfügemarke `offset`ein.
Insert(Int32, Single)	Fügt die Zeichenfolgendarstellung des angegebenen `float` Werts an der angegebenen Einfügemarke `offset`ein.
Insert(Int32, String, Int32, Int32)	Fügt den angegebenen Wert in diese Zeichensequenz ein.
Insert(Int32, String)	Fügt die angegebene Zeichenfolge an der angegebenen `offset`Einfügemarke ein.
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object)
LastIndexOf(String, Int32)	Sucht nach dem Index des angegebenen Zeichens.
LastIndexOf(String)	Sucht nach dem letzten Index des angegebenen Zeichens.
Length()	Die aktuelle Länge.
Notify()	Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object)
NotifyAll()	Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object)
OffsetByCodePoints(Int32, Int32)	Gibt den Index zurück, von `codePointOffset`dem Codepunkte versetzt `index` werden.
Replace(Int32, Int32, String)	Ersetzt die angegebene Untermenge in diesem Generator durch die angegebene Zeichenfolge.
Reverse()	Umkehrt die Reihenfolge der Zeichen in diesem Generator.
SetCharAt(Int32, Char)	Legt das Zeichen an der `index`.
SetHandle(IntPtr, JniHandleOwnership)	Legt die Handle-Eigenschaft fest. (Geerbt von Object)
SetLength(Int32)	Legt die aktuelle Länge auf einen neuen Wert fest.
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Eine veränderbare Abfolge von Zeichen. (Geerbt von JavaObject)
SubSequence(Int32, Int32)	Gibt die Untermenge des Zeichens innerhalb des angegebenen Bereichs zurück.
SubSequenceFormatted(Int32, Int32)	Gibt eine `CharSequence` der Untermenge aus dem `start` Index in den `end` Index zurück.
Substring(Int32, Int32)	Gibt den String-Wert der Untermenge aus dem `start` Index in den `end` Index zurück.
Substring(Int32)	Gibt den Zeichenfolgenwert der Untermenge vom `start` Index bis zum aktuellen Ende zurück.
ToArray<T>()	Erstellt ein verwaltetes Array aus diesem Java Arraywrapper. (Geerbt von Object)
ToString()	Gibt den Inhalt dieses Generators zurück.
TrimToSize()	Schneidet alle zusätzlichen Kapazitäten über die aktuelle Länge hinaus ab.
UnregisterFromRuntime()	Hebt die Registrierung dieses Java Peers aus der Interop-Laufzeit auf. (Geerbt von Object)
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em< oder >em<unterbrochen>/em<.><> (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IComparable.CompareTo(Object)	Vergleicht diesen Wert mit dem angegebenen Objekt für die Sortierung.
IEnumerable.GetEnumerator()	Gibt einen nicht generischen Enumerator für die Zeichen in dieser Sequenz zurück.
IJavaPeerable.Disposed()	Eine veränderbare Abfolge von Zeichen. (Geerbt von JavaObject)
IJavaPeerable.Finalized()	Eine veränderbare Abfolge von Zeichen. (Geerbt von JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Eine veränderbare Abfolge von Zeichen. (Geerbt von JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Eine veränderbare Abfolge von Zeichen. (Geerbt von JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Eine veränderbare Abfolge von Zeichen. (Geerbt von JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Eine veränderbare Abfolge von Zeichen. (Geerbt von JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Eine veränderbare Abfolge von Zeichen.

Erweiterungsmethoden

Name	Beschreibung
Append(IAppendable, String, Int32, Int32)	Fügt den angegebenen Wert an diese Zeichensequenz an.
Append(IAppendable, String)	Fügt den angegebenen Wert an diese Zeichensequenz an.
GetJniTypeName(IJavaPeerable)	Ruft den JNI-Namen des Typs der Instanz `self`ab.
JavaAs<TResult>(IJavaPeerable)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.
JavaCast<TResult>(IJavaObject)	Führt eine android-laufzeitgecheckte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Eine veränderbare Abfolge von Zeichen.
SubSequence(ICharSequence, Int32, Int32)	Gibt die Untermenge des Zeichens innerhalb des angegebenen Bereichs zurück.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.

Gilt für: