String Costruttori

Definizione

Inizializza una nuova istanza della classe String.

Overload

Nome Descrizione
String(Char*)

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

String(Char[])

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

String(ReadOnlySpan<Char>)

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

String(SByte*)

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

String(Char, Int32)

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

String(Char*, Int32, Int32)

Inizializza una nuova istanza della String classe 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 String classe 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 String classe 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 String classe 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 Encoding oggetto .

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

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della String classe 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 che contiene un carattere Unicode non valido oppure value specifica un indirizzo minore di 64000.

Commenti

Note

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

Si applica a

String(Char[])

Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs

Inizializza una nuova istanza della String classe sui 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

Note

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

Si applica a

String(ReadOnlySpan<Char>)

Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs

Inizializza una nuova istanza della String classe 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.

Si applica a

String(SByte*)

Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della String classe 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 Windows non.

Attributi

Eccezioni

value è null.

Non è stato possibile inizializzare una nuova istanza di String usando value, presupponendo che value sia codificata 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

Note

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

Si applica a

String(Char, Int32)

Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs

Inizializza una nuova istanza della String classe 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 c .

Eccezioni

count è minore di zero.

Commenti

Note

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

Si applica a

String(Char*, Int32, Int32)

Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della String classe 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 valuedi .

length
Int32

Numero di caratteri all'interno value di da utilizzare.

Attributi

Eccezioni

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 indirizzati.

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

Commenti

Note

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

Si applica a

String(Char[], Int32, Int32)

Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs

Inizializza una nuova istanza della String classe 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 valuedi .

length
Int32

Numero di caratteri all'interno value di da utilizzare.

Eccezioni

value è null.

startIndex o length è minore di zero.

oppure

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

Commenti

Note

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

Si applica a

String(SByte*, Int32, Int32)

Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della String classe 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 Windows non.

startIndex
Int32

Posizione iniziale all'interno valuedi .

length
Int32

Numero di byte all'interno value di da utilizzare.

Attributi

Eccezioni

value è null.

startIndex o length è minore di zero.

oppure

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

oppure

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

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

oppure

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

value, startIndexe length specificano collettivamente un indirizzo non valido.

Commenti

Note

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

Si applica a

String(SByte*, Int32, Int32, Encoding)

Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs
Origine:
String.cs

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della String classe 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 Encoding oggetto .

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 valuedi .

length
Int32

Numero di byte all'interno value di da utilizzare.

enc
Encoding

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

Attributi

Eccezioni

value è null.

startIndex o length è minore di zero.

oppure

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

oppure

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

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

oppure

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

value, startIndexe length specificano collettivamente un indirizzo non valido.

Commenti

Note

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

Si applica a