String Construtores

Referência

Definição

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Inicializa uma nova instância da classe String.

Sobrecargas

String(Char*)	Inicializa uma nova instância da classe String para o valor indicado por um ponteiro especificado para uma matriz de caracteres Unicode.
String(Char[])	Inicializa uma nova instância da classe String para os caracteres Unicode indicados na matriz de caracteres especificada.
String(ReadOnlySpan<Char>)	Inicializa uma nova instância da classe String para os caracteres Unicode indicados no intervalo somente leitura especificado.
String(SByte*)	Inicializa uma nova instância da classe String para o valor indicado por um ponteiro para uma matriz de inteiros com sinal de 8 bits.
String(Char, Int32)	Inicializa uma nova instância da classe String para o valor indicado por um caractere Unicode especificado repetiu um número especificado de vezes.
String(Char*, Int32, Int32)	Inicializa uma nova instância da classe String para o valor indicado por um ponteiro especificado para uma matriz de caracteres Unicode, uma posição de caractere inicial dentro dessa matriz e um comprimento.
String(Char[], Int32, Int32)	Inicializa uma nova instância da classe String para o valor indicado por uma matriz de caracteres Unicode, uma posição de caractere inicial dentro dessa matriz e um comprimento.
String(SByte*, Int32, Int32)	Inicializa uma nova instância da classe String para o valor indicado por um ponteiro especificado para uma matriz de inteiros com sinal de 8 bits, uma posição inicial dentro dessa matriz e um comprimento.
String(SByte*, Int32, Int32, Encoding)	Inicializa uma nova instância da classe String para o valor indicado por um ponteiro especificado para uma matriz de inteiros com sinal de 8 bits, uma posição inicial dentro dessa matriz, um comprimento e um objeto Encoding.

Comentários

Para obter mais informações sobre essa API, consulte comentários de API Suplementar para o construtor string.

String(Char*)

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Importante

Esta API não está em conformidade com CLS.

Inicializa uma nova instância da classe String para o valor indicado por um ponteiro especificado para uma matriz de caracteres 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

Parâmetros

value: Char*

Um ponteiro para uma matriz terminada em nulo de caracteres Unicode.

Atributos: CLSCompliantAttribute SecurityCriticalAttribute

Exceções

ArgumentOutOfRangeException

O processo atual não tem acesso de leitura a todos os caracteres endereçados.

ArgumentException

value especifica uma matriz que contém um caractere Unicode inválido ou value especifica um endereço inferior a 64000.

Comentários

Observação

Para obter exemplos e informações de uso abrangentes sobre essa e outras sobrecargas de construtor String, consulte o resumo do construtor String.

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

String(Char[])

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Inicializa uma nova instância da classe String para os caracteres Unicode indicados na matriz de caracteres especificada.

public:
 String(cli::array <char> ^ value);

public String (char[] value);

public String (char[]? value);

new string : char[] -> string

Public Sub New (value As Char())

Parâmetros

value: Char[]

Uma matriz de caracteres Unicode.

Comentários

Observação

Para obter exemplos e informações de uso abrangentes sobre essa e outras sobrecargas de construtor String, consulte o resumo do construtor String.

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

String(ReadOnlySpan<Char>)

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Inicializa uma nova instância da classe String para os caracteres Unicode indicados no intervalo somente leitura especificado.

public:
 String(ReadOnlySpan<char> value);

public String (ReadOnlySpan<char> value);

new string : ReadOnlySpan<char> -> string

Public Sub New (value As ReadOnlySpan(Of Char))

Parâmetros

value: ReadOnlySpan<Char>

Um intervalo somente leitura de caracteres Unicode.

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard	2.1

String(SByte*)

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Importante

Esta API não está em conformidade com CLS.

Inicializa uma nova instância da classe String para o valor indicado por um ponteiro para uma matriz de inteiros com sinal de 8 bits.

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

Parâmetros

value: SByte*

Um ponteiro para uma matriz terminada em nulo de inteiros com sinal de 8 bits. Os inteiros são interpretados usando a codificação da página de código do sistema atual no Windows (conhecida como CP_ACP) e como codificação UTF-8 em não Windows.

Atributos: CLSCompliantAttribute SecurityCriticalAttribute

Exceções

ArgumentNullException

value é null.

ArgumentException

Não foi possível inicializar uma nova instância de String usando value, supondo que value esteja codificada no ANSI.

ArgumentOutOfRangeException

O comprimento da nova cadeia de caracteres a ser inicializada, que é determinado pelo caractere de terminação nulo de value, é muito grande para alocar.

AccessViolationException

value especifica um endereço inválido.

Comentários

Observação

Para obter exemplos e informações de uso abrangentes sobre essa e outras sobrecargas de construtor String, consulte o resumo do construtor String.

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

String(Char, Int32)

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Inicializa uma nova instância da classe String para o valor indicado por um caractere Unicode especificado repetiu um número especificado de vezes.

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)

Parâmetros

c: Char

Um caractere Unicode.

count: Int32

O número de vezes c ocorre.

Exceções

ArgumentOutOfRangeException

count é menor que zero.

Comentários

Observação

Para obter exemplos e informações de uso abrangentes sobre essa e outras sobrecargas de construtor String, consulte o resumo do construtor String.

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

String(Char*, Int32, Int32)

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Importante

Esta API não está em conformidade com CLS.

Inicializa uma nova instância da classe String para o valor indicado por um ponteiro especificado para uma matriz de caracteres Unicode, uma posição de caractere inicial dentro dessa matriz e um comprimento.

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

Parâmetros

value: Char*

Um ponteiro para uma matriz de caracteres Unicode.

startIndex: Int32

A posição inicial dentro de value.

length: Int32

O número de caracteres dentro value a ser usado.

Atributos: CLSCompliantAttribute SecurityCriticalAttribute

Exceções

ArgumentOutOfRangeException

startIndex ou length é menor que zero, value + startIndex causar um estouro de ponteiro ou o processo atual não tem acesso de leitura a todos os caracteres endereçados.

ArgumentException

value especifica uma matriz que contém um caractere Unicode inválido ou value + startIndex especifica um endereço inferior a 64000.

Comentários

Observação

Para obter exemplos e informações de uso abrangentes sobre essa e outras sobrecargas de construtor String, consulte o resumo do construtor String.

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

String(Char[], Int32, Int32)

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Inicializa uma nova instância da classe String para o valor indicado por uma matriz de caracteres Unicode, uma posição de caractere inicial dentro dessa matriz e um comprimento.

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)

Parâmetros

value: Char[]

Uma matriz de caracteres Unicode.

startIndex: Int32

A posição inicial dentro de value.

length: Int32

O número de caracteres dentro value a ser usado.

Exceções

ArgumentNullException

value é null.

ArgumentOutOfRangeException

startIndex ou length é menor que zero.

-ou-

A soma de startIndex e length é maior do que o número de elementos em value.

Comentários

Observação

Para obter exemplos e informações de uso abrangentes sobre essa e outras sobrecargas de construtor String, consulte o resumo do construtor String.

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

String(SByte*, Int32, Int32)

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Importante

Esta API não está em conformidade com CLS.

Inicializa uma nova instância da classe String para o valor indicado por um ponteiro especificado para uma matriz de inteiros com sinal de 8 bits, uma posição inicial dentro dessa matriz e um comprimento.

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

Parâmetros

value: SByte*

Um ponteiro para uma matriz de inteiros com sinal de 8 bits. Os inteiros são interpretados usando a codificação da página de código do sistema atual no Windows (conhecida como CP_ACP) e como codificação UTF-8 em não Windows.

startIndex: Int32

A posição inicial dentro de value.

length: Int32

O número de caracteres dentro value a ser usado.

Atributos: CLSCompliantAttribute SecurityCriticalAttribute

Exceções

ArgumentNullException

value é null.

ArgumentOutOfRangeException

startIndex ou length é menor que zero.

-ou-

O endereço especificado por value + startIndex é muito grande para a plataforma atual; ou seja, o cálculo de endereço estourada.

-ou-

O comprimento da nova cadeia de caracteres a ser inicializada é muito grande para alocar.

ArgumentException

O endereço especificado por value + startIndex é menor que 64K.

-ou-

Não foi possível inicializar uma nova instância de String usando value, supondo que value esteja codificada no ANSI.

AccessViolationException

value, startIndexe length especificar coletivamente um endereço inválido.

Comentários

Observação

Para obter exemplos e informações de uso abrangentes sobre essa e outras sobrecargas de construtor String, consulte o resumo do construtor String.

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

String(SByte*, Int32, Int32, Encoding)

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Importante

Esta API não está em conformidade com 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

Parâmetros

value: SByte*

Um ponteiro para uma matriz de inteiros com sinal de 8 bits.

startIndex: Int32

A posição inicial dentro de value.

length: Int32

O número de caracteres dentro value a ser usado.

enc: Encoding

Um objeto que especifica como a matriz referenciada por value é codificada. Se enc for null, a codificação ANSI será assumida.

Atributos: CLSCompliantAttribute SecurityCriticalAttribute

Exceções

ArgumentNullException

value é null.

ArgumentOutOfRangeException

startIndex ou length é menor que zero.

-ou-

O endereço especificado por value + startIndex é muito grande para a plataforma atual; ou seja, o cálculo de endereço estourada.

-ou-

O comprimento da nova cadeia de caracteres a ser inicializada é muito grande para alocar.

ArgumentException

O endereço especificado por value + startIndex é menor que 64K.

-ou-

Uma nova instância de String não pôde ser inicializada usando value, supondo que value seja codificada conforme especificado por enc.

AccessViolationException

value, startIndexe length especificar coletivamente um endereço inválido.

Comentários

Observação

Para obter exemplos e informações de uso abrangentes sobre essa e outras sobrecargas de construtor String, consulte o resumo do construtor String.

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

Compartilhar via

String Construtores

Definição

Sobrecargas

Comentários

String(Char*)

Parâmetros

Exceções

Comentários

Aplica-se a

String(Char[])

Parâmetros

Comentários

Aplica-se a

String(ReadOnlySpan<Char>)

Parâmetros

Aplica-se a

String(SByte*)

Parâmetros

Exceções

Comentários

Aplica-se a

String(Char, Int32)

Parâmetros

Exceções

Comentários

Aplica-se a

String(Char*, Int32, Int32)

Parâmetros

Exceções

Comentários

Aplica-se a

String(Char[], Int32, Int32)

Parâmetros

Exceções

Comentários

Aplica-se a

String(SByte*, Int32, Int32)

Parâmetros

Exceções

Comentários

Aplica-se a

String(SByte*, Int32, Int32, Encoding)

Parâmetros

Exceções

Comentários

Aplica-se a

Recursos adicionais