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 de 8 bits com sinal.
String(Char, Int32)	Inicializa uma nova instância da classe String para o valor indicado por um caractere Unicode repetido um número de vezes especificado.
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 tamanho.
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 na 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 na matriz, um comprimento e um objeto Encoding.

Comentários

Para obter mais informações sobre essa API, consulte Comentários de API complementares 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 de caracteres Unicode terminada em nulo.

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 menor que 64000.

Comentários

Observação

Para exemplos e informações de uso abrangentes sobre este e outras sobrecargas do 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

Observação

Para exemplos e informações de uso abrangentes sobre este e outras sobrecargas do 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 de 8 bits com sinal.

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 de inteiros de 8 bits com sinal com terminação nula. Os inteiros são interpretados usando a codificação da página de código do sistema atual (ou seja, a codificação especificada por Default).

Atributos

CLSCompliantAttribute

Exceções

ArgumentNullException

value é null.

ArgumentException

Não foi possível inicializar uma nova instância de String usando value, supondo-se que value está codificado em ANSI.

ArgumentOutOfRangeException

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

AccessViolationException

value especifica um endereço inválido.

Comentários

Observação

Para exemplos e informações de uso abrangentes sobre este e outras sobrecargas do 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 repetido um número de vezes especificado.

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 que c ocorre.

Exceções

ArgumentOutOfRangeException

count é menor que zero.

Comentários

Observação

Para exemplos e informações de uso abrangentes sobre este e outras sobrecargas do 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 tamanho.

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 de value a ser usado.

Atributos

CLSCompliantAttribute

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 menor que 64000.

Comentários

Observação

Para exemplos e informações de uso abrangentes sobre este e outras sobrecargas do 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 de value a ser usado.

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

Observação

Para exemplos e informações de uso abrangentes sobre este e outras sobrecargas do 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 na 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 (ou seja, a codificação especificada por Default).

startIndex

Int32

A posição inicial dentro de value.

length

Int32

O número de caracteres dentro de 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 é grande demais para a plataforma atual; ou seja, o cálculo do endereço estourou.

- 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-se que value está codificado em ANSI.

AccessViolationException

value, startIndex e length coletivamente especificam um endereço inválido.

Comentários

Observação

Para exemplos e informações de uso abrangentes sobre este e outras sobrecargas do 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 na 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 de 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 é grande demais para a plataforma atual; ou seja, o cálculo do endereço estourou.

- 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-se que value está codificado conforme especificado por enc.

AccessViolationException

value, startIndex e length coletivamente especificam um endereço inválido.

Comentários

Observação

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