String Constructores

Definición

Inicializa una nueva instancia de la clase String.

Sobrecargas

String(Char*)

Inicializa una nueva instancia de la clase String con el valor indicado por un puntero especificado que apunta a una matriz de caracteres Unicode.

String(Char[])

Inicializa una nueva instancia de la clase String en el valor de caracteres Unicode indicado en la matriz de caracteres especificada.

String(ReadOnlySpan<Char>)

Inicializa una nueva instancia de la clase String en el valor de caracteres Unicode indicado en el intervalo de solo lectura especificado.

String(SByte*)

Inicializa una nueva instancia de la clase String con el valor indicado por un puntero a una matriz de enteros de 8 bits con signo.

String(Char, Int32)

Inicializa una nueva instancia de la clase String con el valor indicado por un carácter Unicode especificado que se repite un número de veces determinado.

String(Char*, Int32, Int32)

Inicializa una nueva instancia de la clase String con el valor indicado por un puntero especificado que apunta a una matriz de caracteres Unicode, una posición de carácter inicial dentro de dicha matriz y una longitud.

String(Char[], Int32, Int32)

Inicializa una nueva instancia de la clase String con el valor indicado por una matriz de caracteres Unicode, una posición de carácter inicial dentro de dicha matriz y una longitud.

String(SByte*, Int32, Int32)

Inicializa una nueva instancia de la clase String con el valor indicado por un puntero a una matriz de enteros de 8 bits con signo especificado, una posición inicial dentro de dicha matriz y una longitud.

String(SByte*, Int32, Int32, Encoding)

Inicializa una nueva instancia de la clase String con el valor indicado por un puntero a una matriz de enteros de 8 bits con signo especificado, una posición inicial dentro de dicha matriz, una longitud y un objeto Encoding.

Comentarios

Para obtener más información sobre esta API, consulte Comentarios complementarios de la API para el constructor string.

String(Char*)

Importante

Esta API no es conforme a CLS.

Inicializa una nueva instancia de la clase String con el valor indicado por un puntero especificado que apunta a una 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*

Puntero a una matriz de caracteres Unicode terminada en null.

Atributos

Excepciones

El proceso actual no tiene acceso de lectura a todos los caracteres tratados.

value especifica una matriz que contiene un carácter Unicode no válido o value especifica una dirección menor que 64000.

Comentarios

Nota

Para obtener ejemplos e información de uso completa sobre esta y otras String sobrecargas de constructor, consulte el resumen del String constructor.

Se aplica a

String(Char[])

Inicializa una nueva instancia de la clase String en el valor de caracteres Unicode indicado en la 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[]

Matriz de caracteres Unicode.

Comentarios

Nota

Para obtener ejemplos e información de uso completa sobre esta y otras String sobrecargas de constructor, consulte el resumen del String constructor.

Se aplica a

String(ReadOnlySpan<Char>)

Inicializa una nueva instancia de la clase String en el valor de caracteres Unicode indicado en el intervalo de solo lectura 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>

Un intervalo de caracteres Unicode de solo lectura.

Se aplica a

String(SByte*)

Importante

Esta API no es conforme a CLS.

Inicializa una nueva instancia de la clase String con el valor indicado por un puntero a una matriz de enteros de 8 bits con signo.

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*

Puntero a una matriz terminada en null de enteros de 8 bits con signo. Los números enteros se interpretan utilizando la codificación actual para páginas de códigos de sistema (es decir, la codificación especificada por Default).

Atributos

Excepciones

value es null.

No se ha podido inicializar una nueva instancia de String mediante value, suponiendo que value se ha codificado en ANSI.

La longitud de la nueva cadena a inicializar, que viene determinada por el carácter de terminación null de value, es demasiado grande para asignar.

value especifica una dirección no válida.

Comentarios

Nota

Para obtener ejemplos e información de uso completa sobre esta y otras String sobrecargas de constructor, consulte el resumen del String constructor.

Se aplica a

String(Char, Int32)

Inicializa una nueva instancia de la clase String con el valor indicado por un carácter Unicode especificado que se repite un número de veces determinado.

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

Carácter Unicode.

count
Int32

Número de veces que se presenta el parámetro c.

Excepciones

count es menor que cero.

Comentarios

Nota

Para obtener ejemplos e información de uso completa sobre esta y otras String sobrecargas de constructor, consulte el resumen del String constructor.

Se aplica a

String(Char*, Int32, Int32)

Importante

Esta API no es conforme a CLS.

Inicializa una nueva instancia de la clase String con el valor indicado por un puntero especificado que apunta a una matriz de caracteres Unicode, una posición de carácter inicial dentro de dicha matriz y una longitud.

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*

Puntero a una matriz de caracteres Unicode.

startIndex
Int32

Posición inicial de value.

length
Int32

Número de caracteres de value que se van a usar.

Atributos

Excepciones

startIndex o length es menor que cero, value + startIndex produce un desbordamiento de puntero o el proceso actual no tiene acceso de lectura a todos los caracteres tratados.

value especifica una matriz que contiene un carácter Unicode no válido, o value + startIndex especifica una dirección menor que 64000.

Comentarios

Nota

Para obtener ejemplos e información de uso completa sobre esta y otras String sobrecargas de constructor, consulte el resumen del String constructor.

Se aplica a

String(Char[], Int32, Int32)

Inicializa una nueva instancia de la clase String con el valor indicado por una matriz de caracteres Unicode, una posición de carácter inicial dentro de dicha matriz y una longitud.

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

Matriz de caracteres Unicode.

startIndex
Int32

Posición inicial de value.

length
Int32

Número de caracteres de value que se van a usar.

Excepciones

value es null.

startIndex o length es menor que cero.

O bien

La suma de startIndex y length es mayor que el número de elementos de value.

Comentarios

Nota

Para obtener ejemplos e información de uso completa sobre esta y otras String sobrecargas de constructor, consulte el resumen del String constructor.

Se aplica a

String(SByte*, Int32, Int32)

Importante

Esta API no es conforme a CLS.

Inicializa una nueva instancia de la clase String con el valor indicado por un puntero a una matriz de enteros de 8 bits con signo especificado, una posición inicial dentro de dicha matriz y una longitud.

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*

Puntero a una matriz de enteros de 8 bits con signo. Los números enteros se interpretan utilizando la codificación actual para páginas de códigos de sistema (es decir, la codificación especificada por Default).

startIndex
Int32

Posición inicial de value.

length
Int32

Número de caracteres de value que se van a usar.

Atributos

Excepciones

value es null.

startIndex o length es menor que cero.

O bien

La dirección especificada por value + startIndex es demasiado grande para la plataforma actual, es decir, se ha desbordado el cálculo de la dirección.

O bien

La longitud de la nueva cadena que se va a inicializar es demasiado grande para asignarla.

La dirección especificada por value + startIndex es inferior a 64 000.

O bien

No se ha podido inicializar una nueva instancia de String mediante value, suponiendo que value se ha codificado en ANSI.

value, startIndex y length colectivamente especifican una dirección no válida.

Comentarios

Nota

Para obtener ejemplos e información de uso completa sobre esta y otras String sobrecargas de constructor, consulte el resumen del String constructor.

Se aplica a

String(SByte*, Int32, Int32, Encoding)

Importante

Esta API no es conforme a CLS.

Inicializa una nueva instancia de la clase String con el valor indicado por un puntero a una matriz de enteros de 8 bits con signo especificado, una posición inicial dentro de dicha matriz, una longitud y un 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*

Puntero a una matriz de enteros de 8 bits con signo.

startIndex
Int32

Posición inicial de value.

length
Int32

Número de caracteres de value que se van a usar.

enc
Encoding

Un objeto que especifica la forma en que se codifica la matriz a la que value hace referencia. Si el valor de enc es null, se supone que se trata de la codificación ANSI.

Atributos

Excepciones

value es null.

startIndex o length es menor que cero.

O bien

La dirección especificada por value + startIndex es demasiado grande para la plataforma actual, es decir, se ha desbordado el cálculo de la dirección.

O bien

La longitud de la nueva cadena que se va a inicializar es demasiado grande para asignarla.

La dirección especificada por value + startIndex es inferior a 64 000.

O bien

No se ha podido inicializar una nueva instancia de String mediante value, suponiendo que value se ha codificado según lo especificado por enc.

value, startIndex y length colectivamente especifican una dirección no válida.

Comentarios

Nota

Para obtener ejemplos e información de uso completa sobre esta y otras String sobrecargas de constructor, consulte el resumen del String constructor.

Se aplica a