String Construtores

Definição

Namespace:

System

Assembly:

System.Runtime.dll

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

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)]
public String (char* value);

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

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

Nota

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

String(Char[])

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);

new string : char[] -> string

Public Sub New (value As Char())

Parâmetros

value

Char[]

Uma matriz de caracteres Unicode.

Comentários

Nota

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

String(ReadOnlySpan<Char>)

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.

String(SByte*)

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)>]
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

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

Nota

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

String(Char, Int32)

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

Nota

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

String(Char*, Int32, Int32)

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)]
public String (char* value, int startIndex, int length);

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

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

Nota

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

String(Char[], Int32, Int32)

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

Nota

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

String(SByte*, Int32, Int32)

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)>]
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

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

Nota

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

String(SByte*, Int32, Int32, Encoding)

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, um comprimento e um objeto Encoding.

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)>]
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

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

Nota

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