String Classe

Definizione

Spazio dei nomi:: Java.Lang

Assembly:: Mono.Android.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

La String classe rappresenta le stringhe di caratteri.

[Android.Runtime.Register("java/lang/String", DoNotGenerateAcw=true)]
public sealed class String : Java.Lang.Object, IDisposable, 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

Ereditarietà: Object

JavaObject

Object
String

Attributi: RegisterAttribute

Implementazioni: IJavaObject IJavaPeerable ISerializable ICharSequence IComparable IEnumerable<Char> IEnumerable IDisposable

Commenti

La String classe rappresenta le stringhe di caratteri. Tutti i valori letterali stringa nei programmi Java, ad esempio "abc", vengono implementati come istanze di questa classe.

Le stringhe sono costanti; Non è possibile modificare i valori dopo la creazione. I buffer stringa supportano stringhe modificabili. Poiché gli oggetti String non sono modificabili, possono essere condivisi. Ad esempio: <blockquote>

String str = "abc";

</blockquote>

equivale a: <blockquote>

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

</blockquote>

Ecco alcuni esempi di come usare le stringhe: <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>

La classe String include metodi per esaminare i singoli caratteri della sequenza, per il confronto di stringhe, per la ricerca di stringhe, per l'estrazione di sottostringhe e per la creazione di una copia di una stringa con tutti i caratteri tradotti in lettere maiuscole o minuscole. Il mapping tra maiuscole e minuscole si basa sulla versione Standard Unicode specificata dalla java.lang.Character Character classe .

Il linguaggio Java offre un supporto speciale per l'operatore di concatenazione di stringhe (& nbsp;+& nbsp;) e per la conversione di altri oggetti in stringhe. Per altre informazioni sulla concatenazione e la conversione delle stringhe, vedere La Java e la conversione commercio; Specifica del linguaggio.

Se non diversamente specificato, il passaggio di un null argomento a un costruttore o a un metodo in questa classe genererà un'eccezione NullPointerException .

Un String rappresenta una stringa nel formato UTF-16 in cui <i>caratteri< supplementari/em> sono rappresentati da <>coppie< di surrogati em/em> (vedere la sezione Rappresentazioni di caratteri Unicode nella Character classe per altre informazioni). I valori di indice fanno riferimento alle char unità di codice, quindi un carattere supplementare usa due posizioni in un oggetto String.

La String classe fornisce metodi per gestire i punti di codice Unicode (ad esempio, caratteri), oltre a quelli per la gestione delle unità di codice Unicode (ad esempio, char valori).

Se non diversamente specificato, i metodi per il confronto delle stringhe non prendono in considerazione le impostazioni locali. La java.text.Collator classe fornisce metodi per un confronto stringhe più granulare e sensibile alle impostazioni locali.

Aggiunta nella versione 1.0.

per java.lang.String.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Costruttori

Nome	Descrizione
String()	Crea una stringa vuota.
String(Byte[], Charset)	Costruisce un nuovo `String` oggetto decodificando la matrice di byte specificata usando il codice Java specificato.
String(Byte[], Int32, Int32, Charset)	Costruisce un nuovo `String` oggetto decodificando la sottoarray specificata di byte usando il codice Java specificato.
String(Byte[], Int32, Int32, Int32)	Obsoleti. Alloca un nuovo `String` oggetto costruito da una sottomaschera di una matrice di valori integer a 8 bit.
String(Byte[], Int32, Int32, String)	Costruisce un nuovo `String` oggetto decodificando la sottoarray specificata di byte utilizzando il charset specificato.
String(Byte[], Int32, Int32)	Costruisce un nuovo `String` oggetto decodificando la sottoarray specificata di byte usando il set di caratteri predefinito della piattaforma.
String(Byte[], Int32)	Obsoleti. Alloca un nuovo `String` oggetto contenente i caratteri costruiti da una matrice di valori interi a 8 bit.
String(Byte[], String)	Costruisce un nuovo `String` oggetto decodificando la matrice di byte specificata usando il codice Java specificato.
String(Byte[])	Costruisce un nuovo `String` oggetto decodificando la matrice di byte specificata usando il set di caratteri predefinito della piattaforma.
String(Char[], Int32, Int32)	Inizializza questa stringa per contenere gli oggetti specificati `char`.
String(Char[])	Inizializza questa stringa per contenere gli oggetti specificati `char`.
String(Int32[], Int32, Int32)	Alloca un nuovo `String` oggetto contenente caratteri da una sottomaschera dell'argomento matrice di punti di codice Unicode.
String(String)	Costruisce una nuova stringa con la stessa sequenza di caratteri di `toCopy`.
String(StringBuffer)	Alloca una nuova stringa che contiene la sequenza di caratteri attualmente contenuti nell'argomento buffer di stringhe.
String(StringBuilder)	Alloca una nuova stringa che contiene la sequenza di caratteri attualmente contenuti nell'argomento generatore di stringhe.

Proprietà

Nome	Descrizione
CaseInsensitiveOrder	Un comparatore che ordina gli `String` oggetti come da `compareToIgnoreCase`.
Class	Restituisce la classe di runtime di questo `Object`oggetto . (Ereditato da Object)
Handle	Handle per l'istanza di Android sottostante. (Ereditato da Object)
IsBlank	Restituisce `true` se la stringa è vuota o contiene solo `Character#isWhitespace(int) white space` punti di codice, in caso contrario `false`.
IsEmpty	Restituisce `true` se e solo se è `#length()0`.
JniIdentityHashCode	Ottiene il codice hash di identità assegnato a questo Java peer dal runtime di interoperabilità. (Ereditato da Object)
JniManagedPeerState	La `String` classe rappresenta le stringhe di caratteri. (Ereditato da JavaObject)
JniPeerMembers	Ottiene i metadati JNI usati per richiamare i membri di questo peer Java.
PeerReference	Ottiene il riferimento all'oggetto JNI per questo peer Java. (Ereditato da Object)
ThresholdClass	Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. (Ereditato da Object)
ThresholdType	Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. (Ereditato da Object)

Metodi

Nome	Descrizione
CharAt(Int32)	Restituisce il `char` valore in corrispondenza dell'indice specificato.
Clone()	Crea e restituisce una copia di questo oggetto. (Ereditato da Object)
CodePointAt(Int32)	Restituisce il carattere (punto di codice Unicode) in corrispondenza dell'indice specificato.
CodePointBefore(Int32)	Restituisce il carattere (punto di codice Unicode) prima dell'indice specificato.
CodePointCount(Int32, Int32)	Restituisce il numero di punti di codice Unicode nell'intervallo di testo specificato di questo `String`oggetto .
CompareTo(String)	Confronta due stringhe lessicograficamente.
CompareToIgnoreCase(String)	Confronta due stringhe lessicograficamente, ignorando le differenze tra maiuscole e minuscole.
Concat(String)	Concatena la stringa specificata alla fine di questa stringa.
Construct(JniObjectReference, JniObjectReferenceOptions)	La `String` classe rappresenta le stringhe di caratteri. (Ereditato da JavaObject)
Contains(ICharSequence)	Restituisce true se e solo se questa stringa contiene la sequenza specificata di valori char.
Contains(String)	Restituisce true se e solo se questa stringa contiene la sequenza specificata di valori char.
ContentEquals(ICharSequence)	Confronta questa stringa con l'oggetto specificato `CharSequence`.
ContentEquals(String)	Confronta questa stringa con l'oggetto specificato `CharSequence`.
ContentEquals(StringBuffer)	Confronta questa stringa con l'oggetto specificato `StringBuffer`.
CopyValueOf(Char[], Int32, Int32)	Equivalente a `#valueOf(char[], int, int)`.
CopyValueOf(Char[])	Equivalente a `#valueOf(char[])`.
Dispose()	Rilascia le risorse contenute in questo peer Java. (Ereditato da Object)
Dispose(Boolean)	Rilascia le risorse contenute in questo peer Java. (Ereditato da Object)
DisposeUnlessReferenced()	La `String` classe rappresenta le stringhe di caratteri. (Ereditato da JavaObject)
EndsWith(String)	Verifica se questa stringa termina con il suffisso specificato.
Equals(Object)	La `String` classe rappresenta le stringhe di caratteri. (Ereditato da JavaObject)
Equals(Object)	Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object)
EqualsIgnoreCase(String)	Confronta questo `String` valore con un altro `String`oggetto , ignorando le considerazioni relative ai casi.
Format(Locale, String, Object[])	Restituisce una stringa formattata utilizzando la stringa di formato e gli argomenti specificati.
Format(String, Object[])	Restituisce una stringa formattata utilizzando la stringa di formato e gli argomenti specificati.
Formatted(Object[])	Formatta questa stringa sostituendo gli argomenti forniti.
GetBytes()	Codifica questo `String` valore in una sequenza di byte usando il set di caratteri predefinito della piattaforma, archiviando il risultato in una nuova matrice di byte.
GetBytes(Charset)	Codifica questo `String` oggetto in una sequenza di byte usando il codice Java specificato.
GetBytes(Int32, Int32, Byte[], Int32)	Obsoleti. Copia i caratteri da questa stringa nella matrice di byte di destinazione.
GetBytes(String)	Codifica questo `String` oggetto in una sequenza di byte usando il charset denominato, archiviando il risultato in una nuova matrice di byte.
GetChars(Int32, Int32, Char[], Int32)	Copia i caratteri da questa stringa nella matrice di caratteri di destinazione.
GetEnumerator()	Restituisce un enumeratore che scorre i caratteri in questa sequenza.
GetHashCode()	Restituisce un valore di codice hash per l'oggetto . (Ereditato da Object)
Indent(Int32)	Regola il rientro di ogni riga di questa stringa in base al valore di `n`e normalizza i caratteri di terminazione della riga.
IndexOf(Int32, Int32)	Restituisce l'indice all'interno di questa stringa della prima occorrenza del carattere specificato, iniziando la ricerca in corrispondenza dell'indice specificato.
IndexOf(Int32)	Restituisce l'indice all'interno di questa stringa della prima occorrenza del carattere specificato.
IndexOf(String, Int32)	Restituisce l'indice all'interno di questa stringa della prima occorrenza della sottostringa specificata, a partire dall'indice specificato.
IndexOf(String)	Restituisce l'indice all'interno di questa stringa della prima occorrenza della sottostringa specificata.
Intern()	Restituisce una rappresentazione canonica per l'oggetto stringa.
JavaFinalize()	Chiamato dal Garbage Collector su un oggetto quando Garbage Collection determina che non sono presenti altri riferimenti all'oggetto . (Ereditato da Object)
Join(ICharSequence, ICharSequence[])	Restituisce un nuovo oggetto String composto da copie del `CharSequence elements` join insieme a una copia dell'oggetto specificato `delimiter`.
Join(ICharSequence, IIterable)	Restituisce un nuovo `String` oggetto composto da copie del `CharSequence elements` join insieme a una copia dell'oggetto specificato `delimiter`.
Join(String, IIterable)	Restituisce un nuovo `String` oggetto composto da copie del `CharSequence elements` join insieme a una copia dell'oggetto specificato `delimiter`.
Join(String, String[])	Restituisce un nuovo oggetto String composto da copie del `CharSequence elements` join insieme a una copia dell'oggetto specificato `delimiter`.
LastIndexOf(Int32, Int32)	Restituisce l'indice all'interno di questa stringa dell'ultima occorrenza del carattere specificato, eseguendo una ricerca all'indietro a partire dall'indice specificato.
LastIndexOf(Int32)	Restituisce l'indice all'interno di questa stringa dell'ultima occorrenza del carattere specificato.
LastIndexOf(String, Int32)	Restituisce l'indice all'interno di questa stringa dell'ultima occorrenza della sottostringa specificata, eseguendo una ricerca all'indietro a partire dall'indice specificato.
LastIndexOf(String)	Restituisce l'indice all'interno di questa stringa dell'ultima occorrenza della sottostringa specificata.
Length()	Restituisce la lunghezza di questa stringa.
Matches(String)	Indica se questa stringa corrisponde o meno all'espressione regolare specificata.
Notify()	Riattiva un singolo thread in attesa del monitor dell'oggetto. (Ereditato da Object)
NotifyAll()	Riattiva tutti i thread in attesa del monitor dell'oggetto. (Ereditato da Object)
OffsetByCodePoints(Int32, Int32)	Restituisce l'indice all'interno di questo `String` oggetto offset rispetto all'oggetto specificato `index` dai `codePointOffset` punti di codice.
RegionMatches(Boolean, Int32, String, Int32, Int32)	Verifica se due aree stringa sono uguali.
RegionMatches(Int32, String, Int32, Int32)	Verifica se due aree stringa sono uguali.
Repeat(Int32)	Restituisce una stringa il cui valore è la concatenazione di questa stringa più volte `count` .
Replace(Char, Char)	Restituisce una stringa risultante dalla sostituzione di tutte le occorrenze di `oldChar` in questa stringa con `newChar`.
Replace(ICharSequence, ICharSequence)	Sostituisce ogni sottostringa di questa stringa che corrisponde alla sequenza di destinazione letterale con la sequenza di sostituzione letterale specificata.
Replace(String, String)	Sostituisce ogni sottostringa di questa stringa che corrisponde alla sequenza di destinazione letterale con la sequenza di sostituzione letterale specificata.
ReplaceAll(String, String)	Sostituisce ogni sottostringa di questa stringa che corrisponde all'espressione regolare specificata con la sostituzione specificata.
ReplaceFirst(String, String)	Sostituisce la prima sottostringa di questa stringa che corrisponde all'espressione regolare specificata con la sostituzione specificata.
SetHandle(IntPtr, JniHandleOwnership)	Imposta la proprietà Handle. (Ereditato da Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	La `String` classe rappresenta le stringhe di caratteri. (Ereditato da JavaObject)
Split(String, Int32)	Divide questa stringa intorno alle corrispondenze dell'espressione regolare specificata.
Split(String)	Divide questa stringa intorno alle corrispondenze dell'espressione regolare specificata.
StartsWith(String, Int32)	Verifica se la sottostringa di questa stringa a partire dall'indice specificato inizia con il prefisso specificato.
StartsWith(String)	Verifica se questa stringa inizia con il prefisso specificato.
Strip()	Restituisce una stringa il cui valore è questa stringa, con tutti gli elementi iniziali e finali `Character#isWhitespace(int) white space` rimossi.
StripIndent()	Restituisce una stringa il cui valore è questa stringa, con spazi vuoti incidentali Character#isWhitespace(int) rimossi dall'inizio e dalla fine di ogni riga.
StripLeading()	Restituisce una stringa il cui valore è questa stringa, con tutti gli elementi iniziali `Character#isWhitespace(int) white space` rimossi.
StripTrailing()	Restituisce una stringa il cui valore è questa stringa, con tutti gli elementi finali `Character#isWhitespace(int) white space` rimossi.
SubSequence(Int32, Int32)	Restituisce una sequenza di caratteri che rappresenta una sottosequenza di questa sequenza.
SubSequenceFormatted(Int32, Int32)	Restituisce una sequenza di caratteri che rappresenta una sottosequenza di questa sequenza.
Substring(Int32, Int32)	Restituisce una stringa che rappresenta una sottostringa di questa stringa.
Substring(Int32)	Restituisce una stringa che rappresenta una sottostringa di questa stringa.
ToArray<T>()	Crea una matrice gestita da questo wrapper di matrice Java. (Ereditato da Object)
ToCharArray()	Converte questa stringa in una nuova matrice di caratteri.
ToLowerCase()	Converte tutti i caratteri in questo `String` modo in lettere minuscole usando le regole delle impostazioni locali predefinite.
ToLowerCase(Locale)	Converte tutti i caratteri in questo `String` oggetto in lettere minuscole usando le regole dell'oggetto specificato `Locale`.
ToString()	Converte questo valore in una stringa.
ToUpperCase()	Converte tutti i caratteri in maiuscolo `String` usando le regole delle impostazioni locali predefinite.
ToUpperCase(Locale)	Converte tutti i caratteri in questo `String` in lettere maiuscole usando le regole dell'oggetto specificato `Locale`.
Transform(IFunction)	Questo metodo consente all'applicazione di una funzione di stringa `this` .
TranslateEscapes()	Restituisce una stringa il cui valore è questa stringa, con sequenze di escape tradotte come se in un valore letterale stringa.
Trim()	Restituisce una stringa il cui valore è questa stringa, con tutti gli spazi iniziali e finali rimossi, dove lo spazio è definito come qualsiasi carattere il cui punto di codice è minore o uguale a `'U+0020'` (il carattere di spazio).
UnregisterFromRuntime()	Annulla la registrazione di questo Java peer dal runtime di interoperabilità. (Ereditato da Object)
ValueOf(Boolean)	Restituisce la rappresentazione di stringa dell'argomento `boolean` .
ValueOf(Char)	Restituisce la rappresentazione di stringa dell'argomento `char` .
ValueOf(Char[], Int32, Int32)	Restituisce la rappresentazione di stringa di una sottomaschera specifica dell'argomento `char` matrice.
ValueOf(Char[])	Restituisce la rappresentazione di stringa dell'argomento `char` matrice.
ValueOf(Double)	Restituisce la rappresentazione di stringa dell'argomento `double` .
ValueOf(Int32)	Restituisce la rappresentazione di stringa dell'argomento `int` .
ValueOf(Int64)	Restituisce la rappresentazione di stringa dell'argomento `long` .
ValueOf(Object)	Restituisce la rappresentazione di stringa dell'argomento `Object` .
ValueOf(Single)	Restituisce la rappresentazione di stringa dell'argomento `float` .
Wait()	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo <>una notifica</em> o <em>interrotto</em>. (Ereditato da Object)
Wait(Int64, Int32)	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo<> una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object)
Wait(Int64)	Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo<> una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IComparable.CompareTo(Object)	Confronta questo valore con l'oggetto specificato per l'ordinamento.
IEnumerable.GetEnumerator()	Restituisce un enumeratore non generico per i caratteri in questa sequenza.
IJavaPeerable.Disposed()	La `String` classe rappresenta le stringhe di caratteri. (Ereditato da JavaObject)
IJavaPeerable.Finalized()	La `String` classe rappresenta le stringhe di caratteri. (Ereditato da JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	La `String` classe rappresenta le stringhe di caratteri. (Ereditato da JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	La `String` classe rappresenta le stringhe di caratteri. (Ereditato da JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	La `String` classe rappresenta le stringhe di caratteri. (Ereditato da JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	La `String` classe rappresenta le stringhe di caratteri. (Ereditato da JavaObject)
IJavaPeerable.UnregisterFromRuntime()	La `String` classe rappresenta le stringhe di caratteri.

Metodi di estensione

Nome	Descrizione
GetJniTypeName(IJavaPeerable)	Ottiene il nome JNI del tipo dell'istanza `self`di .
JavaAs<TResult>(IJavaPeerable)	Provare a digitare `selfTResult`, verificando che la coercizione sia valida sul lato Java.
JavaCast<TResult>(IJavaObject)	Esegue una conversione del tipo di tipo controllato dal runtime Android.
JavaCast<TResult>(IJavaObject)	La `String` classe rappresenta le stringhe di caratteri.
SubSequence(ICharSequence, Int32, Int32)	Restituisce la sottosequenza del carattere all'interno dell'intervallo specificato.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Provare a digitare `selfTResult`, verificando che la coercizione sia valida sul lato Java.

Si applica a