Partilhar via


String Construtores

Definição

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

Exceções

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

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.

Aplica-se a

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

Nota

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

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

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

Exceções

value é null.

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

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

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.

Aplica-se a

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

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.

Aplica-se a

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

Exceções

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.

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.

Aplica-se a

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

value é null.

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.

Aplica-se a

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

Exceções

value é null.

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.

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.

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.

Aplica-se a

String(SByte*, Int32, Int32, Encoding)

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

Exceções

value é null.

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.

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.

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.

Aplica-se a