String Construtores
Definição
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 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
- 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 de caracteres Unicode terminada em nulo.
- 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 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.
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
Observação
Para exemplos e informações de uso abrangentes sobre este e outras sobrecargas do 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 de 8 bits com sinal.
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 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
Exceções
value
é null
.
Não foi possível inicializar uma nova instância de String usando value
, supondo-se que value
está codificado em ANSI.
O comprimento da nova cadeia de caracteres a ser inicializada, que é determinado pelo caractere de terminação nula value
, é muito grande para ser alocado.
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.
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 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
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.
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 tamanho.
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 de value
a ser usado.
- Atributos
Exceções
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.
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.
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 de value
a ser usado.
Exceções
value
é null
.
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.
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 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)]
[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 (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
Exceções
value
é null
.
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.
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.
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.
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.
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 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
Exceções
value
é null
.
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.
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
.
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.
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários