String Constructores

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Inicializa una nueva instancia de la clase String.

Sobrecargas

String(Char*)	Inicializa una nueva instancia de la clase String en el valor indicado por un puntero especificado a una matriz de caracteres Unicode.
String(Char[])	Inicializa una nueva instancia de la clase String en los caracteres Unicode indicados en la matriz de caracteres especificada.
String(ReadOnlySpan<Char>)	Inicializa una nueva instancia de la clase String en los caracteres Unicode indicados en el intervalo de solo lectura especificado.
String(SByte*)	Inicializa una nueva instancia de la clase String en el valor indicado por un puntero a una matriz de enteros con signo de 8 bits.
String(Char, Int32)	Inicializa una nueva instancia de la clase String en el valor indicado por un carácter Unicode especificado que repitió un número especificado de veces.
String(Char*, Int32, Int32)	Inicializa una nueva instancia de la clase String en el valor indicado por un puntero especificado a una matriz de caracteres Unicode, una posición de carácter inicial dentro de esa matriz y una longitud.
String(Char[], Int32, Int32)	Inicializa una nueva instancia de la clase String en el valor indicado por una matriz de caracteres Unicode, una posición de carácter inicial dentro de esa matriz y una longitud.
String(SByte*, Int32, Int32)	Inicializa una nueva instancia de la clase String en el valor indicado por un puntero especificado a una matriz de enteros con signo de 8 bits, una posición inicial dentro de esa matriz y una longitud.
String(SByte*, Int32, Int32, Encoding)	Inicializa una nueva instancia de la clase String en el valor indicado por un puntero especificado a una matriz de enteros con signo de 8 bits, una posición inicial dentro de esa matriz, una longitud y un objeto Encoding.

Comentarios

Para obtener más información sobre esta API, consulte comentarios de API complementarias para constructor string.

String(Char*)

Source:

String.cs

Importante

Esta API no es conforme a CLS.

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

Puntero a una matriz terminada en null de caracteres Unicode.

Atributos

CLSCompliantAttribute

Excepciones

ArgumentOutOfRangeException

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

ArgumentException

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

Comentarios

Nota

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

String(Char[])

Source:

String.cs

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

Matriz de caracteres Unicode.

Comentarios

Nota

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

String(ReadOnlySpan<Char>)

Source:

String.cs

Inicializa una nueva instancia de la clase String en los caracteres Unicode indicados 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>

Intervalo de solo lectura de caracteres Unicode.

String(SByte*)

Source:

String.cs

Importante

Esta API no es conforme a CLS.

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

public:
 String(System::SByte* value);

[System.CLSCompliant(false)]
public String (sbyte* value);

[<System.CLSCompliant(false)>]
new string : nativeptr<sbyte> -> string

Parámetros

value

SByte*

Puntero a una matriz terminada en null de enteros de 8 bits con signo. Los enteros se interpretan mediante la codificación actual de la página de códigos del sistema en Windows (denominada CP_ACP) y como codificación UTF-8 en no Windows.

Atributos

CLSCompliantAttribute

Excepciones

ArgumentNullException

value es null.

ArgumentException

No se pudo inicializar una nueva instancia de String mediante value, suponiendo que value esté codificado en ANSI.

ArgumentOutOfRangeException

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

AccessViolationException

value especifica una dirección no válida.

Comentarios

Nota

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

String(Char, Int32)

Source:

String.cs

Inicializa una nueva instancia de la clase String en el valor indicado por un carácter Unicode especificado que repitió un número especificado de veces.

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 c se produce.

Excepciones

ArgumentOutOfRangeException

count es menor que cero.

Comentarios

Nota

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

String(Char*, Int32, Int32)

Source:

String.cs

Importante

Esta API no es conforme a CLS.

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

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*

Puntero a una matriz de caracteres Unicode.

startIndex

Int32

Posición inicial dentro de value.

length

Int32

Número de caracteres dentro de value que se va a usar.

Atributos

CLSCompliantAttribute

Excepciones

ArgumentOutOfRangeException

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

ArgumentException

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

Comentarios

Nota

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

String(Char[], Int32, Int32)

Source:

String.cs

Inicializa una nueva instancia de la clase String en el valor indicado por una matriz de caracteres Unicode, una posición de carácter inicial dentro de esa 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 dentro de value.

length

Int32

Número de caracteres dentro de value que se va a usar.

Excepciones

ArgumentNullException

value es null.

ArgumentOutOfRangeException

startIndex o length es menor que cero.

-o-

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 sobrecargas de constructor de String, consulte el resumen del constructor de String.

String(SByte*, Int32, Int32)

Source:

String.cs

Importante

Esta API no es conforme a CLS.

Inicializa una nueva instancia de la clase String en el valor indicado por un puntero especificado a una matriz de enteros con signo de 8 bits, una posición inicial dentro de esa 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)>]
new string : nativeptr<sbyte> * int * int -> string

Parámetros

value

SByte*

Puntero a una matriz de enteros con signo de 8 bits. Los enteros se interpretan mediante la codificación actual de la página de códigos del sistema en Windows (denominada CP_ACP) y como codificación UTF-8 en no Windows.

startIndex

Int32

Posición inicial dentro de value.

length

Int32

Número de caracteres dentro de value que se va a usar.

Atributos

CLSCompliantAttribute

Excepciones

ArgumentNullException

value es null.

ArgumentOutOfRangeException

startIndex o length es menor que cero.

-o-

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

-o-

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

ArgumentException

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

-o-

No se pudo inicializar una nueva instancia de String mediante value, suponiendo que value esté codificado en ANSI.

AccessViolationException

value, startIndexy length especificar colectivamente una dirección no válida.

Comentarios

Nota

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

String(SByte*, Int32, Int32, Encoding)

Source:

String.cs

Importante

Esta API no es conforme a CLS.

Inicializa una nueva instancia de la clase String en el valor indicado por un puntero especificado a una matriz de enteros con signo de 8 bits, una posición inicial dentro de esa 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)>]
new string : nativeptr<sbyte> * int * int * System.Text.Encoding -> string

Parámetros

value

SByte*

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

startIndex

Int32

Posición inicial dentro de value.

length

Int32

Número de caracteres dentro de value que se va a usar.

enc

Encoding

Objeto que especifica cómo se codifica la matriz a la que hace referencia value. Si enc es null, se asume la codificación ANSI.

Atributos

CLSCompliantAttribute

Excepciones

ArgumentNullException

value es null.

ArgumentOutOfRangeException

startIndex o length es menor que cero.

-o-

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

-o-

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

ArgumentException

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

-o-

No se pudo inicializar una nueva instancia de String mediante value, suponiendo que value se codifica como se especifica en enc.

AccessViolationException

value, startIndexy length especificar colectivamente una dirección no válida.

Comentarios

Nota

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