String Constructores
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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*)
- 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 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[])
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
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>)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
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*)
- 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 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)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
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)
- 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 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)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
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)
- 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 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)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
Importante
Esta API no es conforme a 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*
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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de