String Constructores

Definición

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
Source:
String.cs
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)]
[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 terminada en null de caracteres Unicode.

Atributos

Excepciones

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

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.

Se aplica a

String(Char[])

Source:
String.cs
Source:
String.cs
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);
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.

Se aplica a

String(ReadOnlySpan<Char>)

Source:
String.cs
Source:
String.cs
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.

Se aplica a

String(SByte*)

Source:
String.cs
Source:
String.cs
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)]
[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 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

Excepciones

value es null.

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

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.

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.

Se aplica a

String(Char, Int32)

Source:
String.cs
Source:
String.cs
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

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.

Se aplica a

String(Char*, Int32, Int32)

Source:
String.cs
Source:
String.cs
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)]
[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 dentro de value.

length
Int32

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

Atributos

Excepciones

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.

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.

Se aplica a

String(Char[], Int32, Int32)

Source:
String.cs
Source:
String.cs
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

value es null.

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.

Se aplica a

String(SByte*, Int32, Int32)

Source:
String.cs
Source:
String.cs
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)]
[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 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

Excepciones

value es null.

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.

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.

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.

Se aplica a

String(SByte*, Int32, Int32, Encoding)

Source:
String.cs
Source:
String.cs
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)]
[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 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

Excepciones

value es null.

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.

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.

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.

Se aplica a