String Construtores

Definição

Espaço de Nomes:: System

Assemblagens:: mscorlib.dll, System.Runtime.dll

Assemblagem:: mscorlib.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da String classe.

Sobrecargas

Name	Description
String(Char*)	Inicializa uma nova instância da String classe ao valor indicado por um ponteiro especificado para um array de caracteres Unicode.
String(Char[])	Inicializa uma nova instância da String classe para os caracteres Unicode indicados no array de caracteres especificado.
String(ReadOnlySpan<Char>)	Inicializa uma nova instância da String classe para os caracteres Unicode indicados no span de apenas leitura especificado.
String(SByte*)	Inicializa uma nova instância da String classe ao valor indicado por um ponteiro para um array de inteiros assinados de 8 bits.
String(Char, Int32)	Inicializa uma nova instância da String classe ao valor indicado por um carácter Unicode especificado repetido um número especificado de vezes.
String(Char*, Int32, Int32)	Inicializa uma nova instância da String classe ao valor indicado por um ponteiro especificado para um array de caracteres Unicode, uma posição inicial do carácter dentro desse array e um comprimento.
String(Char[], Int32, Int32)	Inicializa uma nova instância da String classe ao valor indicado por um array de caracteres Unicode, uma posição inicial do carácter dentro desse array e um comprimento.
String(SByte*, Int32, Int32)	Inicializa uma nova instância da String classe ao valor indicado por um ponteiro especificado para um array de inteiros assinados de 8 bits, uma posição inicial dentro desse array e um comprimento.
String(SByte*, Int32, Int32, Encoding)	Inicializa uma nova instância da String classe ao valor indicado por um ponteiro especificado para um array de inteiros assinados de 8 bits, uma posição inicial dentro desse array, um comprimento e um Encoding objeto.

Observações

Para mais informações sobre esta API, consulte Observações suplementares da API para o construtor de strings.

String(Char*)

Importante

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

Inicializa uma nova instância da String classe ao valor indicado por um ponteiro especificado para um array 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 tem permissão de leitura para todos os caracteres endereçados.

ArgumentException

value especifica um array que contém um carácter Unicode inválido, ou value especifica um endereço inferior a 64000.

Observações

Note

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

Aplica-se a

String(Char[])

Inicializa uma nova instância da String classe para os caracteres Unicode indicados no array de caracteres especificado.

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.

Observações

Note

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

Aplica-se a

String(ReadOnlySpan<Char>)

Inicializa uma nova instância da String classe para os caracteres Unicode indicados no span de apenas 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 de apenas leitura de caracteres Unicode.

Aplica-se a

String(SByte*)

Importante

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

Inicializa uma nova instância da String classe ao valor indicado por um ponteiro para um array de inteiros assinados 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 apontador para um array terminado nulo de inteiros com sinal de 8 bits. Os inteiros são interpretados usando a codificação atual da página de códigos do sistema em Windows (referida como CP_ACP) e como codificação UTF-8 em não-Windows.

Atributos: CLSCompliantAttribute SecurityCriticalAttribute

Exceções

ArgumentNullException

value é null.

ArgumentException

Uma nova instância de String não poderia ser inicializada usando value, assumindo value que está codificada em ANSI.

ArgumentOutOfRangeException

O comprimento da nova cadeia a inicializar, que é determinado pelo carácter de terminação nula de value, é demasiado grande para alocar.

AccessViolationException

value especifica um endereço inválido.

Observações

Note

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

Aplica-se a

String(Char, Int32)

Inicializa uma nova instância da String classe ao valor indicado por um carácter 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 acontece.

Exceções

ArgumentOutOfRangeException

count é inferior a zero.

Observações

Note

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

Aplica-se a

String(Char*, Int32, Int32)

Importante

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

Inicializa uma nova instância da String classe ao valor indicado por um ponteiro especificado para um array de caracteres Unicode, uma posição inicial do carácter dentro desse array 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 apontador para um array de caracteres Unicode.

startIndex: Int32

A posição inicial dentro valuede .

length: Int32

O número de caracteres para value usar.

Atributos: CLSCompliantAttribute SecurityCriticalAttribute

Exceções

ArgumentOutOfRangeException

startIndex ou length é menor que zero, value + startIndex causa um estouro de ponteiro ou o processo atual não tem acesso de leitura a todos os caracteres endereçados.

ArgumentException

value especifica um array que contém um carácter Unicode inválido, ou value + startIndex especifica um endereço inferior a 64000.

Observações

Note

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

Aplica-se a

String(Char[], Int32, Int32)

Inicializa uma nova instância da String classe ao valor indicado por um array de caracteres Unicode, uma posição inicial do carácter dentro desse array 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 valuede .

length: Int32

O número de caracteres para value usar.

Exceções

ArgumentNullException

value é null.

ArgumentOutOfRangeException

startIndex ou length é inferior a zero.

-ou-

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

Observações

Note

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

Aplica-se a

String(SByte*, Int32, Int32)

Importante

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

Inicializa uma nova instância da String classe ao valor indicado por um ponteiro especificado para um array de inteiros assinados de 8 bits, uma posição inicial dentro desse array 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 apontador para um array de inteiros com sinal de 8 bits. Os inteiros são interpretados usando a codificação atual da página de códigos do sistema em Windows (referida como CP_ACP) e como codificação UTF-8 em não-Windows.

startIndex: Int32

A posição inicial dentro valuede .

length: Int32

O número de sbytes a usar value .

Atributos: CLSCompliantAttribute SecurityCriticalAttribute

Exceções

ArgumentNullException

value é null.

ArgumentOutOfRangeException

startIndex ou length é inferior a zero.

-ou-

O endereço especificado por value + startIndex é demasiado grande para a plataforma atual; ou seja, o cálculo do endereço transbordou.

-ou-

O comprimento da nova cadeia a inicializar é demasiado grande para alocar.

ArgumentException

O endereço especificado por value + startIndex é inferior a 64K.

-ou-

Uma nova instância de String não poderia ser inicializada usando value, assumindo value que está codificada em ANSI.

AccessViolationException

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

Observações

Note

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

Aplica-se a

String(SByte*, Int32, Int32, Encoding)

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 apontador para um array de inteiros com sinal de 8 bits.

startIndex: Int32

A posição inicial dentro valuede .

length: Int32

O número de sbytes a usar value .

enc: Encoding

Um objeto que especifica como o array referenciado por value é codificado. Se enc for null, assume-se a codificação ANSI.

Atributos: CLSCompliantAttribute SecurityCriticalAttribute

Exceções

ArgumentNullException

value é null.

ArgumentOutOfRangeException

startIndex ou length é inferior a zero.

-ou-

O endereço especificado por value + startIndex é demasiado grande para a plataforma atual; ou seja, o cálculo do endereço transbordou.

-ou-

O comprimento da nova cadeia a inicializar é demasiado grande para alocar.

ArgumentException

O endereço especificado por value + startIndex é inferior a 64K.

-ou-

Uma nova instância de String não poderia ser inicializada usando value, assumindo value que está codificada conforme especificado por enc.

AccessViolationException

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

Observações

Note

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

Aplica-se a

Comentários

Esta página foi útil?