String 类

定义

命名空间:
Java.Lang
程序集:
Mono.Android.dll

该 String 类表示字符串。

[Android.Runtime.Register("java/lang/String", DoNotGenerateAcw=true)]
public sealed class String : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ISerializable, Java.Lang.ICharSequence, Java.Lang.IComparable, System.Collections.Generic.IEnumerable<char>
[<Android.Runtime.Register("java/lang/String", DoNotGenerateAcw=true)>]
type String = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ICharSequence
    interface seq<char>
    interface IEnumerable
    interface IComparable
继承
Object
Object
String
属性
RegisterAttribute
实现
IJavaObject IJavaPeerable ISerializable ICharSequence IComparable IEnumerable<Char> IEnumerable IDisposable

注解

该 String 类表示字符串。 Java程序中的所有字符串文本（例如"abc"）都作为此类的实例实现。

字符串是常量;创建后，无法更改其值。 字符串缓冲区支持可变字符串。 由于 String 对象是不可变的，因此可以共享它们。 例如： <blockquote>

String str = "abc";

</blockquote>

等效于： <blockquote>

char data[] = {'a', 'b', 'c'};
                String str = new String(data);

</blockquote>

下面是有关如何使用字符串的更多示例： <blockquote>

System.out.println("abc");
                String cde = "cde";
                System.out.println("abc" + cde);
                String c = "abc".substring(2,3);
                String d = cde.substring(1, 2);

</blockquote>

该类 String 包括用于检查序列的各个字符、比较字符串、搜索字符串、提取子字符串的方法，以及创建字符串的副本，并将所有字符转换为大写或小写。 事例映射基于类指定的 java.lang.Character Character Unicode Standard 版本。

Java语言为字符串串联运算符 （& 和） 提供特殊支持nbsp;+ ，用于将其他对象转换为字符串。 有关字符串串联和转换的其他信息，请参阅Java&贸易;语言规范。

除非另有说明，否则将参数传递给 null 此类中的构造函数或方法将导致 NullPointerException 引发。

A String 表示 UTF-16 格式<的字符串，其中 em>补充字符</em 由 <em>代理项对</em>> 表示（有关详细信息，Character请参阅类中的 Unicode 字符表示形式部分）。 索引值引用 char 代码单位，因此补充字符使用两个 String位置。

除了用于处理 Unicode 代码单元（即值）的方法外，该 String 类还提供处理 Unicode 码位（即 char 字符）的方法。

除非另有说明，否则比较字符串的方法不考虑区域设置。 该 java.text.Collator 类提供用于细粒度、区分区域设置的字符串比较的方法。

在 1.0 中添加。

Java文档java.lang.String。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。

构造函数

名称 说明
String()

创建空字符串。
String(Byte[], Charset)

通过使用指定的 java 解码指定的字节数组来构造新的 String 字节数组。
String(Byte[], Int32, Int32, Charset)

通过使用指定的 java 解码指定的字节的子数组来构造新的 String 字节。
String(Byte[], Int32, Int32, Int32)
已过时.

分配从 8 位整数值的数组的子数组构造的新 String 构造。
String(Byte[], Int32, Int32, String)

通过使用指定的字符集解码指定的字节数组来构造新的 String 字节。
String(Byte[], Int32, Int32)

通过使用平台的默认字符集解码指定的字节数组来构造新的 String 字节。
String(Byte[], Int32)
已过时.

分配从 8 位整数值的数组构造的新 String 包含字符。
String(Byte[], String)

通过使用指定的 java 解码指定的字节数组来构造新的 String 字节数组。
String(Byte[])

通过使用平台的默认字符集解码指定的字节数组来构造新的 String 字节数组。
String(Char[], Int32, Int32)

初始化此字符串以包含给定 char的字符串。
String(Char[])

初始化此字符串以包含给定 char的字符串。
String(Int32[], Int32, Int32)

分配一个新 String 值，其中包含 Unicode 码位数组参数的子数组中的字符。
String(String)

构造与 . 相同的字符 toCopy序列的新字符串。
String(StringBuffer)

分配一个新字符串，其中包含字符串缓冲区参数中当前包含的字符序列。
String(StringBuilder)

分配一个新字符串，其中包含字符串生成器参数中当前包含的字符序列。

属性

名称 说明
CaseInsensitiveOrder

将对象排序 String 为依据 compareToIgnoreCase的比较器。
Class

返回此 Object的运行时类。

(继承自 Object)
Handle

基础 Android 实例的句柄。

(继承自 Object)
IsBlank

true如果字符串为空或仅Character#isWhitespace(int) white space包含代码点，则返回;否则false返回 。
IsEmpty

返回 true if 和 only if #length() ， is 0.
JniIdentityHashCode

该 String 类表示字符串。

(继承自 Object)
JniPeerMembers

该 String 类表示字符串。
PeerReference

该 String 类表示字符串。

(继承自 Object)
ThresholdClass

此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。

(继承自 Object)
ThresholdType

此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。

(继承自 Object)

方法

名称 说明
CharAt(Int32)

返回 char 指定索引处的值。
Clone()

创建并返回此对象的副本。

(继承自 Object)
CodePointAt(Int32)

返回指定索引处的字符（Unicode 码位）。
CodePointBefore(Int32)

返回指定索引前的字符（Unicode 码位）。
CodePointCount(Int32, Int32)

返回此 String指定文本范围内的 Unicode 码位数。
CompareTo(String)

以字典方式比较两个字符串。
CompareToIgnoreCase(String)

比较两个词法字符串，忽略大小写差异。
Concat(String)

将指定的字符串连接到此字符串的末尾。
Contains(ICharSequence)

如果此字符串包含指定的字符值序列，则返回 true。
Contains(String)

如果此字符串包含指定的字符值序列，则返回 true。
ContentEquals(ICharSequence)

将此字符串与指定的 CharSequence字符串进行比较。
ContentEquals(String)

将此字符串与指定的 CharSequence字符串进行比较。
ContentEquals(StringBuffer)

将此字符串与指定的 StringBuffer字符串进行比较。
CopyValueOf(Char[], Int32, Int32)

等效于 #valueOf(char[], int, int)。
CopyValueOf(Char[])

等效于 #valueOf(char[])。
Dispose()

该 String 类表示字符串。

(继承自 Object)
Dispose(Boolean)

该 String 类表示字符串。

(继承自 Object)
EndsWith(String)

测试此字符串是否以指定的后缀结尾。
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
EqualsIgnoreCase(String)

将此 String 与另一个 String比较，忽略大小写注意事项。
Format(Locale, String, Object[])

使用指定的格式字符串和参数返回格式化字符串。
Format(String, Object[])

使用指定的格式字符串和参数返回格式化字符串。
Formatted(Object[])

该 String 类表示字符串。
GetBytes()

使用平台的默认字符集将此值 String 编码为字节序列，将结果存储到新的字节数组中。
GetBytes(Charset)

使用给定 java 将此 String 代码编码为字节序列。
GetBytes(Int32, Int32, Byte[], Int32)
已过时.

将此字符串中的字符复制到目标字节数组中。
GetBytes(String)

使用命名字符集将此 String 结果编码为字节序列，并将结果存储到新的字节数组中。
GetChars(Int32, Int32, Char[], Int32)

将此字符串中的字符复制到目标字符数组中。
GetEnumerator()

该 String 类表示字符串。
GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
Indent(Int32)

根据此字符串的值 n调整此字符串的每一行的缩进，并规范化行终止字符。
IndexOf(Int32, Int32)

返回指定字符的第一个匹配项的此字符串中的索引，从指定索引处开始搜索。
IndexOf(Int32)

返回指定字符的第一个匹配项的此字符串中的索引。
IndexOf(String, Int32)

返回从指定索引开始的指定子字符串的第一个匹配项的此字符串中的索引。
IndexOf(String)

返回指定子字符串的第一个匹配项的此字符串中的索引。
Intern()

返回字符串对象的规范表示形式。
JavaFinalize()

当垃圾回收确定不再引用该对象时，由对象上的垃圾回收器调用。

(继承自 Object)
Join(ICharSequence, ICharSequence[])

返回一个新的字符串，该字符串由 CharSequence elements 联接的副本和指定的 delimiter副本组成。
Join(ICharSequence, IIterable)

返回联接与指定delimiter副本一起联接的新String副本CharSequence elements。
Join(String, IIterable)

返回联接与指定delimiter副本一起联接的新String副本CharSequence elements。
Join(String, String[])

返回一个新的字符串，该字符串由 CharSequence elements 联接的副本和指定的 delimiter副本组成。
LastIndexOf(Int32, Int32)

返回指定字符最后一个匹配项的此字符串中的索引，从指定索引处向后搜索。
LastIndexOf(Int32)

返回指定字符最后一个匹配项的此字符串中的索引。
LastIndexOf(String, Int32)

返回指定子字符串最后一个匹配项的此字符串中的索引，从指定索引处向后搜索。
LastIndexOf(String)

返回指定子字符串最后一个匹配项的此字符串中的索引。
Length()

返回此字符串的长度。
Matches(String)

指示此字符串是否与给定正则表达式匹配。
Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
OffsetByCodePoints(Int32, Int32)

返回此String范围内的索引，该索引与代码点给定indexcodePointOffset的偏移量。
RegionMatches(Boolean, Int32, String, Int32, Int32)

测试两个字符串区域是否相等。
RegionMatches(Int32, String, Int32, Int32)

测试两个字符串区域是否相等。
Repeat(Int32)

返回一个字符串，其值为重复此字符串 count 的串联。
Replace(Char, Char)

返回一个字符串，该字符串中的所有匹配项 oldChar 都替换为 newChar。
Replace(ICharSequence, ICharSequence)

用指定的文字替换序列替换此字符串替换此字符串的每个子字符串。
Replace(String, String)

用指定的文字替换序列替换此字符串替换此字符串的每个子字符串。
ReplaceAll(String, String)

将匹配给定正则表达式的此字符串的每个子字符串替换为给定的替换项。
ReplaceFirst(String, String)

将匹配给定正则表达式的此字符串的第一个子字符串替换为给定的替换项。
SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
Split(String, Int32)

将此字符串拆分为给定正则表达式的匹配项。
Split(String)

将此字符串拆分为给定正则表达式的匹配项。
StartsWith(String, Int32)

测试从指定索引处开始的此字符串的子字符串是否以指定的前缀开头。
StartsWith(String)

测试此字符串是否以指定的前缀开头。
Strip()

返回一个字符串，其值为此字符串，并删除所有前导和尾随 Character#isWhitespace(int) white space 。
StripIndent()

返回一个字符串，其值为此字符串，附带的 Character#isWhitespace（int） 空格从每行的开头和结尾删除。
StripLeading()

返回一个字符串，其值为此字符串，并删除所有前导 Character#isWhitespace(int) white space 。
StripTrailing()

返回一个字符串，其值为此字符串，并删除所有尾随 Character#isWhitespace(int) white space 。
SubSequence(Int32, Int32)

返回此序列的子序列。
SubSequenceFormatted(Int32, Int32)

返回此序列的子序列。
Substring(Int32, Int32)

返回一个字符串，该字符串是此字符串的子字符串。
Substring(Int32)

返回一个字符串，该字符串是此字符串的子字符串。
ToArray<T>()

该 String 类表示字符串。

(继承自 Object)
ToCharArray()

将此字符串转换为新的字符数组。
ToLowerCase()

使用默认区域设置的规则将所有字符 String 转换为小写。
ToLowerCase(Locale)

使用给定Locale的规则将此中的所有String字符转换为小写。
ToString()

该 String 类表示字符串。
ToUpperCase()

使用默认区域设置的规则将所有字符 String 转换为大写。
ToUpperCase(Locale)

使用给定Locale的规则将此中的所有String字符转换为大写。
Transform(IFunction)

此方法允许将函数应用到 this 字符串。
TranslateEscapes()

返回一个字符串，其值为此字符串，转义序列翻译为字符串文本。
Trim()

返回一个字符串，其值为此字符串，删除所有前导和尾随空格，其中空格定义为代码点小于或等于 'U+0020' （空格字符）的任何字符。
UnregisterFromRuntime()

该 String 类表示字符串。

(继承自 Object)
ValueOf(Boolean)

返回参数的 boolean 字符串表示形式。
ValueOf(Char)

返回参数的 char 字符串表示形式。
ValueOf(Char[], Int32, Int32)

返回数组参数的特定子数组的 char 字符串表示形式。
ValueOf(Char[])

返回数组参数的 char 字符串表示形式。
ValueOf(Double)

返回参数的 double 字符串表示形式。
ValueOf(Int32)

返回参数的 int 字符串表示形式。
ValueOf(Int64)

返回参数的 long 字符串表示形式。
ValueOf(Object)

返回参数的 Object 字符串表示形式。
ValueOf(Single)

返回参数的 float 字符串表示形式。
Wait()

使当前线程等待，直到唤醒它，通常是通过 em 通知/em< 或 >em<interrupted>/em<。><>

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted>/em<>，或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted>/em<>，或直到经过一定数量的实时。

(继承自 Object)

显式接口实现

名称 说明
IComparable.CompareTo(Object)

该 String 类表示字符串。
IEnumerable.GetEnumerator()

该 String 类表示字符串。
IJavaPeerable.Disposed()

该 String 类表示字符串。

(继承自 Object)
IJavaPeerable.DisposeUnlessReferenced()

该 String 类表示字符串。

(继承自 Object)
IJavaPeerable.Finalized()

该 String 类表示字符串。

(继承自 Object)
IJavaPeerable.JniManagedPeerState

该 String 类表示字符串。

(继承自 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)

该 String 类表示字符串。

(继承自 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

该 String 类表示字符串。

(继承自 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)

该 String 类表示字符串。

(继承自 Object)

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。
JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult，检查强制是否在Java端有效。
JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。
JavaCast<TResult>(IJavaObject)

该 String 类表示字符串。
SubSequence(ICharSequence, Int32, Int32)

该 String 类表示字符串。
TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult，检查强制是否在Java端有效。

适用于