String Konstruktoren

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.

Überlädt

Name	Beschreibung
String()	Erstellt eine leere Zeichenfolge.
String(Byte[], Int32, Int32, String)	Erstellt eine neue `String` durch Decodieren der angegebenen Unterarray von Bytes mithilfe des angegebenen Zeichensets.
String(Byte[], Int32, Int32, Int32)	Veraltet. Ordnet ein neues `String` , aus einer Unterarray eines Arrays mit 8-Bit-Ganzzahlwerten zu.
String(Byte[], Int32, Int32, Charset)	Erstellt eine neue `String` , indem die angegebene Unterarray von Bytes mithilfe der angegebenen Java decodiert wird.
String(Char[], Int32, Int32)	Initialisiert diese Zeichenfolge so, dass sie die angegebenen `char`Zeichen enthält.
String(Byte[], Int32, Int32)	Erstellt eine neue `String` durch Decodieren der angegebenen Unterarray von Bytes mithilfe des Standardzeichens der Plattform.
String(Byte[], String)	Erstellt ein neues `String` , indem das angegebene Bytearray mithilfe der angegebenen Java decodiert wird.
String(Int32[], Int32, Int32)	Weist eine neue `String` , die Zeichen aus einer Unterarray des Unicode-Codepunktarray-Arguments enthält.
String(Byte[], Charset)	Erstellt ein neues `String` , indem das angegebene Bytearray mithilfe der angegebenen Java decodiert wird.
String(String)	Erstellt eine neue Zeichenfolge mit derselben Abfolge von Zeichen wie `toCopy`.
String(Char[])	Initialisiert diese Zeichenfolge so, dass sie die angegebenen `char`Zeichen enthält.
String(Byte[])	Erstellt ein neues `String` , indem das angegebene Bytearray mithilfe des Standardzeichens der Plattform decodiert wird.
String(StringBuilder)	Weist eine neue Zeichenfolge zu, die die Reihenfolge der Zeichen enthält, die derzeit im Argument "Zeichenfolgen-Generator" enthalten sind.
String(StringBuffer)	Weist eine neue Zeichenfolge zu, die die Reihenfolge der Zeichen enthält, die derzeit im Zeichenfolgenpufferargument enthalten sind.
String(Byte[], Int32)	Veraltet. Ordnet ein neues `String` enthaltende Zeichen zu, das aus einem Array mit 8-Bit-Ganzzahlwerten erstellt wurde.

String()

Erstellt eine leere Zeichenfolge.

[Android.Runtime.Register(".ctor", "()V", "")]
public String();

Attribute: RegisterAttribute

Hinweise

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.

Gilt für:

String(Byte[], Int32, Int32, String)

Erstellt eine neue String durch Decodieren der angegebenen Unterarray von Bytes mithilfe des angegebenen Zeichensets.

[Android.Runtime.Register(".ctor", "([BIILjava/lang/String;)V", "")]
public String(byte[]? bytes, int offset, int length, string charsetName);

[<Android.Runtime.Register(".ctor", "([BIILjava/lang/String;)V", "")>]
new Java.Lang.String : byte[] * int * int * string -> Java.Lang.String

Parameter

bytes: Byte[]

Die Bytes, die in Zeichen decodiert werden sollen

offset: Int32

Der Index des ersten zu decodierenden Bytes

length: Int32

Die Anzahl der Bytes, die decodiert werden sollen

charsetName: String

Der Name eines unterstützten java.nio.charset.Charset-Zeichensets

Attribute: RegisterAttribute

Ausnahmen

NullPointerException

wenn data == null.

IndexOutOfBoundsException

wenn byteCount data.length.

UnsupportedEncodingException

wenn das benannte Zeichensatz nicht unterstützt wird.

Hinweise

Java Dokumentation für java.lang.String.String(byte[], int, int, java.lang.String).

Gilt für:

String(Byte[], Int32, Int32, Int32)

Achtung

deprecated

Ordnet ein neues String , aus einer Unterarray eines Arrays mit 8-Bit-Ganzzahlwerten zu.

[Android.Runtime.Register(".ctor", "([BIII)V", "")]
[System.Obsolete("deprecated")]
public String(byte[]? ascii, int hibyte, int offset, int count);

[<Android.Runtime.Register(".ctor", "([BIII)V", "")>]
[<System.Obsolete("deprecated")>]
new Java.Lang.String : byte[] * int * int * int -> Java.Lang.String

Parameter

ascii: Byte[]

Die Bytes, die in Zeichen konvertiert werden sollen

hibyte: Int32

Die obersten 8 Bits jeder 16-Bit-Unicode-Codeeinheit

offset: Int32

Der anfängliche Offset

count: Int32

Die Länge

Attribute: RegisterAttribute ObsoleteAttribute

Ausnahmen

NullPointerException

wenn data == null.

IndexOutOfBoundsException

wenn byteCount data.length

Hinweise

Ordnet ein neues String , aus einer Unterarray eines Arrays mit 8-Bit-Ganzzahlwerten zu.

Das offset Argument ist der Index des ersten Byte des Unterarrays, und das count Argument gibt die Länge des Unterarrays an.

Jedes byte Unterarray wird in ein char im #String(byte[],int) String(byte[],int) Konstruktor angegebenes Format konvertiert.

Dieses Element ist veraltet. Diese Methode konvertiert Bytes nicht ordnungsgemäß in Zeichen. Ab JDK 1.1, die bevorzugte Methode hierfür ist über die String Konstruktoren, die einen java.nio.charset.CharsetZeichensatznamen verwenden oder die das Standardzeichen der Plattform verwenden.

Java Dokumentation für java.lang.String.String(.*byte[], .*int, .*int, .*int).

Gilt für:

String(Byte[], Int32, Int32, Charset)

Erstellt eine neue String , indem die angegebene Unterarray von Bytes mithilfe der angegebenen Java decodiert wird.

[Android.Runtime.Register(".ctor", "([BIILjava/nio/charset/Charset;)V", "")]
public String(byte[]? bytes, int offset, int length, Java.Nio.Charset.Charset charset);

[<Android.Runtime.Register(".ctor", "([BIILjava/nio/charset/Charset;)V", "")>]
new Java.Lang.String : byte[] * int * int * Java.Nio.Charset.Charset -> Java.Lang.String

Parameter

bytes: Byte[]

Die Bytes, die in Zeichen decodiert werden sollen

offset: Int32

Der Index des ersten zu decodierenden Bytes

length: Int32

Die Anzahl der Bytes, die decodiert werden sollen

charset: Charset

Der zu decodierende Java.nio.charset.Charset-Zeichensatz bytes

Attribute: RegisterAttribute

Ausnahmen

IndexOutOfBoundsException

wenn byteCount data.length

NullPointerException

wenn data == null

Hinweise

Erstellt eine neue String durch Decodieren der angegebenen Unterarray von Bytes mithilfe des angegebenen java.nio.charset.Charset-Zeichensets. Die Länge des neuen String Ist-Elements ist eine Funktion des Zeichensets und ist daher möglicherweise nicht gleich der Länge des Unterarrays.

Diese Methode ersetzt immer falsch formatierte Eingabe- und nicht verwendbare Zeichensequenzen durch die Standardersetzungszeichenfolge dieses Zeichensets. Die java.nio.charset.CharsetDecoder Klasse sollte verwendet werden, wenn mehr Kontrolle über den Decodierungsprozess erforderlich ist.

In 1.6 hinzugefügt.

Java Dokumentation für java.lang.String.String(byte[], int, int, java.nio.charset.Charset).

Gilt für:

String(Char[], Int32, Int32)

Initialisiert diese Zeichenfolge so, dass sie die angegebenen charZeichen enthält.

[Android.Runtime.Register(".ctor", "([CII)V", "")]
public String(char[] data, int offset, int charCount);

[<Android.Runtime.Register(".ctor", "([CII)V", "")>]
new Java.Lang.String : char[] * int * int -> Java.Lang.String

Parameter

data: Char[]

Das Zeichenarray, das zum Initialisieren der Zeichenfolge verwendet wird.

offset: Int32

Der Offset, bei dem der Vorgang ausgeführt wird.

charCount: Int32

Die Anzahl der Zeichen, die aus dem Array verwendet werden sollen.

Attribute: RegisterAttribute

Ausnahmen

NullPointerException

wenn data == null.

IndexOutOfBoundsException

wenn charCount data.length

Hinweise

Gilt für:

String(Byte[], Int32, Int32)

Erstellt eine neue String durch Decodieren der angegebenen Unterarray von Bytes mithilfe des Standardzeichens der Plattform.

[Android.Runtime.Register(".ctor", "([BII)V", "")]
public String(byte[]? bytes, int offset, int length);

[<Android.Runtime.Register(".ctor", "([BII)V", "")>]
new Java.Lang.String : byte[] * int * int -> Java.Lang.String

Parameter

bytes: Byte[]

Die Bytes, die in Zeichen decodiert werden sollen

offset: Int32

Der Index des ersten zu decodierenden Bytes

length: Int32

Die Anzahl der Bytes, die decodiert werden sollen

Attribute: RegisterAttribute

Ausnahmen

NullPointerException

wenn data == null.

IndexOutOfBoundsException

wenn byteCount data.length.

Hinweise

Erstellt eine neue String durch Decodieren der angegebenen Unterarray von Bytes mithilfe des Standardzeichens der Plattform. Die Länge des neuen String Ist-Elements ist eine Funktion des Zeichensets und ist daher möglicherweise nicht gleich der Länge des Unterarrays.

Das Verhalten dieses Konstruktors, wenn die angegebenen Bytes im Standardzeichensatz nicht gültig sind, ist nicht angegeben. Die java.nio.charset.CharsetDecoder Klasse sollte verwendet werden, wenn mehr Kontrolle über den Decodierungsprozess erforderlich ist.

In 1.1 hinzugefügt.

Java Dokumentation für java.lang.String.String(.*byte[], .*int, .*int).

Gilt für:

String(Byte[], String)

Erstellt ein neues String , indem das angegebene Bytearray mithilfe der angegebenen Java decodiert wird.

[Android.Runtime.Register(".ctor", "([BLjava/lang/String;)V", "")]
public String(byte[]? bytes, string charsetName);

[<Android.Runtime.Register(".ctor", "([BLjava/lang/String;)V", "")>]
new Java.Lang.String : byte[] * string -> Java.Lang.String

Parameter

bytes: Byte[]

Die Bytes, die in Zeichen decodiert werden sollen

charsetName: String

Der Name eines unterstützten java.nio.charset.Charset-Zeichensets

Attribute: RegisterAttribute

Ausnahmen

NullPointerException

wenn data == null.

UnsupportedEncodingException

wenn charsetName nicht unterstützt wird.

Hinweise

Erstellt ein neues String Durch Decodieren des angegebenen Bytearrays mithilfe des angegebenen java.nio.charset.Charset-Zeichensets. Die Länge des Neuen String ist eine Funktion des Zeichensets und kann daher nicht gleich der Länge des Bytearrays sein.

Das Verhalten dieses Konstruktors, wenn die angegebenen Bytes in der angegebenen Zeichenmenge nicht gültig sind, ist nicht angegeben. Die java.nio.charset.CharsetDecoder Klasse sollte verwendet werden, wenn mehr Kontrolle über den Decodierungsprozess erforderlich ist.

In 1.1 hinzugefügt.

Java Dokumentation für java.lang.String.String(byte[], java.lang.String).

Gilt für:

String(Int32[], Int32, Int32)

Weist eine neue String , die Zeichen aus einer Unterarray des Unicode-Codepunktarray-Arguments enthält.

[Android.Runtime.Register(".ctor", "([III)V", "")]
public String(int[]? codePoints, int offset, int count);

[<Android.Runtime.Register(".ctor", "([III)V", "")>]
new Java.Lang.String : int[] * int * int -> Java.Lang.String

Parameter

codePoints: Int32[]

Array, das die Quelle von Unicode-Codepunkten ist

offset: Int32

Der anfängliche Offset

count: Int32

Die Länge

Attribute: RegisterAttribute

Ausnahmen

NullPointerException

wenn codePoints == null.

IllegalArgumentException

wenn eines der Elemente codePoints ungültige Unicode-Codepunkte sind.

IndexOutOfBoundsException

wenn offset oder count nicht innerhalb der Grenzen von codePoints.

Hinweise

Weist eine neue String , die Zeichen aus einer Unterarray des Unicode-Codepunktarray-Arguments enthält. Das offset Argument ist der Index des ersten Codepunkts des Unterarrays, und das count Argument gibt die Länge des Unterarrays an. Der Inhalt der Unterarray wird in chars konvertiert. Nachfolgende Änderungen des int Arrays wirken sich nicht auf die neu erstellte Zeichenfolge aus.

Hinzugefügt in 1.5.

Java Dokumentation für java.lang.String.String(.*int[], .*int, .*int).

Gilt für:

String(Byte[], Charset)

Erstellt ein neues String , indem das angegebene Bytearray mithilfe der angegebenen Java decodiert wird.

[Android.Runtime.Register(".ctor", "([BLjava/nio/charset/Charset;)V", "")]
public String(byte[]? bytes, Java.Nio.Charset.Charset charset);

[<Android.Runtime.Register(".ctor", "([BLjava/nio/charset/Charset;)V", "")>]
new Java.Lang.String : byte[] * Java.Nio.Charset.Charset -> Java.Lang.String

Parameter

bytes: Byte[]

Die Bytes, die in Zeichen decodiert werden sollen

charset: Charset

Der zu decodierende Java.nio.charset.Charset-Zeichensatz bytes

Attribute: RegisterAttribute

Ausnahmen

NullPointerException

wenn data == null

Hinweise

In 1.6 hinzugefügt.

Java Dokumentation für java.lang.String.String(byte[], java.nio.charset.Charset).

Gilt für:

String(String)

Erstellt eine neue Zeichenfolge mit derselben Abfolge von Zeichen wie toCopy.

[Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "")]
public String(string toCopy);

[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "")>]
new Java.Lang.String : string -> Java.Lang.String

Parameter

toCopy: String

Die Zeichenfolge, deren Zeichen die neue Zeichenfolge initialisieren.

Attribute: RegisterAttribute

Hinweise

Gilt für:

String(Char[])

Initialisiert diese Zeichenfolge so, dass sie die angegebenen charZeichen enthält.

[Android.Runtime.Register(".ctor", "([C)V", "")]
public String(char[] data);

[<Android.Runtime.Register(".ctor", "([C)V", "")>]
new Java.Lang.String : char[] -> Java.Lang.String

Parameter

data: Char[]

Das Zeichenarray, das zum Initialisieren der Zeichenfolge verwendet wird.

Attribute: RegisterAttribute

Ausnahmen

NullPointerException

wenn data == null

Hinweise

Gilt für:

String(Byte[])

Erstellt ein neues String , indem das angegebene Bytearray mithilfe des Standardzeichens der Plattform decodiert wird.

[Android.Runtime.Register(".ctor", "([B)V", "")]
public String(byte[]? bytes);

[<Android.Runtime.Register(".ctor", "([B)V", "")>]
new Java.Lang.String : byte[] -> Java.Lang.String

Parameter

bytes: Byte[]

Die Bytes, die in Zeichen decodiert werden sollen

Attribute: RegisterAttribute

Hinweise

Erstellt ein neues String , indem das angegebene Bytearray mithilfe des Standardzeichens der Plattform decodiert wird. Die Länge des Neuen String ist eine Funktion des Zeichensets und kann daher nicht gleich der Länge des Bytearrays sein.

In 1.1 hinzugefügt.

Java Dokumentation für java.lang.String.String(.*byte[]).

Gilt für:

String(StringBuilder)

Weist eine neue Zeichenfolge zu, die die Reihenfolge der Zeichen enthält, die derzeit im Argument "Zeichenfolgen-Generator" enthalten sind.

[Android.Runtime.Register(".ctor", "(Ljava/lang/StringBuilder;)V", "")]
public String(Java.Lang.StringBuilder builder);

[<Android.Runtime.Register(".ctor", "(Ljava/lang/StringBuilder;)V", "")>]
new Java.Lang.String : Java.Lang.StringBuilder -> Java.Lang.String

Parameter

builder: StringBuilder

Einen StringBuilder

Attribute: RegisterAttribute

Ausnahmen

NullPointerException

wenn stringBuilder == null.

Hinweise

Weist eine neue Zeichenfolge zu, die die Reihenfolge der Zeichen enthält, die derzeit im Argument "Zeichenfolgen-Generator" enthalten sind. Der Inhalt des Zeichenfolgen-Generators wird kopiert; Die nachfolgende Änderung des Zeichenfolgen-Generators wirkt sich nicht auf die neu erstellte Zeichenfolge aus.

Dieser Konstruktor wird bereitgestellt, um die Migration zu StringBuildererleichtern. Das Abrufen einer Zeichenfolge aus einem Zeichenfolgen-Generator über die toString Methode wird wahrscheinlich schneller ausgeführt und wird im Allgemeinen bevorzugt.

Hinzugefügt in 1.5.

Java Dokumentation für java.lang.String.String(java.lang.StringBuilder).

Gilt für:

String(StringBuffer)

Weist eine neue Zeichenfolge zu, die die Reihenfolge der Zeichen enthält, die derzeit im Zeichenfolgenpufferargument enthalten sind.

[Android.Runtime.Register(".ctor", "(Ljava/lang/StringBuffer;)V", "")]
public String(Java.Lang.StringBuffer buffer);

[<Android.Runtime.Register(".ctor", "(Ljava/lang/StringBuffer;)V", "")>]
new Java.Lang.String : Java.Lang.StringBuffer -> Java.Lang.String

Parameter

buffer: StringBuffer

Einen StringBuffer

Attribute: RegisterAttribute

Hinweise

Weist eine neue Zeichenfolge zu, die die Reihenfolge der Zeichen enthält, die derzeit im Zeichenfolgenpufferargument enthalten sind. Der Inhalt des Zeichenfolgenpuffers wird kopiert; Die nachfolgende Änderung des Zeichenfolgenpuffers wirkt sich nicht auf die neu erstellte Zeichenfolge aus.

Java Dokumentation für java.lang.String.String(java.lang.StringBuffer).

Gilt für:

String(Byte[], Int32)

Achtung

deprecated

Ordnet ein neues String enthaltende Zeichen zu, das aus einem Array mit 8-Bit-Ganzzahlwerten erstellt wurde.

[Android.Runtime.Register(".ctor", "([BI)V", "")]
[System.Obsolete("deprecated")]
public String(byte[]? ascii, int hibyte);

[<Android.Runtime.Register(".ctor", "([BI)V", "")>]
[<System.Obsolete("deprecated")>]
new Java.Lang.String : byte[] * int -> Java.Lang.String

Parameter

ascii: Byte[]

Die Bytes, die in Zeichen konvertiert werden sollen

hibyte: Int32

Die obersten 8 Bits jeder 16-Bit-Unicode-Codeeinheit

Attribute: RegisterAttribute ObsoleteAttribute

Ausnahmen

NullPointerException

wenn data == null.

Hinweise

Ordnet ein neues String enthaltende Zeichen zu, das aus einem Array mit 8-Bit-Ganzzahlwerten erstellt wurde. Jedes Zeichen c in der resultierenden Zeichenfolge wird aus der entsprechenden Komponente b im Bytearray erstellt, sodass:

<b><i>c</i></b> == (char)(((hibyte &amp; 0xff) &lt;&lt; 8)
                                    | (<b><i>b</i></b> &amp; 0xff))

</blockquote>

Java Dokumentation für java.lang.String.String(.*byte[], .*int).

Gilt für: