String Costruttori
Definizione
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.
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
, startIndex
e 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.
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
, startIndex
e 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.