String Construtores

Definição

Namespace:: System

Assemblies:: mscorlib.dll, System.Runtime.dll

Assemblies:: netstandard.dll, System.Runtime.dll

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

Nome	Description
String(Char*)	Inicializa uma nova instância da String classe para o valor indicado por um ponteiro especificado para uma matriz de caracteres Unicode.
String(Char[])	Inicializa uma nova instância da String classe para os caracteres Unicode indicados na matriz de caracteres especificada.
String(ReadOnlySpan<Char>)	Inicializa uma nova instância da String classe para os caracteres Unicode indicados no intervalo somente leitura especificado.
String(SByte*)	Inicializa uma nova instância da String classe 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 String classe para o valor indicado por um caractere Unicode especificado repetido um número especificado de vezes.
String(Char*, Int32, Int32)	Inicializa uma nova instância da String classe 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 String classe 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 String classe 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 String classe 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 Encoding objeto.

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

Origem:: String.cs

Origem:: String.cs

Importante

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

Inicializa uma nova instância da String classe 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 possui acesso de leitura para todos os caracteres especificados.

ArgumentException

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

Comentários

Note

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

Aplica-se a

String(Char[])

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Inicializa uma nova instância da String classe 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

Note

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

Aplica-se a

String(ReadOnlySpan<Char>)

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Inicializa uma nova instância da String classe 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

String(SByte*)

Origem:: String.cs

Origem:: String.cs

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 String classe 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 em 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 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

Note

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

Aplica-se a

String(Char, Int32)

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Inicializa uma nova instância da String classe para o valor indicado por um caractere Unicode especificado repetido 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

Note

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

Aplica-se a

String(Char*, Int32, Int32)

Origem:: String.cs

Origem:: String.cs

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 String classe 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 value.

length: Int32

O número de caracteres a serem value usados.

Atributos: CLSCompliantAttribute SecurityCriticalAttribute

Exceções

ArgumentOutOfRangeException

startIndex ou length é menor que zero, value + startIndex causa um estouro do 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

Note

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

Aplica-se a

String(Char[], Int32, Int32)

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Origem:: String.cs

Inicializa uma nova instância da String classe 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 value.

length: Int32

O número de caracteres a serem value usados.

Exceções

ArgumentNullException

value é null.

ArgumentOutOfRangeException

startIndex ou length é menor que zero.

- ou -

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

Comentários

Note

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

Aplica-se a

String(SByte*, Int32, Int32)

Origem:: String.cs

Origem:: String.cs

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 String classe 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 em Windows (conhecida como CP_ACP) e como codificação UTF-8 em não Windows.

startIndex: Int32

A posição inicial dentro value.

length: Int32

O número de sbytes a value serem usados.

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 do endereço transbordou.

- 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 String usando value, supondo que value esteja codificada no ANSI.

AccessViolationException

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

Comentários

Note

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

Aplica-se a

String(SByte*, Int32, Int32, Encoding)

Origem:: String.cs

Origem:: String.cs

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

length: Int32

O número de sbytes a value serem usados.

enc: Encoding

Um objeto que especifica como a matriz referenciada é 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 do endereço transbordou.

- 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 String usando value, supondo que value seja codificada conforme especificado por enc.

AccessViolationException

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

Comentários

Note

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

Aplica-se a

Comentários

Esta página foi útil?