Condividi tramite


String Costruttori

Definizione

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
Origine:
String.cs
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)]
[System.Security.SecurityCritical]
public String (char* value);
[System.CLSCompliant(false)]
public String (char* value);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
new string : nativeptr<char> -> string
[<System.CLSCompliant(false)>]
new string : nativeptr<char> -> string

Parametri

value
Char*

Puntatore a una matrice con terminazione Null di caratteri Unicode.

Attributi

Eccezioni

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

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.

Si applica a

String(Char[])

Origine:
String.cs
Origine:
String.cs
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);
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.

Si applica a

String(ReadOnlySpan<Char>)

Origine:
String.cs
Origine:
String.cs
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.

Si applica a

String(SByte*)

Origine:
String.cs
Origine:
String.cs
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)]
[System.Security.SecurityCritical]
public String (sbyte* value);
[<System.CLSCompliant(false)>]
new string : nativeptr<sbyte> -> string
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
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

Eccezioni

value è null.

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

La lunghezza della nuova stringa da inizializzare, determinata dal carattere di terminazione Null di value, è troppo grande da allocare.

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.

Si applica a

String(Char, Int32)

Origine:
String.cs
Origine:
String.cs
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

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.

Si applica a

String(Char*, Int32, Int32)

Origine:
String.cs
Origine:
String.cs
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)]
[System.Security.SecurityCritical]
public String (char* value, int startIndex, int length);
[System.CLSCompliant(false)]
public String (char* value, int startIndex, int length);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
new string : nativeptr<char> * int * int -> string
[<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

Eccezioni

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.

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.

Si applica a

String(Char[], Int32, Int32)

Origine:
String.cs
Origine:
String.cs
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

value è null.

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.

Si applica a

String(SByte*, Int32, Int32)

Origine:
String.cs
Origine:
String.cs
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)]
[System.Security.SecurityCritical]
public String (sbyte* value, int startIndex, int length);
[<System.CLSCompliant(false)>]
new string : nativeptr<sbyte> * int * int -> string
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
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

Eccezioni

value è null.

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.

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.

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.

Si applica a

String(SByte*, Int32, Int32, Encoding)

Origine:
String.cs
Origine:
String.cs
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)]
[System.Security.SecurityCritical]
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
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
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

Eccezioni

value è null.

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.

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.

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.

Si applica a