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 un puntatore specificato a una matrice di caratteri Unicode.
String(Char[])	Inizializza una nuova istanza della classe String ai caratteri Unicode indicati nella matrice di caratteri specificata.
String(ReadOnlySpan<Char>)	Inizializza una nuova istanza della classe String ai 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 un carattere Unicode specificato ripetuto un numero specificato di volte.
String(Char*, Int32, Int32)	Inizializza una nuova istanza della classe String sul valore indicato da un puntatore specificato a una matrice di caratteri Unicode, una posizione del carattere iniziale all'interno di tale matrice e una lunghezza.
String(Char[], Int32, Int32)	Inizializza una nuova istanza della classe String sul valore indicato da una matrice di caratteri Unicode, una posizione del carattere iniziale all'interno di tale matrice e una lunghezza.
String(SByte*, Int32, Int32)	Inizializza una nuova istanza della classe String sul valore indicato da un puntatore specificato a una matrice di interi con segno a 8 bit, una posizione iniziale all'interno di tale matrice e una lunghezza.
String(SByte*, Int32, Int32, Encoding)	Inizializza una nuova istanza della classe String sul valore indicato da un puntatore specificato a una matrice di interi con segno a 8 bit, una posizione iniziale all'interno di tale matrice, una lunghezza e un oggetto Encoding.

Commenti

Per altre informazioni su questa API, vedere osservazioni supplementari sull'API per il costruttore String.

String(Char*)

Origine:

String.cs

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della classe String sul valore indicato da un puntatore specificato 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 indirizzati.

ArgumentException

value specifica una matrice contenente un carattere Unicode non valido oppure value specifica un indirizzo minore di 64000.

Commenti

Nota

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

String(Char[])

Origine:

String.cs

Inizializza una nuova istanza della classe String ai 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 overload del costruttore String, vedere il riepilogo del costruttore String.

String(ReadOnlySpan<Char>)

Origine:

String.cs

Inizializza una nuova istanza della classe String ai 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*)

Origine:

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 con terminazione Null di interi con segno a 8 bit. I numeri interi vengono interpretati usando la codifica della tabella codici di sistema corrente in Windows (denominata CP_ACP) e come codifica UTF-8 in non Windows.

Attributi

CLSCompliantAttribute

Eccezioni

ArgumentNullException

value è null.

ArgumentException

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

ArgumentOutOfRangeException

La lunghezza della nuova stringa da inizializzare, determinata dal carattere di terminazione Null di 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 overload del costruttore String, vedere il riepilogo del costruttore String.

String(Char, Int32)

Origine:

String.cs

Inizializza una nuova istanza della classe String sul valore indicato da un carattere Unicode specificato ripetuto un numero specificato 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 verifica c.

Eccezioni

ArgumentOutOfRangeException

count è minore di zero.

Commenti

Nota

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

String(Char*, Int32, Int32)

Origine:

String.cs

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della classe String sul valore indicato da un puntatore specificato a una matrice di caratteri Unicode, una posizione del carattere iniziale all'interno di tale matrice e 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 all'interno di value da utilizzare.

Attributi

CLSCompliantAttribute

Eccezioni

ArgumentOutOfRangeException

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

ArgumentException

value specifica una matrice contenente un carattere Unicode non valido oppure value + startIndex specifica un indirizzo minore di 64000.

Commenti

Nota

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

String(Char[], Int32, Int32)

Origine:

String.cs

Inizializza una nuova istanza della classe String sul valore indicato da una matrice di caratteri Unicode, una posizione del carattere iniziale all'interno di tale matrice e 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 all'interno di value da utilizzare.

Eccezioni

ArgumentNullException

value è null.

ArgumentOutOfRangeException

startIndex o length è minore di zero.

-o-

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 overload del costruttore String, vedere il riepilogo del costruttore String.

String(SByte*, Int32, Int32)

Origine:

String.cs

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della classe String sul valore indicato da un puntatore specificato a una matrice di interi con segno a 8 bit, una posizione iniziale all'interno di tale matrice e 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 usando la codifica della tabella codici di sistema corrente in Windows (denominata CP_ACP) e come codifica UTF-8 in non Windows.

startIndex

Int32

Posizione iniziale all'interno di value.

length

Int32

Numero di caratteri all'interno di value da utilizzare.

Attributi

CLSCompliantAttribute

Eccezioni

ArgumentNullException

value è null.

ArgumentOutOfRangeException

startIndex o length è minore di zero.

-o-

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

-o-

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

ArgumentException

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

-o-

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

AccessViolationException

value, startIndexe length specificare collettivamente un indirizzo non valido.

Commenti

Nota

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

String(SByte*, Int32, Int32, Encoding)

Origine:

String.cs

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della classe String sul valore indicato da un puntatore specificato a una matrice di interi con segno a 8 bit, una posizione iniziale all'interno di tale matrice, una lunghezza e 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 all'interno di value da utilizzare.

enc

Encoding

Oggetto che specifica la modalità di codifica della matrice a cui fa riferimento value. Se enc è null, si presuppone la codifica ANSI.

Attributi

CLSCompliantAttribute

Eccezioni

ArgumentNullException

value è null.

ArgumentOutOfRangeException

startIndex o length è minore di zero.

-o-

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

-o-

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

ArgumentException

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

-o-

Non è stato possibile inizializzare una nuova istanza di String usando value, presupponendo che value sia codificato come specificato da enc.

AccessViolationException

value, startIndexe length specificare collettivamente un indirizzo non valido.

Commenti

Nota

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