String Costruttori

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Inizializza una nuova istanza della classe String.

Overload

String(Char*)	Inizializza una nuova istanza della classe String sul valore indicato da uno specifico puntatore a una matrice di caratteri Unicode.
String(Char[])	Inizializza una nuova istanza della classe String sui caratteri Unicode indicati nella matrice di caratteri specificata.
String(ReadOnlySpan<Char>)	Inizializza una nuova istanza della classe String sui caratteri Unicode indicati nell'intervallo di sola lettura specificato.
String(SByte*)	Inizializza una nuova istanza della classe String sul valore indicato da un puntatore a una matrice di interi con segno a 8 bit.
String(Char, Int32)	Inizializza una nuova istanza della classe String sul valore indicato da uno specifico carattere Unicode ripetuto un numero precisato di volte.
String(Char*, Int32, Int32)	Inizializza una nuova istanza della classe String sul valore indicato da uno specifico puntatore a una matrice di caratteri Unicode, da una posizione iniziale del carattere all'interno di tale matrice e da una lunghezza.
String(Char[], Int32, Int32)	Inizializza una nuova istanza della classe String sul valore indicato da una matrice di caratteri Unicode, da una posizione iniziale del carattere all'interno di tale matrice e da una lunghezza.
String(SByte*, Int32, Int32)	Inizializza una nuova istanza della classe String sul valore indicato da uno specifico puntatore a una matrice di interi con segno a 8 bit, da una posizione iniziale all'interno di tale matrice e da una lunghezza.
String(SByte*, Int32, Int32, Encoding)	Inizializza una nuova istanza della classe String sul valore indicato da uno specifico puntatore a una matrice di interi con segno a 8 bit, da una posizione iniziale all'interno di tale matrice e da un oggetto Encoding.

Commenti

Per altre informazioni su questa API, vedere Note sulle API supplementari per il costruttore String.

String(Char*)

Source:

String.cs

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della classe String sul valore indicato da uno specifico puntatore a una matrice di caratteri Unicode.

public:
 String(char* value);

[System.CLSCompliant(false)]
public String (char* value);

[<System.CLSCompliant(false)>]
new string : nativeptr<char> -> string

Parametri

value

Char*

Puntatore a una matrice con terminazione Null di caratteri Unicode.

Attributi

CLSCompliantAttribute

Eccezioni

ArgumentOutOfRangeException

Il processo corrente non ha accesso in lettura a tutti i caratteri considerati.

ArgumentException

value specifica una matrice che contiene un carattere Unicode non valido o value specifica un indirizzo minore di 64000.

Commenti

Nota

Per esempi e informazioni complete sull'utilizzo su questo e altri String overload del costruttore, vedere il riepilogo del String costruttore.

String(Char[])

Source:

String.cs

Inizializza una nuova istanza della classe String sui caratteri Unicode indicati nella matrice di caratteri specificata.

public:
 String(cli::array <char> ^ value);

public String (char[]? value);

new string : char[] -> string

Public Sub New (value As Char())

Parametri

value

Char[]

Matrice di caratteri Unicode.

Commenti

Nota

Per esempi e informazioni complete sull'utilizzo su questo e altri String overload del costruttore, vedere il riepilogo del String costruttore.

String(ReadOnlySpan<Char>)

Source:

String.cs

Inizializza una nuova istanza della classe String sui caratteri Unicode indicati nell'intervallo di sola lettura specificato.

public:
 String(ReadOnlySpan<char> value);

public String (ReadOnlySpan<char> value);

new string : ReadOnlySpan<char> -> string

Public Sub New (value As ReadOnlySpan(Of Char))

Parametri

value

ReadOnlySpan<Char>

Intervallo di sola lettura di caratteri Unicode.

String(SByte*)

Source:

String.cs

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della classe String sul valore indicato da un puntatore a una matrice di interi con segno a 8 bit.

public:
 String(System::SByte* value);

[System.CLSCompliant(false)]
public String (sbyte* value);

[<System.CLSCompliant(false)>]
new string : nativeptr<sbyte> -> string

Parametri

value

SByte*

Puntatore a una matrice a terminazione Null di interi con segno a 8 bit. I numeri interi vengono interpretati in base alla codifica della tabella codici di sistema corrente, ovvero alla codifica specificata da Default.

Attributi

CLSCompliantAttribute

Eccezioni

ArgumentNullException

value è null.

ArgumentException

Non è stato possibile inizializzare una nuova istanza di String mediante value, supponendo che value sia codificato in ANSI.

ArgumentOutOfRangeException

La lunghezza della nuova stringa da inizializzare, che è determinata dal carattere a terminazione Null del parametro value, è troppo grande da allocare.

AccessViolationException

value specifica un indirizzo non valido.

Commenti

Nota

Per esempi e informazioni complete sull'utilizzo su questo e altri String overload del costruttore, vedere il riepilogo del String costruttore.

String(Char, Int32)

Source:

String.cs

Inizializza una nuova istanza della classe String sul valore indicato da uno specifico carattere Unicode ripetuto un numero precisato di volte.

public:
 String(char c, int count);

public String (char c, int count);

new string : char * int -> string

Public Sub New (c As Char, count As Integer)

Parametri

c

Char

Carattere Unicode.

count

Int32

Numero di volte in cui si presenta il parametro c.

Eccezioni

ArgumentOutOfRangeException

count è minore di zero.

Commenti

Nota

Per esempi e informazioni complete sull'utilizzo su questo e altri String overload del costruttore, vedere il riepilogo del String costruttore.

String(Char*, Int32, Int32)

Source:

String.cs

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della classe String sul valore indicato da uno specifico puntatore a una matrice di caratteri Unicode, da una posizione iniziale del carattere all'interno di tale matrice e da una lunghezza.

public:
 String(char* value, int startIndex, int length);

[System.CLSCompliant(false)]
public String (char* value, int startIndex, int length);

[<System.CLSCompliant(false)>]
new string : nativeptr<char> * int * int -> string

Parametri

value

Char*

Puntatore a una matrice di caratteri Unicode.

startIndex

Int32

Posizione iniziale all'interno di value.

length

Int32

Numero di caratteri in value da usare.

Attributi

CLSCompliantAttribute

Eccezioni

ArgumentOutOfRangeException

startIndex o length è minore di zero, value + startIndex causa un overflow del puntatore o il processo corrente non ha accesso in lettura a tutti i caratteri considerati.

ArgumentException

value specifica una matrice che contiene un carattere Unicode non valido o value + startIndex specifica un indirizzo minore di 64000.

Commenti

Nota

Per esempi e informazioni complete sull'utilizzo su questo e altri String overload del costruttore, vedere il riepilogo del String costruttore.

String(Char[], Int32, Int32)

Source:

String.cs

Inizializza una nuova istanza della classe String sul valore indicato da una matrice di caratteri Unicode, da una posizione iniziale del carattere all'interno di tale matrice e da una lunghezza.

public:
 String(cli::array <char> ^ value, int startIndex, int length);

public String (char[] value, int startIndex, int length);

new string : char[] * int * int -> string

Public Sub New (value As Char(), startIndex As Integer, length As Integer)

Parametri

value

Char[]

Matrice di caratteri Unicode.

startIndex

Int32

Posizione iniziale all'interno di value.

length

Int32

Numero di caratteri in value da usare.

Eccezioni

ArgumentNullException

value è null.

ArgumentOutOfRangeException

startIndex o length è minore di zero.

-oppure-

La somma di startIndex e length è maggiore del numero di elementi in value.

Commenti

Nota

Per esempi e informazioni complete sull'utilizzo su questo e altri String overload del costruttore, vedere il riepilogo del String costruttore.

String(SByte*, Int32, Int32)

Source:

String.cs

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della classe String sul valore indicato da uno specifico puntatore a una matrice di interi con segno a 8 bit, da una posizione iniziale all'interno di tale matrice e da una lunghezza.

public:
 String(System::SByte* value, int startIndex, int length);

[System.CLSCompliant(false)]
public String (sbyte* value, int startIndex, int length);

[<System.CLSCompliant(false)>]
new string : nativeptr<sbyte> * int * int -> string

Parametri

value

SByte*

Puntatore a una matrice di interi con segno a 8 bit. I numeri interi vengono interpretati in base alla codifica della tabella codici di sistema corrente, ovvero alla codifica specificata da Default.

startIndex

Int32

Posizione iniziale all'interno di value.

length

Int32

Numero di caratteri in value da usare.

Attributi

CLSCompliantAttribute

Eccezioni

ArgumentNullException

value è null.

ArgumentOutOfRangeException

startIndex o length è minore di zero.

-oppure-

L'indirizzo specificato da value + startIndex è troppo grande per la piattaforma corrente, ovvero il calcolo dell'indirizzo ha causato un overflow.

-oppure-

La lunghezza della nuova stringa da inizializzare è troppo grande da allocare.

ArgumentException

L'indirizzo specificato da value + startIndex è minore di 64 K.

-oppure-

Non è stato possibile inizializzare una nuova istanza di String mediante value, supponendo che value sia codificato in ANSI.

AccessViolationException

value, startIndex e length specificano collettivamente un indirizzo non valido.

Commenti

Nota

Per esempi e informazioni complete sull'utilizzo su questo e altri String overload del costruttore, vedere il riepilogo del String costruttore.

String(SByte*, Int32, Int32, Encoding)

Source:

String.cs

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della classe String sul valore indicato da uno specifico puntatore a una matrice di interi con segno a 8 bit, da una posizione iniziale all'interno di tale matrice e da un oggetto Encoding.

public:
 String(System::SByte* value, int startIndex, int length, System::Text::Encoding ^ enc);

[System.CLSCompliant(false)]
public String (sbyte* value, int startIndex, int length, System.Text.Encoding enc);

[<System.CLSCompliant(false)>]
new string : nativeptr<sbyte> * int * int * System.Text.Encoding -> string

Parametri

value

SByte*

Puntatore a una matrice di interi con segno a 8 bit.

startIndex

Int32

Posizione iniziale all'interno di value.

length

Int32

Numero di caratteri in value da usare.

enc

Encoding

Oggetto che specifica la modalità di codifica della matrice cui fa riferimento il parametro value. Se il parametro enc è null, verrà usata la codifica ANSI.

Attributi

CLSCompliantAttribute

Eccezioni

ArgumentNullException

value è null.

ArgumentOutOfRangeException

startIndex o length è minore di zero.

-oppure-

L'indirizzo specificato da value + startIndex è troppo grande per la piattaforma corrente, ovvero il calcolo dell'indirizzo ha causato un overflow.

-oppure-

La lunghezza della nuova stringa da inizializzare è troppo grande da allocare.

ArgumentException

L'indirizzo specificato da value + startIndex è minore di 64 K.

-oppure-

Non è stato possibile inizializzare una nuova istanza di String mediante value, supponendo che value sia stato codificato secondo quanto specificato da enc.

AccessViolationException

value, startIndex e length specificano collettivamente un indirizzo non valido.

Commenti

Nota

Per esempi e informazioni complete sull'utilizzo su questo e altri String overload del costruttore, vedere il riepilogo del String costruttore.