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