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 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> -> stringPará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[] -> stringPublic 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> -> stringPublic 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> -> stringPará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 -> stringPublic 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 -> stringPará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 -> stringPublic 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 -> stringPará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.
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 -> stringPará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.
