StringBuilder 類別

定義

命名空間:: Java.Lang

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

一串可變的字元。

[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

繼承: Object

JavaObject

Object

AbstractStringBuilder
StringBuilder

屬性: RegisterAttribute

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

備註

一串可變的字元。此類別提供與相容 StringBuffer的 API，但無法保證同步。此類別設計用於 StringBuffer 字串緩衝區由單一執行緒使用的情況（通常如此）。在可能的情況下，建議優先使用此 StringBuffer 類別，因為在大多數實作下會更快。

a StringBuilder 上的主要操作是和 appendinsert 方法，這些方法被超載以接受任何類型的資料。每個資料實際上將給定資料轉換成字串，然後附加或插入該字串的字元到字串建置器中。該 append 方法總是在建構器結尾加入這些字元; insert 該方法則在指定點加入字元。

例如，若z指的是目前內容為「start」的字串建構物件，則該方法呼叫z.append("le")會使字串建構器包含「startle」，而z.insert(4, "le")則會將字串建構器改為「」。starlet

一般而言，若 sb 指的是的 StringBuilder實例，則 sb.append(x) 效果與 sb.insert(sb.length(), x)相同。

每個弦組師都有自己的能力。只要字串建構器中字元序列的長度不超過容量，就不需要重新分配內部緩衝區。如果內部緩衝區溢出，緩衝區會自動變大。

的 StringBuilder 實例不適合多個執行緒使用。若需要此類同步，建議 java.lang.StringBuffer 使用。

除非另有說明，將參數傳遞 null 給此類別中的建構子或方法會導致拋出 a NullPointerException 。

已在1.5中新增。

Java 文件 java.lang.StringBuilder。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

建構函式

名稱	Description
StringBuilder()	構建一個字串建構器，沒有字元，初始容量為 16 個字元。
StringBuilder(ICharSequence)	構造一個字串建構器，包含與指定 `CharSequence`相同的字元。
StringBuilder(Int32)	構造一個字串建構器，沒有字元，並由參數指定 `capacity` 初始容量。
StringBuilder(String)	建構一個以指定字串內容初始化的字串建構器。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	一串可變的字元。 (繼承來源 JavaObject)
JniPeerMembers	取得用於調用此 Java 節點成員的 JNI 元資料。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 AbstractStringBuilder)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 AbstractStringBuilder)

方法

名稱	Description
Append(Boolean)	附加指定值的 `boolean` 字串表示。
Append(Char)	附加指定值的 `char` 字串表示。
Append(Char[], Int32, Int32)	附加指定子集 `char[]`的字串表示。
Append(Char[])	附加指定 `char[]`的字串表示。
Append(Double)	附加指定值的 `double` 字串表示。
Append(ICharSequence, Int32, Int32)	附加指定子序列 `CharSequence`的字串表示。
Append(ICharSequence)	附加指定 `CharSequence`的字串表示。
Append(Int32)	附加指定值的 `int` 字串表示。
Append(Int64)	附加指定值的 `long` 字串表示。
Append(Object)	附加指定 `Object`的字串表示。
Append(Single)	附加指定值的 `float` 字串表示。
Append(String, Int32, Int32)	將指定值附加於此字元序列。
Append(String)	附加指定字串的內容。
Append(StringBuffer)	將指定 `StringBuffer` 內容附加於此序列。
AppendCodePoint(Int32)	新增 1.
Capacity()	回傳可持有且不成長字元的數量。
CharAt(Int32)	返回該字元於 `index`。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
CodePointAt(Int32)	取得 Unicode 碼點值於 `index`。
CodePointBefore(Int32)	取得 Unicode 碼點值，該值位於 `index`. 之前。
CodePointCount(Int32, Int32)	計算與 `start`之間的 `end` Unicode 碼點數量。
CompareTo(StringBuilder)	以字典序比較兩個 `StringBuilder` 實例。
Construct(JniObjectReference, JniObjectReferenceOptions)	一串可變的字元。 (繼承來源 JavaObject)
Delete(Int32, Int32)	刪除由 `start` 和 `end`指定的一串字元。
DeleteCharAt(Int32)	刪除指定索引中的角色。將剩餘字元向左移動。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	一串可變的字元。 (繼承來源 JavaObject)
EnsureCapacity(Int32)	確保該物件在需要擴大內部緩衝區前，具備最低可用容量。
Equals(Object)	一串可變的字元。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetChars(Int32, Int32, Char[], Int32)	將請求的字元 `dst` 序列從轉到 `dst`。
GetEnumerator()	回傳一個枚舉器，會遍歷此序列中的字元。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
IndexOf(String, Int32)	搜尋指定字元的索引。
IndexOf(String)	搜尋指定字元的第一個索引。
Insert(Int32, Boolean)	在指定`boolean`值處插入字串表示`offset`。
Insert(Int32, Char)	在指定`char`值處插入字串表示`offset`。
Insert(Int32, Char[], Int32, Int32)	在指定`char[]`位置插入指定子序列`offset`的字串表示。
Insert(Int32, Char[])	在指定`char[]`位置插入指定的`offset`字串表示。
Insert(Int32, Double)	在指定`double`值處插入字串表示`offset`。
Insert(Int32, ICharSequence, Int32, Int32)	在指定`CharSequence`位置插入指定子序列`offset`的字串表示。
Insert(Int32, ICharSequence)	在指定`CharSequence`位置插入指定的`offset`字串表示。
Insert(Int32, Int32)	在指定`int`值處插入字串表示`offset`。
Insert(Int32, Int64)	在指定`long`值處插入字串表示`offset`。
Insert(Int32, Object)	在指定`Object`位置插入指定的`offset`字串表示。
Insert(Int32, Single)	在指定`float`值處插入字串表示`offset`。
Insert(Int32, String, Int32, Int32)	將指定值插入此字元序列中。
Insert(Int32, String)	在指定的 `offset`處插入指定的字串。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
LastIndexOf(String, Int32)	搜尋指定字元的索引。
LastIndexOf(String)	搜尋指定字元的最後一個索引。
Length()	目前的長度。
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
OffsetByCodePoints(Int32, Int32)	回傳與 `codePointOffset`相偏移`index`的索引。
Repeat(ICharSequence, Int32)	將指定 CharSequence c 的計數副本附加到此序列上。
Repeat(Int32, Int32)	重複次數計數 codePoint 參數字串表示的複本數到此序列。
Repeat(String, Int32)	一串可變的字元。
Replace(Int32, Int32, String)	將此建構器中指定的子序列替換為指定的字串。
Reverse()	此建構器中角色的順序反轉。
SetCharAt(Int32, Char)	將字元設於 `index`。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetLength(Int32)	將目前長度設定為新值。
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	一串可變的字元。 (繼承來源 JavaObject)
SubSequence(Int32, Int32)	回傳指定範圍內的字元子序列。
SubSequenceFormatted(Int32, Int32)	從索引回傳子序列`CharSequence`的 `start` a`end`。
Substring(Int32, Int32)	從索引回傳子序列 `start` 的 String 值到索引 `end` 。
Substring(Int32)	回傳子序列從 `start` 索引到當前端的 String 值。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳這個建構商的內容。
TrimToSize()	切除超出現有長度的多餘容量。
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IComparable.CompareTo(Object)	將此值與指定的排序物件比較。
IEnumerable.GetEnumerator()	回傳此序列中字元的非通用列舉器。
IJavaPeerable.Disposed()	一串可變的字元。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	一串可變的字元。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	一串可變的字元。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	一串可變的字元。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	一串可變的字元。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	一串可變的字元。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	一串可變的字元。

擴充方法

名稱	Description
Append(IAppendable, String, Int32, Int32)	將指定值附加於此字元序列。
Append(IAppendable, String)	將指定值附加於此字元序列。
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	一串可變的字元。
SubSequence(ICharSequence, Int32, Int32)	回傳指定範圍內的字元子序列。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於