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
| Nombre | Description |
|---|---|
| String(Char*) |
Inicializa una nueva instancia de la String clase en el valor indicado por un puntero especificado a una matriz de caracteres Unicode. |
| String(Char[]) |
Inicializa una nueva instancia de la String clase en los caracteres Unicode indicados en la matriz de caracteres especificada. |
| String(ReadOnlySpan<Char>) |
Inicializa una nueva instancia de la String clase en los caracteres Unicode indicados en el intervalo de solo lectura especificado. |
| String(SByte*) |
Inicializa una nueva instancia de la String clase 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 String clase en el valor indicado por un carácter Unicode especificado repetido un número de veces especificado. |
| String(Char*, Int32, Int32) |
Inicializa una nueva instancia de la String clase 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 String clase 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 String clase 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 String clase 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 Encoding objeto . |
Comentarios
Para obtener más información sobre esta API, consulte Comentarios complementarios de api para constructor de cadena.
String(Char*)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
Importante
Esta API no es conforme a CLS.
Inicializa una nueva instancia de la String clase 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 de caracteres Unicode terminada en null.
- Atributos
Excepciones
El proceso actual no tiene acceso de lectura a todos los caracteres direccionados.
value especifica una matriz que contiene un carácter Unicode no válido o value especifica una dirección inferior a 64000.
Comentarios
Note
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
- Source:
- String.cs
- Source:
- String.cs
Inicializa una nueva instancia de la String clase 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
Note
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
- Source:
- String.cs
- Source:
- String.cs
Inicializa una nueva instancia de la String clase 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
- Source:
- String.cs
- Source:
- String.cs
Importante
Esta API no es conforme a CLS.
Inicializa una nueva instancia de la String clase 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 value que está codificada 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
Note
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
- Source:
- String.cs
- Source:
- String.cs
Inicializa una nueva instancia de la String clase en el valor indicado por un carácter Unicode especificado repetido un número de veces especificado.
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 c que se produce.
Excepciones
count es menor que cero.
Comentarios
Note
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
- Source:
- String.cs
- Source:
- String.cs
Importante
Esta API no es conforme a CLS.
Inicializa una nueva instancia de la String clase 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 value de los que se va 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 inferior a 64000.
Comentarios
Note
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
- Source:
- String.cs
- Source:
- String.cs
Inicializa una nueva instancia de la String clase 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 value de los que se va 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
Note
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
- Source:
- String.cs
- Source:
- String.cs
Importante
Esta API no es conforme a CLS.
Inicializa una nueva instancia de la String clase 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 sbytes dentro value de los que se va 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, el cálculo de direcciones se desborda.
O bien
La longitud de la nueva cadena que se va a inicializar es demasiado grande para asignar.
La dirección especificada por value + startIndex es menor que 64K.
O bien
No se pudo inicializar una nueva instancia de String mediante value, suponiendo value que está codificada en ANSI.
value, startIndexy length especifican colectivamente una dirección no válida.
Comentarios
Note
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
- 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 sbytes dentro value de los que se va a usar.
- enc
- Encoding
Objeto que especifica cómo se codifica la matriz a value la que hace referencia. Si enc es null, se asume 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, el cálculo de direcciones se desborda.
O bien
La longitud de la nueva cadena que se va a inicializar es demasiado grande para asignar.
La dirección especificada por value + startIndex es menor que 64K.
O bien
No se pudo inicializar una nueva instancia de String mediante value, suponiendo value que se codifica como se especifica en enc.
value, startIndexy length especifican colectivamente una dirección no válida.
Comentarios
Note
Para obtener ejemplos e información de uso completa sobre esta y otras String sobrecargas de constructor, consulte el resumen del String constructor.
